Model Context Protocol の概要

このドキュメントでは、API Gateway での Model Context Protocol（MCP）のサポートの概要について説明します。

API Gateway はリモート MCP サーバーとして機能し、バックエンド サービスを書き換えることなく、既存の REST API を AI エージェントと LLM に公開できます。

背景

Model Context Protocol（MCP）は、既存のインフラストラクチャに対して AI エージェントを直接構築できるオープン スタンダードです。MCP は、ツールや API ごとにカスタム統合コードを記述する代わりに、AI モデルが環境内の機能を検出して呼び出すための標準的な方法を提供します。

MCP サーバーとして構成されている場合、API Gateway はプロキシとして機能します。エージェント システムから送信された標準の MCP JSON-RPC プロトコル メッセージを、既存のバックエンドに対する標準の HTTP REST リクエストに変換します。

サポートされている機能

パブリック プレビュー期間中、API Gateway は次の MCP 機能をサポートしています。

  • リモート MCP サーバー: API Gateway はリモート サーバーとして機能し、HTTP（POST）を介して MCP リクエストを受信します。
  • OpenAPI 3.x 統合: MCP 構成は、カスタム拡張機能を使用して OpenAPI 3.x 仕様から直接導出されます。
  • サポートされている MCP ライフサイクル メソッド:
    • initialize: プロトコル バージョンと機能を確立します。
    • notifications/initialized: ハンドシェイクを承認します。
    • tools/list: クライアントが利用可能なツールとそのスキーマを検出できるようにします。
    • tools/call: クライアントが引数を使用してツールを呼び出すことを許可します。

制限事項

API Gateway での MCP のサポートには、次の制限が適用されます。

  • リソース（resources/*）とプロンプト（prompts/*）は対象外です。
  • Stdio トランスポートはサポートされていません。
  • OpenAPI 2.0 はサポートされていません。
  • ストリーミングまたは長時間実行されるツール呼び出しは対象外です。
  • モデル ルーティングの相互排他: 同じ API 構成内で MCP とモデル ルーティングの両方を有効にすることはできません。x-google-api-management.mcp が有効になっている場合、x-google-model-router は使用できません。

技術的な制限事項の一覧については、OpenAPI 3.x の機能制限をご覧ください。

ユースケース

  • 既存の REST API を MCP ツールとして公開する: バックエンド コードを変更することなく、既存の API を AI 対応ツールに変換します。
  • オペレーションごとにツールを選択: エージェントに公開する API パスとメソッドを明示的に選択します。
  • ツール サーフェスを保護する: 既存の API Gateway セキュリティ ポリシー（API キーや OAuth など）を MCP エンドポイントに適用します。

リクエスト フロー

MCP リクエストの正規パスは <basepath>/mcp です。ここで、<basepath> はゲートウェイの URL または x-google-endpoint 構成から派生します。

次の図は、MCP tools/call リクエストのリクエスト フローを示しています。

  1. MCP クライアント（AI エージェントなど）は、ゲートウェイの MCP エンドポイント（バージョン プレフィックスが使用されている場合は POST /mcp または POST /v1/mcp など）に JSON-RPC リクエストを送信します。
  2. ゲートウェイはリクエストを検証し、認証をチェックします。
  3. ゲートウェイはペイロードを検査して、呼び出されるツールを特定します。
  4. ゲートウェイは、API 構成で定義されたマッピングに基づいて、MCP ペイロードを標準の HTTP リクエスト（パス、パラメータ、本文）に変換します。
  5. ゲートウェイはリクエストをバックエンド サービスに転送します。
  6. バックエンドは標準の HTTP レスポンスを返します。
  7. ゲートウェイは HTTP レスポンスを MCP JSON-RPC レスポンスに変換してクライアントに返します。

API Hub と Agent Registry による検出

ゲートウェイを API Hub と統合すると、MCP 対応のゲートウェイが追加の MCP 固有のメタデータを含む MCP サーバーとして API Hub に公開され、Agent Registry にも自動的に表示されます。

MCP が有効になっていないゲートウェイの場合、標準の API メタデータが公開されます。MCP が有効になっているゲートウェイのみが、API Hub にこれらの追加の MCP 構成を表示します。

別途登録の手順を行う必要はありません。エージェントは、どちらかのカタログからサーバーとそのツールを検出できます。

Agent Registry をクエリするには、プロジェクトで API を有効にします。

gcloud services enable agentregistry.googleapis.com

次のステップ