マネーフォワード クラウドのMCPサーバーのトラブルシューティング

このドキュメントでは、マネーフォワード クラウドのMCPサーバー（以下、本MCPサーバー）の接続や認証・認可に関する既知の事象と、その解消方法を説明します。

事前に以下の内容を確認したうえで、該当する事象を参照してください。

• マネーフォワード クラウドのMCPサーバーの接続方法
• マネーフォワード クラウドのMCPサーバーの認証・認可

1. 接続先URLが誤っているため権限不足エラーが表示される

症状

• MCPクライアントでクラウド会計のMCPサーバーに接続しようとした
• 接続先URLとして https://api.biz.moneyforward.com/mcp/sse を設定して認証を試みた
• 事業者選択画面で「人事マスタの権限がありません」と表示され、先に進めない
• クラウド会計のみ利用しており、クラウド人事管理などのサービスは未契約

原因

https://api.biz.moneyforward.com/mcp/sse は、本MCPサーバーとして提供していないエンドポイントです。AIアプリケーションの回答などから誤ったURLが設定されるケースが報告されています。

解消方法

接続先URLに、マネーフォワード クラウドのMCPサーバーの接続方法またはMCPサーバーを提供する各サービスのガイドに記載されたURLを使用してください。

2. 認証時に「人事マスタ」の権限不足エラーが表示される

症状

• クラウド会計のMCPサーバーに接続しようとして認証を試みた
• 「このアプリとの連携を許可する以下の権限がありません。人事マスタ」というエラーが表示される
• クラウド会計のみ利用しており、クラウド人事管理などのサービスは未契約

原因

MCPクライアント側が本来必要ないスコープを要求していることが原因です。

例として、マネーフォワード クラウド会計のMCPサーバーが要求するスコープは mfc/accounting/ で始まるもののみですが、一部のMCPクライアント（Codexなど）は mfc/employee/organization.read など、クラウド会計とは無関係のサービスのスコープまで要求することがあります。

解消方法

MCPクライアントの開発元にお問い合わせください。

設定ファイルを変更できるMCPクライアント（Codexなど）の場合、以下のように必要なスコープ（クラウド会計の場合 mfc/accounting/...）のみを明示的に指定することで解消する場合があります。

# Codexの設定例
[mcp_servers.mfc_ca]
url = "https://beta.mcp.developers.biz.moneyforward.com/mcp/ca/v3"
oauth_resource = "https://beta.mcp.developers.biz.moneyforward.com/mcp/ca/v3"
scopes = [
  "mfc/accounting/offices.read",
  "mfc/accounting/accounts.read",
  "mfc/accounting/departments.read",
  "mfc/accounting/journal.read",
  "mfc/accounting/journal.write",
  "mfc/accounting/report.read",
  "mfc/accounting/taxes.read",
  "mfc/accounting/trade_partners.read",
  "mfc/accounting/trade_partners.write",
  "mfc/accounting/connected_account.read",
  "mfc/accounting/transaction.read",
  "mfc/accounting/transaction.write"
]

注記

本MCPサーバー側は仕様に準拠した実装ですが、MCPおよびOAuth 2.0の仕様解釈がクライアントごとに異なるケースがあります。本MCPサーバー側で解消できない問題は、クライアント側の修正または設定変更が必要になる場合があります。

3. Claude DesktopでMCPサーバーに接続できない

症状

• Claude Desktopで本MCPサーバーに接続していたが、ある時点から接続できなくなった
• OAuth 2.0の認可は完了するが、Claude DesktopからMCPサーバーのツールを利用できない
• Claude（Webブラウザ版）やCursorでは正常にMCPサーバーに接続できる

原因

本MCPサーバー側のログに異常が見られない場合、Claude Desktop側（claude.aiのサーバー側）でエラーが発生している可能性が高いです。

回避策

次の手順を試してください。

1. Webブラウザ版のClaudeで認証を試みる
2. OAuth 2.0の認可の完了後、Claude Desktopを再起動する
3. MCPサーバーのツールを利用できることを確認する

問題が解消しない場合は、Claude Desktopのバージョン更新や、Claudeの提供元（Anthropic）のサポートへの問い合わせも検討してください。

接続設定の確認チェックリスト

上記に該当しない場合、次の項目を確認してください。

確認項目	参照先
接続先サービスの契約がある	マネーフォワード クラウドのMCPサーバーを利用するには
接続先URLがドキュメントやガイドから得られた公式のものである	マネーフォワード クラウドのMCPサーバーの接続方法
クライアント固有の制約を確認した	マネーフォワード クラウドのMCPサーバーの接続方法
アプリポータルの利用開始とユーザーへの権限付与が完了している	マネーフォワード クラウドのMCPサーバーの認証・認可
接続先のサービスに必要なスコープが過不足なく指定されている	マネーフォワード クラウドのMCPサーバーの認証・認可