MCP 隧道

MCP 隧道（MCP tunnels）让您可以将 Claude 连接到运行在您私有网络内部的 "Model Context Protocol"，即 MCP 服务器。流量通过仅出站的连接传输，因此您无需开放入站防火墙端口、将服务暴露到公共互联网，或在您的源站上将 Anthropic 的 IP 范围加入允许列表。

有关零数据保留和 HIPAA BAA 资格，请参阅 API 和数据保留。

工作原理

隧道栈（tunnel stack）由运行在您网络内部的两个组件组成：

• cloudflared： Cloudflare 的开源隧道连接器。它发起到隧道边缘（tunnel edge）的仅出站连接，并将来自 Anthropic 的加密流量传送到您的代理。
• 代理（Proxy）： Anthropic 的路由组件。它终止内层 TLS（inner TLS），验证上游 IP 是否位于允许的范围内，并根据主机名将每个请求路由到正确的上游 MCP 服务器。

您暴露的每个 MCP 服务器都会在您的隧道域名下获得一个主机名（例如 docs.<your-tunnel-domain>）。您可以在 Claude Console 中将这些主机名附加到 Managed Agent 会话，或通过 MCP 连接器将它们传递给 Messages API。

前提条件

在部署之前，请确保您具备：

• 一个部署目标：Kubernetes 集群，或安装了 Docker 和 Docker Compose 的虚拟机。
• 一个隧道。在 Claude Console 中创建一个（请参阅创建隧道）或通过 API 创建；Helm chart 的设置钩子也可以在安装期间为您创建一个。
• 一种让您的栈向 Tunnels API 进行身份验证的方式。选择其一：
  • 编程式访问（推荐）。 在创建隧道时设置 Workload Identity Federation（工作负载身份联合）。您的栈从您的身份提供商签发短期 API 令牌，获取隧道令牌，并自动生成和注册 CA 证书。需要管理联合规则的权限、一个已注册的 OIDC 颁发者，以及一条具有 workspace:manage_tunnels 作用域的联合规则。
  • 手动。 自行提供静态凭据：来自 Console 的隧道令牌，以及由您在其中注册的 CA 签名的服务器证书。请参阅获取连接详情和添加 CA 证书。
• 一个或多个运行在您私有网络中的 MCP 服务器。示例请参阅远程 MCP 服务器。
• 网络要求中列出的出站连接能力。

网络要求

安全模型

安全层

三个独立的层保护每个请求：

隧道传输运行在 Cloudflare 的网络上。由于代理使用只有您持有的证书终止内层 TLS，Cloudflare 无法读取请求或响应的有效负载。在注册 CA 证书之前，Anthropic 不会连接到隧道，因此有效负载在穿越 Cloudflare 网络时始终是加密的。Cloudflare 确实会接收连接元数据；请参阅传输提供商可以观察到的内容。

责任共担模型

传输提供商可以观察到的内容

Cloudflare 提供出站传输。它无法读取 MCP 请求或响应的有效负载，但确实会接收以下连接元数据：

• 运行 cloudflared 的主机的出口 IP 地址
• cloudflared 主机指纹
• 连接时序和字节量
• 分配给您隧道的 *.tunnel.anthropic.com 子域名

Anthropic 与 Cloudflare 的协议限制了 Cloudflare 对这些遥测数据的使用。Cloudflare 在本研究预览中充当子处理方。

部署隧道

如果您是 MCP 隧道的新用户，请先从快速入门开始，在本地获得一个可用的隧道，然后再配置生产部署。

如何在它们之间选择：

• 部署目标
  • 部署到 Kubernetes 时使用 Helm。
  • 单主机或本地测试使用 Docker Compose。
• 设置阶段的身份验证
  • 当您拥有 OIDC 身份提供商（例如 Kubernetes 集群、云 IAM 或 SPIFFE）时，使用编程式访问（通过 Workload Identity Federation）。
  • 当您没有，或正在测试时，使用手动凭据。

使用通过隧道连接的 MCP 服务器

一旦您的隧道处于活动状态（它拥有一个活动的 CA 证书并且您的隧道栈已连接），上游 MCP 服务器即可从 Claude Managed Agents 和 Messages API 访问。

在这两种情况下，隧道都会将加密流量传送到您的 MCP 服务器，但不会向其进行身份验证。如果上游 MCP 服务器需要自己的身份验证（OAuth、bearer 令牌），请按照您对任何其他 MCP 服务器的方式提供；它与隧道无关。

Managed Agents（Console）

1. 在 Managed Agents > Sessions 中，创建一个会话并选择 Create new agent，以便您可以编辑 MCP 服务器列表。
2. 点击 + MCP Server 并打开下拉菜单。会话所在工作区中至少拥有一个活动证书的隧道会显示在列表顶部，位于公共连接器目录之上。
3. 选择隧道，并提供您的代理路由到特定 MCP 服务器的 Subdomain（子域名），以及上游 MCP 服务器期望的 Path（路径）。Resolves to 行会显示确切的 URL。

Messages API

在 mcp_servers 数组中传递上游 MCP 服务器的 URL，方式与任何其他远程 MCP 服务器相同。请求正文和 anthropic-beta 标头遵循标准的 MCP 连接器格式；只有 url 是隧道特有的。以下示例使用 MCP 连接器的 mcp-client beta 标头，它与 Tunnels API 使用的 mcp-tunnels beta 是分开的。请在创建隧道的工作区中发出请求：使用该工作区的 API 密钥，或者如果您的密钥可以访问多个工作区，则将 anthropic-workspace-id 标头设置为该工作区。

URL 的主机为 <subdomain>.<your-tunnel-domain>。路径取决于您的上游 MCP 服务器，而非隧道：FastMCP 的 streamable-http 传输在 /mcp 提供服务，其他服务器可能使用 / 或自定义路径（请查阅服务器的文档）。代理会原样转发路径。

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Use the hello tool to greet tunnel."}],
    mcp_servers=[
        {
            "type": "url",
            "url": "https://echo.YOUR_TUNNEL_DOMAIN_HERE/mcp",
            "name": "echo",
        }
    ],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "echo"}],
    betas=["mcp-client-2025-11-20"],
)

print(response)

有关向上游 MCP 服务器进行身份验证（authorization_token）以及其他 mcp_servers 选项，请参阅 MCP 连接器。

后续步骤