MCP ツール

Model Context Protocol(MCP)は、AI アプリケーションを外部システムに接続するためのオープンソース標準です。特定のエンティティのセットと定義された構造を確立し、さまざまなデータソースとツールを AI モデルに接続するための標準的な方法として機能します。

MCP ツールを使用して、エージェント アプリケーションを既存の MCP サーバーに接続できます。

制限事項

次の制限が適用されます。

  • CX Agent Studio は StreamableHttpTransport ベースのサーバーのみをサポートしています。SSE トランスポート サーバーはサポートされていません。

MCP サーバーを構築または選択する

独自の MCP サーバーを構築するには、公式の MCP SDK または FastMCP などの信頼できるサードパーティ製 SDK を使用することをおすすめします。MCP サーバーを作成したら、ホスティング サービスにデプロイします。Cloud Run または Compute Engine を使用して MCP サーバーをホストできます。このガイドに沿って、プロセス全体を理解することをおすすめします。わずか 10 分でリモート MCP サーバーを構築して Google Cloud Run にデプロイする

MCP サーバーをゼロから構築する代わりに、Google Cloud MCP サーバーなどの事前構築済みの MCP サーバーを使用することもできます。

認証

MCP ツールには、OpenAPI ツールと同じ認証オプションがあります。

MCP サーバーを個別にテストする

エージェントを MCP サーバーに接続する前に、MCP サーバーを個別にテストすることをおすすめします。StreamableHttpTransport を使用して構築されたサーバーは、接尾辞(/mcp または /mcp/)で終わります。たとえば、サーバーが https://example.com でホストされている場合、サーバーにリクエストを送信するための正しい URL は https://example.com/mcp になります。

サーバーをローカルでテストするには、curl または Postman(MCP 接続をネイティブでサポート)の使用を検討してください。これにより、サーバーが稼働していることと、サーバーとの通信に必要な認証情報が認識されていることが確認されます。

MCP ツールを作成する

コンソールから MCP ツールを作成するには:

  1. エージェント ビルダーの右側にあるツールアイコンをクリックします。
  2. [MCP ツール] を選択します。
  3. ツール名を指定します。
  4. ツールの説明を入力します。
  5. MCP サーバーのサーバー アドレスを指定します。
  6. 認証タイプを選択します。
  7. [作成] をクリックします。

Cloud Run でホストされているサーバーの場合、推奨される認証オプションはサービス エージェントの ID トークンです。このメソッドは、CX Agent Studio サービス アカウント(service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com 形式)を使用して、Cloud Run ジョブにリクエストを送信します。CX Agent Studio サービス アカウントに Cloud Run 起動元のロールを付与して、独自の ID を使用してサーバーにリクエストを送信できるようにします。

エージェントにツールを追加する前に、少なくとも 1 つのツールをテストして、認証情報が正しく設定されていることを確認することをおすすめします。