← 返回全部情报
Google Cloud API Gateway:给现有 OpenAPI 加注解,REST 操作直接变成 remote MCP 工具 的封面

·Blog·工程博客收录 2026-10-19

Google Cloud API Gateway:给现有 OpenAPI 加注解,REST 操作直接变成 remote MCP 工具

API GatewayMCPOpenAPIADKPublic Preview

一句话结论

Google Cloud API Gateway 进入 Public Preview:在已有 OpenAPI 3.x 上加 x-google-api-management.mcp,部署后即可在 /mcp 提供 remote MCP;tools/call 转成 REST,与现有 JWT、API key、配额与日志共用一条策略路径,不必另搭 MCP 服务器。

打开原文 Google Developers Blog:Turn your REST APIs into MCP tools with Google Cloud API Gateway

背景与理念

企业大量能力仍停在 agent 看不见的 REST API 后面。过去要让 agent 能调其中一个接口,团队往往要单独搭一套 MCP 服务器,把网关上已经做好的路由、鉴权与配额再实现一遍。

作者把 API Gateway 定位成 Google Cloud 网关产品线里的轻量入口:Cloud Run 上的服务若要尽快管起来并暴露给 agent,走这条快路径;需要完整生命周期、高级流量策略与货币化时用 Apigee;要管 agent 出站调用(包括这类 MCP 服务器)用 Agent Gateway;模型路由则是另一方向的出站 LLM 流量配套能力。

具体做法

  1. 在 OpenAPI 上标注并部署。MCP 要求 OpenAPI 3.0.x 或 3.1.x,不支持 2.0;在文档级打开 x-google-api-management.mcp,再用 x-google-mcp-tool 定制或跳过个别操作。每个要暴露的操作需要有后端,且 description 非空——工具说明是模型决定何时调用的主信号,应写清何时用、为何用,而不只是返回什么。
  2. 部署后在 /mcp 提供 MCP。按常规部署 API 配置即可,网关生成支持 MCP 的配置,在 /mcp 基路径上接收标准 MCP JSON-RPC;tools/call 被转码成对应 REST 请求,过完现有策略后再把响应译回 MCP。
  3. 单独决定谁可以发现工具。默认 tools/list 未鉴权,便于开发,但会把工具名与输入 schema 公开给任何人;生产环境应要求 JWT——文中明确 API key 护不住 discovery。tools/call 则始终执行底层 REST 操作本身的鉴权,与 discovery 是否加锁无关。
  4. 用 ADK 接入。任意 MCP 客户端可指向网关的 /mcp;ADK 示例用 McpToolset 加 StreamableHTTPConnectionParams,并带上网关已要求的凭证头。

关键数据/例子

可核边界包括:单网关最多约 1000 个工具;MCP 与 model routing 不能启用在同一份 API config;返回空体(如 HTTP 204)的操作不会暴露为工具;深层嵌套对象 schema 在 tools/list 里可能渲染不全。Public Preview 覆盖 REST 与 OpenAPI 3.x 后端及现有鉴权;MCP resources / prompts、响应流式,以及 Model Armor 载荷检查仍在路线图上。文中给出 MCP-Protocol-Version: 2025-11-25 的 curl tools/call 示例。

创新点

第一,让 MCP 与 REST 共用同一条策略与配额路径,转码后的请求与普通 REST 调用无异。第二,把「发现是否公开」和「调用是否鉴权」拆开配置,避免用 API key 误以为已经护住了 tools/list。第三,明确与 Apigee、Agent Gateway、模型路由的分工,而不是把所有 AI 流量塞进一个网关配置。

可否复用

  1. 先把规格升到 OpenAPI 3.x,再打开 MCP,而不是在 2.0 上硬接。
  2. 生产环境给 tools/list 配 JWT,不要指望 API key 护 discovery。
  3. 为每个工具写「何时/为何调用」的 description,并把 204 空体操作从工具面排除。
  4. 需要企业全栈治理时走 Apigee,需要出站 agent 治理时走 Agent Gateway,不要把 MCP 与 model routing 塞进同一份 config。

笔记会在输入时自动保存。