Model Context Protocol（MCP） は、AI アプリケーションを外部システムに接続するためのオープンソース標準です。 特定のエンティティと定義された構造を確立し、さまざまなデータソースやツールを AI モデルに接続するための標準的な方法として機能します。
MCP ツールを使用すると、エージェント アプリケーションを既存の MCP サーバーに接続できます。
制限事項
次の制限が適用されます。
- CX Agent Studio は StreamableHttpTransport ベースのサーバーのみをサポートしています。SSE トランスポート サーバーはサポートされていません。
MCP サーバーを構築または選択する
独自の MCP サーバーを構築するには、 公式の MCP SDK または FastMCPなどの信頼できるサードパーティ SDK を使用することをおすすめします。 MCP サーバーを作成したら、ホスティング サービスにデプロイします。 MCP サーバーのホストには、 Cloud Run または Compute Engine を使用できます。 このガイドに沿って、プロセス全体を理解することをおすすめします。 10 分以内にリモート MCP サーバーを構築して Google Cloud にデプロイする。
MCP サーバーをゼロから構築する代わりに、 MCP サーバーなどの既製の MCP サーバーを使用することもできます。 Google Cloud MCP サーバー
認証
MCP ツールには、OpenAPI ツールと同じ 認証オプションがあります。
カスタム ヘッダー
MCP サーバーへのリクエストで送信されるカスタム HTTP ヘッダーを指定できます。 セッション コンテキストからこれらのヘッダーに変数を挿入することもできます。 詳細については、 セッション コンテキスト変数をご覧ください。
MCP サーバーを個別にテストする
エージェントを MCP サーバーに接続する前に、MCP サーバーを個別にテストすることをおすすめします。
StreamableHttpTransport を使用して構築されたサーバーは、サフィックス（/mcp または /mcp/）で終わります。たとえば、サーバーが https://example.com でホストされている場合、サーバーにリクエストを送信する正しい URL は https://example.com/mcp になります。
サーバーをローカルでテストするには、 curl または Postman （MCP 接続をネイティブにサポート）の使用を検討してください。 これにより、サーバーが起動して実行されていることと、サーバーとの通信に必要な認証情報が理解されていることを確認できます。
カスタム ヘッダー
MCP サーバーに HTTP リクエストを送信するときに含めるカスタム ヘッダー（ツールリスト リクエストとツール実行）を定義できます。 これらのヘッダーの値は 変数で指定する必要があります。 そのため、カスタム ヘッダーを定義するには、 まずヘッダー値を含む変数を定義する必要があります。 変数値がなく、実行時にデフォルト値がない場合、ヘッダーはリクエストに含まれません。
MCP ツールを作成する
コンソールから MCP ツールを作成するには:
- エージェント ビルダーの右側にあるツールアイコンをクリックします。
- [MCP ツール] を選択します。
- ツール名を指定します。
- ツールの説明を入力します。
- MCP サーバーのサーバー アドレスを指定します。
- 認証タイプを選択します。
- 必要に応じて、ヘッダー名とヘッダー値として使用する変数を指定して、カスタム ヘッダーを定義します。
- [作成] をクリックします。
Cloud Run でホストされているサーバーの場合、推奨される認証オプションは [サービス エージェント ID トークン] です。
このメソッドでは、CX Agent Studio サービス アカウント（service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com の形式）を使用して、Cloud Run ジョブにリクエストを送信します。
Cloud Run 呼び出し元ロールを CX Agent Studio サービス アカウントに付与して、独自の ID を使用してサーバーにリクエストを送信できるようにします。
エージェントにツールを追加する前に、少なくとも 1 つのツールをテストして、認証情報が正しく設定されていることを確認することをおすすめします。