Cloud Run 上などの REST API を、既存のゲートウェイ設定のままエージェントから呼ぶ。OpenAPI 3.x に x-google-api-management.mcp を付けてデプロイすると、ゲートウェイが /mcp で JSON-RPC を受け、tools/call を対応する REST へ変換。
フルの API / MCP 基盤(ライフサイクル、高度なトラフィック、マネタイズ)は Apigee。エージェントが出ていく先の統制は Agent Gateway。
- 対象は OpenAPI 3.0.x / 3.1.x。OpenAPI 2.0 は非対応。操作単位の上書き・除外は
x-google-mcp-tool。公開できる HTTP は GET / POST / PUT / PATCH / DELETE で、空の説明は拒否 - 受け付ける MCP メソッドは
initialize、notifications/initialized、tools/list、tools/call。resources/*やprompts/*などは JSON-RPC-32601 tools/listは既定で未認証。JWT または API キー(x-api-keyヘッダ)で保護できる。tools/callは元の REST 操作と同じ認証。initializeとnotifications/initializedは未認証- 変換後のバックエンド呼び出しは通常の REST と同じ。認証・クォータ・ログは 1 経路。API hub 連携時は MCP メタデータ付きで公開され、Agent Registry にも載る
- Public Preview の上限はゲートウェイあたり 1000 ツール。HTTP 204 など空本文は非対応。入れ子の深いスキーマは
tools/listで欠けうる - 同一 API 設定で Model Routing と併用不可。ストリーミング、stdio、バイナリ応答、JSON-RPC バッチは非対応