← 返回全部情报
Google Apigee hybrid 1.17 把 MCP 数据面放进自有 K8s:请求不出集群,配置只出站拉取 的封面

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

Google Apigee hybrid 1.17 把 MCP 数据面放进自有 K8s:请求不出集群,配置只出站拉取

Apigee hybridMCPKubernetesAPI productOpenTelemetry

一句话结论

Apigee hybrid 1.17.0 把 MCP Discovery Proxy 的数据面跑在客户自有 Kubernetes 集群里:tools/list 与 tools/call 的请求流量不出集群,工具配置由 sidecar 出站拉取;沿用现有 API 产品做工具级授权与发现过滤,并可用 W3C traceparent 打通端到端追踪。

打开原文 Google Developers Blog:Announcing MCP support in Apigee hybrid

背景与理念

许多 Apigee 客户的运行时本来就不在 Google 托管基础设施上,而是放在自有机房、托管机柜或另一朵公有云。监管、系统邻近或多云现实,都要求 agent 能发现并调用已有 API,却不必把运行时迁走。

作者把问题写成:不是「要不要 agentic 访问」,而是「能不能在运行时实际所在的地方拿到它」。

具体做法

  1. 用 OpenAPI 3 生成 MCP Discovery Proxy。描述 API 的 OpenAPI 3.0.x 规范后创建代理,规范中的每个操作变成一个 MCP 工具;agent 用 JSON-RPC 的 tools/list 发现、tools/call 调用,由 Apigee 处理协议与转码,不必自写或另运维一套 MCP server。
  2. 数据面留在自有集群。hybrid 1.17.0(2026-09-14 发布)起,控制面从 OpenAPI 生成工具配置,集群周期性拉取;MCP 请求在自有基础设施内接收、鉴权并代理到后端,请求时响应不越界到 Google Cloud。
  3. 配置只出站拉取。MCP 数据面旁的 sidecar 主动去取配置,控制面从不主动连入集群,因此不需要从 Google 打进内网的入站通道;sidecar 复用现有 apigee-watcher 身份,不必新建 Google 服务账号或额外 IAM 角色。
  4. 治理继承到 agent。MCP 端点仍是 Apigee 代理,可沿用 OAuth 2.0、OpenID Connect、API key 与策略库;用 API product 列出客户端可用的具体工具操作,并可配每工具配额,tools/list 只返回该产品内的工具。
  5. 可观测与追踪。已部署的 MCP Discovery Proxy 会进 API hub(MCP API 风格),可用 API insights 的 API style 与 MCP tool name 过滤器拆开 agentic 与普通 REST 流量;MCP 客户端把 W3C trace 上下文放在 JSON-RPC 的 _meta 里,Apigee 抽出并转成普通的 traceparent / tracestate 头。

关键数据/例子

版本与默认值可核:hybrid 1.17.0 于 2026-09-14 发布;启用需在 overrides.yaml 设 enableMcpServer: true,先升 apigee-operator 再升 apigee-org,顺序反了会「升级成功却没有 MCP pod」。默认 2 个 MCP 副本,可自动扩到 10。文中给出带 MCP-Protocol-Version: 2025-11-25 与 _meta.traceparent 的 curl tools/call 示例。作者强调启用或关闭 MCP 会触发运行时 pod 的分阶段 canary,应放在已批准的维护窗口。

创新点

第一,把「agent 工具面」做成现有 API 治理面的延伸,而不是另起一套无门禁的 MCP 服务器。第二,用「流量不出集群 + 配置出站拉取」把数据驻留与主权要求写进架构,而不是事后开关。第三,用 API product 同时管调用权限与发现列表,避免 agent 看见却不准用的工具。

可否复用

  1. 先确认运行时是否必须留在自有集群或指定辖区,再选 hybrid 而非完全托管路径。
  2. Helm 启用严格按 operator → org 顺序,并单独做一次 apigee-watcher 的组织级授权。
  3. 用 API product 白名单工具,让 tools/list 与 tools/call 受同一授权边界约束。
  4. 端到端追踪时约定 _meta → traceparent 转发,并在同一追踪后端汇聚 AI 客户端、网关与后端耗时。

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