让企业 Gemini 私密接入内部 MCP 服务
文章给出 Gemini Enterprise 连接 Cloud Run 内部 MCP 服务的私网接入方案,组合使用出口代理网关、Private Service Connect 和限定域名的私有 DNS。认证采用双请求头 OAuth 2.0 机制。
AI 深度解读
把 MCP 服务部署到 Cloud Run,能跑通只是第一步。接入 Gemini Enterprise 后,企业往往还要求服务只接受内网请求、每次调用同时核验服务身份与用户身份,而且不能影响共享网络里的其他服务。
这篇 Google Developers Blog 给出了一套连接方案:用 Egress Agent Gateway 和 Private Service Connect 打通私有路径,用精确到单个域名的 DNS 配置控制影响范围,再把两层身份校验分开处理。它值得看的地方,是解释了为什么「开了内网访问」之后,请求仍然可能报 404 或 502。
为什么接进 VPC,还不能直接访问 Cloud Run
Cloud Run 适合托管轻量的 StreamableHTTP MCP 服务:自动扩缩容、托管 TLS 证书,也能接入 Cloud IAM。但它不像 Compute Engine VM,没有一个直接放在业务子网里的实例内网 IP。
因此,私有调用需要跨过两座桥。
第一座桥,把 Gemini Enterprise 的请求送进企业 VPC。Gemini Enterprise 运行在 Google 管理的租户项目里,作者使用区域级 Egress Agent Gateway,配置为 Agent-to-Anywhere 模式,再连接企业区域子网里的 PSC Network Attachment。原文列出的区域是 us-central1 或 europe-west1。
这一步在 VPC 内放入托管网络接口,不需要公网 IP,也不需要入站防火墙规则。但它只完成了「进入企业网络」。
第二座桥,是从 VPC 私下访问 Google 的 Cloud Run 前端,让 Cloud Run 将请求识别为满足 internal ingress 的流量。原文提供两条路径:
- Option A:Subnet Private Google Access。 使用
199.36.153.8/30,不需要额外的 VPC endpoint,适合保留指向 default internet gateway 的0.0.0.0/0默认路由的标准 VPC。 - Option B:Global PSC Endpoint for Google APIs。 示例使用全局内部 IP
240.0.0.10,通过 forwarding rule 指向all-apisbundle。Google Cloud 自动注入专用的/32内部路由,适合已经删除0.0.0.0/0默认路由的隔离 VPC。
Option B 不需要在 Cloud Run 一侧额外部署 internal load balancer 或 service attachment。也别把第二座桥的 PSC endpoint,与第一座桥的 PSC Network Attachment 混成同一个组件:它们解决的是不同方向的连接问题。
选哪条路径,先看 VPC 的路由约束。
为什么 DNS 要精确到一个服务域名
即使网络桥接完成,域名解析仍可能把请求送错地方。
Egress Agent Gateway 会在把数据包注入 VPC 前解析 Cloud Run 服务域名。如果沿用公网 DNS,.run.app 会解析到公网 IP,而 PSC Network Attachment 不提供公网出口。原文描述的结果是请求超时,返回 HTTP 502。
另一个故障发生得更早:Cloud Run 已开启 internal-only ingress,却仍由 Gemini Enterprise 从默认公网路径调用,请求会在 Google 边缘被拒绝,返回 HTTP 404。
所以,404 和 502 在这里对应不同的排查方向,不能只盯着 MCP handler。
作者的 DNS 做法,是为目标 MCP 服务的完整域名(FQDN)单独创建 Private Cloud DNS zone,并且只针对这个域名配置 Agent Gateway 的 DNS peering。A 记录指向 Private Google Access VIP,或隔离网络里的 PSC endpoint IP。
为什么不用 *.run.app?因为大型企业可能在同一个 Shared VPC,也就是共享的 Hub VPC,运行数百个 Cloud Run 服务。覆盖整个域名范围,可能连其他服务的解析和路由一起改掉。
Cloud DNS 使用最长后缀匹配,精确到目标服务域名的私有区域,可以把影响限制在这一个服务。
连接的 IP 改了,服务的名字仍要保留。Gateway 向 199.36.153.8 或 240.0.0.10 建立 HTTPS 连接时,会保留原始 Cloud Run 域名作为 TLS SNI 和 HTTP Host。前者用于 TLS 识别目标主机,后者用于 HTTP 请求路由,Cloud Run 才能找到对应容器。
两层认证分别回答什么问题
私有路径解决「请求从哪里来」,不等于解决「谁能执行什么操作」。
原文把每次工具调用的认证拆成两个 header:
X-Serverless-Authorization 携带项目 Gemini Enterprise service agent 的 Google 签名 OIDC ID token。Cloud Run IAM 在 serverless 边缘检查其 Cloud Run Invoker 权限。按原文描述,该 header 会在请求进入容器前被剥离。
Authorization: Bearer <token> 携带当前登录用户的 OAuth 2.0 access token,交给 MCP 应用校验,并用于实施用户级权限控制。
前一层确认调用方服务是否获准进入容器,后一层确认应用正在代表哪个人操作。两者不能互相替代。
下面的中间件展示了缺失或无效用户 token 时如何返回 401:
class OAuth2ValidationMiddleware(BaseHTTPMiddleware):
"""Validates the end-user OAuth 2.0 Bearer token on incoming MCP requests."""
async def dispatch(self, request: Request, call_next) -> Response:
if request.url.path == "/health":
return await call_next(request)
has_serverless_auth = "x-serverless-authorization" in request.headers
auth_header = request.headers.get("authorization", "")
if auth_header.lower().startswith("bearer "):
raw_token = auth_header.split(" ", 1)[1].strip()
verified = await _verify_google_oauth_token(raw_token)
if verified is None and REQUIRE_OAUTH:
return JSONResponse(
{"error": "Invalid or expired OAuth 2.0 Bearer token."},
status_code=401,
)
elif REQUIRE_OAUTH:
return JSONResponse(
{"error": "Missing Authorization: Bearer <token> header."},
status_code=401,
)
return await call_next(request)
要看清 verified is None and REQUIRE_OAUTH 这一行:拒绝无效 token 的行为受 REQUIRE_OAUTH 控制。/health 则绕过这段应用校验。
这段代码也有展示边界。_verify_google_oauth_token 的实现没有贴出,无法据此判断具体校验项;has_serverless_auth 只是赋值,后续没有使用,不能把它当成服务身份认证。代码也没有展示如何把验证结果传给业务处理函数,更没有展示逐个工具的权限判断。
验证用户身份,只是执行用户权限控制的起点。
配置顺序为什么值得照着走
原文把落地过程分成五步,这个顺序也适合拆解故障。
先部署 Cloud Run MCP 服务,开启 internal-only ingress 和 IAM authentication,再向项目的 Gemini Enterprise service agent 授予 Cloud Run Invoker 角色。
接着配置 VPC、PSC Network Attachment 和 Egress Agent Gateway。原文流程包括启用子网 Private Google Access、让 Network Attachment 自动接受连接、为 Gateway 自动创建的 service account 配置网络及 DNS peering 权限,并应用 outbound authorization policy。
第三步配置单域名 Private Cloud DNS 与 DNS peering,根据 Option A 或 Option B 选择目标地址。
第四步在 Gemini Enterprise 的 Security Configuration 中绑定 Gateway,再注册 Custom MCP Server data store,填写 Cloud Run endpoint 和 OAuth 2.0 client credentials,并启用 Agent Gateway egress 与 Actions mode。
最后重新加载 custom actions,在 Gemini Enterprise 网页端发起测试提示词,并通过 Cloud Logging 检查工具初始化、发现和执行请求。
原文称配套仓库提供 Python 服务、Dockerfile、本地 smoke tests,以及两种网络路径的脚本和控制台操作说明。不过,给定材料没有附上仓库地址,也没有展示实际日志、延迟或吞吐数据。
我的判断
这套方案最有价值的是把私有路由、域名解析、服务身份和用户身份分开解释。对已经使用 Gemini Enterprise、Cloud Run 和 Shared VPC 的团队,单域名 DNS 配置尤其有参考价值:一个 MCP 服务的接入,不该扩大成整个共享网络的解析变更。
它也有明确前提。这是一套 Google Cloud 产品组合下的方案,不能直接当成所有 MCP 客户端都适用的通用接法。双 header 的传递方式、Gateway 的能力和 Cloud Run 的 IAM 行为,都依赖这条具体集成链路。
与保留公网入口、依靠 IAM 限制访问的做法相比,它多解决了私有网络准入要求,也增加了 Gateway、PSC、DNS 和权限绑定的配置工作。与直接覆盖 *.run.app 相比,单域名方案的影响范围更清楚。
至于 Option A 被推荐用于标准 VPC,原文给出的是路由条件和组件数量上的理由,没有两种方案的性能、成本或稳定性对照数据。可以把它作为架构选型依据,不能据此宣称哪一种在所有环境下更好。
能拿来做什么
- 接入内部 MCP 服务前,先画清「Gemini Enterprise 到 VPC」和「VPC 到 Cloud Run」两段路径,再根据是否保留
0.0.0.0/0默认路由选择 Option A 或 Option B。 - 在 Shared VPC 中,为目标 Cloud Run 完整域名单独配置私有 DNS,并核对 TLS SNI、HTTP Host 和连接 IP,避免扩大解析变更范围。
- 给 Python 或 Node MCP 服务实现认证时,分开处理服务准入、用户 token 校验和工具权限;移植示例前,补齐 token 验证实现与身份传递逻辑。
- 联调时覆盖工具初始化、发现和执行,通过 Cloud Logging 对照检查;遇到原文所述的 404 或 502,先分别排查 ingress 路径和 DNS 目标。