MCP 隧道

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

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

工作原理

隧道堆栈由两个在您的网络内运行的组件组成：

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

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

前提条件

在部署之前，请确保您具备以下条件：

• 一个部署目标：Kubernetes 集群，或安装了 Docker 和 Docker Compose 的虚拟机。
• 在 Claude Console 中创建的隧道。请参阅创建隧道。
• 一种让您的堆栈向 Tunnels API 进行身份验证的方式。选择以下其中一种：
  • 编程式访问（推荐）。 在创建隧道时设置 Workload Identity Federation（工作负载身份联合）。您的堆栈从您的身份提供商处生成短期 API 令牌，获取隧道令牌，并自动生成和注册 CA 证书。需要具备管理联合规则的权限、已注册的 OIDC 颁发者，以及具有 org:manage_tunnels 范围的联合规则。
  • 手动。 自行提供静态凭据：来自 Console 的隧道令牌，以及由您在 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 托管代理和 Messages API 访问。

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

托管代理（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 测试版标头，它与 Tunnels API 使用的 mcp-tunnels 测试版是分开的。请使用创建隧道所在工作区的 API 密钥（Console Settings > API keys）。

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

curl https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -d '{
    "model": "claude-opus-4-8",
    "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"}]
  }'

有关各种语言的 SDK 示例，请参阅 MCP 连接器；唯一隧道特定的值是 url。

后续步骤