采用 Gemini Enterprise 的企业团队正在日益构建自定义 模型上下文协议(MCP) 服务器,以连接 AI 智能体与内部 API、数据库及业务工作流。 Google Cloud Run 非常适合托管这些轻量级 StreamableHTTP MCP 服务器:它可以自动扩缩容,开箱即用地管理 TLS 证书,并与 Cloud IAM 原生集成。
然而,将自定义 MCP 服务器从初始原型迁移到企业生产环境,会立即带来三个现实的安全和网络挑战:
- 不暴露于公共互联网(仅限内部入站流量): 企业安全策略要求内部 MCP 服务器阻止所有公共互联网流量,并且只接受来自私有虚拟私有云(VPC)网络的请求。在 Cloud Run 上启用内部入站流量后,来自 Gemini Enterprise 的默认公开调用会在 Google 边缘被拒绝,并返回 HTTP 404。
- 服务和用户身份验证(Cloud Run IAM + OAuth 2.0): 生产部署要求对每次工具调用进行两项相互独立的身份检查。Cloud Run IAM 必须验证网络请求是否来自获得授权的 Gemini Enterprise 实例,而 MCP 应用代码必须先验证已登录用户的 OAuth 2.0 访问令牌,才能代表其执行操作。
- 共享 VPC 的规模化部署且不发生 DNS 冲突: 大型企业通常会在一个集中式共享(Hub)VPC 中运行数百个 Cloud Run 服务。仅为一台 MCP 服务器在 Private Cloud DNS 中覆盖整个 *.run.app 域,可能会劫持 DNS 解析,并破坏该网络中其他 Cloud Run 服务的路由。
下面介绍如何使用 Egress Agent Gateway, Private Service Connect(PSC)和 限定 FQDN 的 Private Cloud DNS解决上述三个挑战,并提供可运行的参考实现和配置脚本,详见 GitHub.
私有路径的工作原理
要将 Gemini Enterprise(运行在 Google 管理的租户项目中)连接到内部无服务器 Cloud Run MCP 服务器,需要跨越 两个网络跃点 和 一次限定范围的 DNS 查询:
图 1:用于将 Gemini Enterprise 连接至内部 Cloud Run MCP 服务器的私有 VPC 和双请求头身份验证架构。
在此架构中,三种 Google Cloud 网络和身份机制协同工作:
1. 双桥接私有 VPC 路由(PSC Network Attachment + PGA 或面向 Google API 的 PSC)
与子网内拥有内部 IP 地址的 Compute Engine 虚拟机不同,Cloud Run 是无服务器服务。因此,私有路由需要使用两层桥接:
- 桥接 1(通过 PSC Network Attachment 进入 VPC): 一个区域级 Egress Agent Gateway 以 Agent-to-Anywhere 模式连接到区域子网(us-central1 或 europe-west1)中的 PSC Network Attachment 。这样无需公共 IP 或入站防火墙规则,即可在 VPC 内部署一个托管式网络接口。
- 桥接 2(从 VPC 到无服务器 Cloud Run): 数据包进入 VPC 子网后,必须以私有方式到达 Google 的无服务器 Cloud Run 前端,使 Cloud Run 能够识别来源 VPC,并满足内部入站流量规则。根据企业 VPC 的设计,可以使用以下任一方式:
- 选项 A:子网 Private Google Access(199.36.153.8/30): 使用 Google 内置的 Private Google Access 虚拟 IP,无需额外的 VPC 端点(建议用于保留了指向默认互联网网关的默认 0.0.0.0/0 路由的标准 VPC)。
- 选项 B:面向 Google API 的全局 PSC Endpoint(240.0.0.10): 使用全局内部 IP 地址和以 Google 内置 all-apis 软件包为目标的转发规则(其中包括 Cloud Run,Cloud Run 侧无需内部负载均衡器或服务连接)。Google Cloud 会自动向 VPC 注入一条专用的 /32 内部路由,因此,即使在删除了 0.0.0.0/0 默认互联网路由的受限 VPC 中,Cloud Run 私有路由也能正常工作。
2. 限定 FQDN 的 Private Cloud DNS 解析(适用于共享 VPC)
当 Egress Agent Gateway 收到针对 Cloud Run MCP 服务器 URL 的工具调用时,它会先解析一次主机名,再将数据包注入 VPC。如果没有 Private Cloud DNS,公共 DNS 会将 .run.app 域解析为公共互联网 IP;由于 PSC Network Attachment 不会路由至公共互联网,这些连接会超时(HTTP 502)。
不要创建会覆盖共享 VPC 中每个 Cloud Run 服务 DNS 解析的通配符 *.run.app 私有区域,而应创建一个 Private Cloud DNS 区域,将其范围 仅限于 MCP 服务的确切完全限定域名(FQDN),并且只将该域名与 Agent Gateway 对等连接。由于 Cloud DNS 使用最长后缀匹配,共享 VPC 中的其他所有 Cloud Run 服务仍可正常解析。同时,Agent Gateway 会连接到私有 VIP(199.36.153.8 或 240.0.0.10)并建立 HTTPS 连接,同时在 TLS SNI 和 HTTP Host 请求头中保留 Cloud Run 服务的主机名,使 Cloud Run 能将请求路由到确切的容器。
3. 双请求头服务和用户身份验证
连接 Cloud Run MCP 服务器 URL 时,Gemini Enterprise 会在每个请求中发送两个不同的授权请求头:
- 基础设施层(X-Serverless-Authorization 请求头): 包含一个由 Google 签名、用于项目 Gemini Enterprise 服务代理的 OIDC ID 令牌。Cloud Run IAM 会在无服务器边缘根据 Cloud Run Invoker 角色验证此令牌,并在请求到达容器之前移除该请求头。
- 应用层(Authorization Bearer 请求头): 包含未经修改的已登录用户 OAuth 2.0 访问令牌,使 MCP 服务器内的中间件能够验证调用者身份并实施按用户划分的权限。
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)
Python
已复制
配置集成的 5 个步骤
我们的配套 GitHub 仓库 将整个部署流程自动化为一系列按顺序执行的设置脚本,并提供分步 Cloud Console 操作说明:
步骤 1:锁定 Cloud Run 并授予服务调用者访问权限
将 StreamableHTTP MCP 服务器部署到 Cloud Run,启用仅限内部的入站流量和 IAM 身份验证,并向项目的 Gemini Enterprise 服务代理授予 Cloud Run Invoker 角色,确保只有您的 Gemini Enterprise 实例能够调用该容器。
步骤 2:配置 VPC、PSC 网络连接和 Egress Agent Gateway
在区域 VPC 子网上启用 Private Google Access,并创建一个设置为自动接受连接的 Private Service Connect 网络连接。接下来,以 Agent-to-Anywhere 模式创建由 Google 管理的 Egress Agent Gateway,向自动创建的网关服务账号授予网络和 DNS 对等互连权限,挂接您的网络连接,并应用出站授权政策。
步骤 3:配置限定 FQDN 的 Private Cloud DNS 和 DNS 对等互连
在 Cloud DNS 中,创建一个附加到 VPC 的私有托管区域,其范围 仅限于 MCP 服务的确切 Cloud Run 主机名。将其 A 记录指向 Google 的 Private Google Access VIP(对于没有默认互联网路由的隔离 VPC,则指向内部 PSC 端点 IP),并在 Agent Gateway 上为该单一主机名配置 DNS 对等互连。
步骤 4:绑定 Agent Gateway 并在 Gemini Enterprise 中注册 MCP 服务器
在 Gemini Enterprise 控制台的 Security Configuration 下,将 Egress Agent Gateway 绑定到您的应用。使用 Cloud Run 端点和 OAuth 2.0 客户端凭据注册 Custom MCP Server 数据存储,并在连接器上启用 Agent Gateway 出站流量和 Actions 模式。
步骤 5:在 Cloud Logging 中验证私有 MCP 调用
在控制台中重新加载自定义操作,并在 Gemini Enterprise Web 应用中运行测试提示。在 Cloud Logging 中,您可以验证工具初始化、发现和执行调用是否经由 Egress Agent Gateway 私密路由到内部 Cloud Run 容器,同时确认服务 IAM 和用户 OAuth 2.0 检查均已通过。
后续步骤
要在您自己的 Google Cloud 项目中部署并测试这两种私有路由模式,请查看 GitHub 仓库 ,其中包括:
- 一个完整的 Python StreamableHTTP Cloud Run MCP 服务器,包含 OAuth 2.0 验证中间件、Dockerfile 和本地冒烟测试。
- 分步设置脚本和 Cloud Console 界面操作说明,涵盖 选项 A(子网 Private Google Access) 和 选项 B(适用于 Google API 的全局 PSC 端点),包括共享 VPC IAM 绑定和 Cloud Logging 验证。
相关文档
- 在 Gemini Enterprise 中设置自定义 MCP 服务器数据存储
- 使用 VPC 连接设置自定义 MCP 服务器数据存储的前提条件
- 为 Agent Gateway 设置 VPC 连接
- 限制 Cloud Run 的入站流量
- 服务的私有访问选项
人工智能
云
教程
学习
在 Google TPU 上使用 Tunix 和 Gemma 4 进行多轮智能体强化学习
2026 年 11 月 19 日
云
学习
探索
如何通过自定义界面处理 Gemini Enterprise 中的用户、连接器和智能体身份验证
2026 年 11 月 20 日
人工智能
云
公告
智能体异常检测:保护跨其他云运行的智能体
2026 年 11 月 20 日
AI 热点