マネーフォワードクラウドのMCPサーバーの基本

このドキュメントでは、Model Context Protocol（MCP）の基本的な考え方や、マネーフォワードクラウドのMCPサーバー（以下、本MCPサーバー）の設計の要点を説明します。

Model Context Protocolとは

Model Context Protocol（MCP）は、AIアプリケーションが外部のデータソースやツールに安全かつ標準化された方法でアクセスするためのオープンプロトコルです。

各AIアプリケーションの開発者がそれぞれ連携を実装する代わりに、MCPサーバーはAIアプリケーションが必要とする機能をツールとして公開・提供し、AIアプリケーションは決まった手順（プロトコル）に沿って、MCPサーバーが提供するツールを呼び出します。

本MCPサーバーはリモートMCPサーバーとして提供されています。クライアント側でMCPサーバーのプロセスを起動する必要はなく、HTTPSで公開されたエンドポイントに接続します。

通信には Streamable HTTP トランスポートを使用します。接続先URLや設定例はマネーフォワードクラウドのMCPサーバーの接続方法を参照してください。

[MCPクライアント]  ←→  [本MCPサーバー（リモートMCPサーバー）]  ←→  [マネーフォワード クラウド API]
 AIアプリケーション      ツール定義・認証・仲介                     各サービスのデータ操作

MCPサーバーを理解するうえで、次の用語を押さえておいてください。

用語	説明
AIアプリケーション	Claude、Codex、Cursorなどのこと。AI（LLM）を人間や業務が活用するためのインターフェイスとなる。
MCPクライアント	Model Context Protocol（MCP）に対応したAIアプリケーション。ユーザーとの対話に基づきツールを呼び出す。
MCPサーバー	ツールを公開・提供するサーバー。本MCPサーバーはマネーフォワード側がホストする。
ツール	MCPサーバーが公開・提供する操作の単位。たとえば「事業者情報の参照」のように特定のリソースに対する特定の操作がツールとして提供される。
Instructions	MCPサーバーがクライアントに渡す利用上の指示。破壊的操作の確認など、運用上のガイダンスを含むことがある。
スコープ	OAuth 2.0認可フローにおける権限の単位。ツールが呼び出せるAPI操作は、付与されたスコープに依存する。

MCPクライアントとMCPサーバーの間のやりとりは、おおむね次の流れで進みます。詳細な仕様はMCP仕様を参照してください。

ヒント

MCPクライアントは tools/list などの手段で利用可能なツール一覧を取得します。ツール定義はサーバー側で更新される場合があり、クライアントはセッションの確立後に随時最新のツール定義を参照します。

一部のサービスでは、当該のサービスに固有の用語（たとえば会計領域の場合における「勘定科目」「貸借対照表」など）の対訳表を辞書ツールとして提供しています。LLMが、日本語と英語など、対応する言語間で指示を受け付けたり、回答を返却したりするとき、用語を正しく対応させるために利用されます。

辞書ツールの具体的な名前や入出力は、サービスおよび提供バージョンによって異なります。

本MCPサーバーでは、各サービスの機能公開の状態に応じて、一部のツールや操作が制限される場合があります。制限された状態では、対応するツールが一覧（tools/list）に現れない、または一覧には現れても呼び出しが拒否されることがあります。

利用制限の有無やキー名は各サービスに固有の事項です。詳細は各サービスのサポートサイトを参照してください。

マネーフォワードクラウドのMCPサーバーの基本を理解したら、次のドキュメントに進んでください。

目的	次のステップ
MCPサーバーへの接続設定を行いたい	マネーフォワードクラウドのMCPサーバーの接続方法
認可フローやスコープ設計を理解したい	マネーフォワードクラウドのMCPサーバーの認証・認可
本番運用の推奨事項を確認したい	マネーフォワードクラウドのMCPサーバーのベストプラクティス
APIの仕様や利用方法を併せて確認したい	APIを利用するには