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 バッチは非対応

#参考文献