教程

Claude MCP Tunnels 指南:不用开放入站端口,也能把私有 MCP 服务接给 Claude

MCP Tunnels 是 Anthropic 面向企业内网 MCP 服务的 beta 能力,通过 outbound-only 连接、cloudflared、proxy、inner TLS 和 OAuth,让 Claude 安全访问私有工具与数据源。

2026/6/63分钟 阅读ClaudeEagle

MCP Tunnels 是 Anthropic 面向企业私有网络的 MCP 接入方案。它允许 Claude 访问运行在内网里的 MCP servers,而不需要打开 inbound firewall ports,也不需要把服务暴露到公网。

目前 MCP Tunnels 处于 beta / research preview,需要申请访问。


它解决什么问题?

企业里很多关键工具都在私有网络中:

  • 内部文档搜索
  • 数据库查询服务
  • 监控和告警系统
  • 私有 Git / CI 平台
  • 内部工单系统
  • 自研业务 API

如果直接把这些 MCP server 暴露到公网,安全风险很高。MCP Tunnels 通过 outbound-only 连接,让内网主动连出去,Claude 再通过隧道访问这些 MCP 服务。


基本架构

隧道栈由两个运行在你网络里的组件组成:

cloudflared

Cloudflare 的开源 tunnel connector。它主动连接到 tunnel edge,并承载从 Anthropic 到你 proxy 的加密流量。

Proxy

Anthropic 的路由组件。它负责:

  • 终止 inner TLS
  • 验证 upstream IP 是否在允许范围内
  • 根据 hostname 把请求路由到正确 MCP server

每个暴露的 MCP server 会获得一个 tunnel domain 下的 hostname,例如:

text
docs.<your-tunnel-domain>

部署前提

官方要求你至少具备:

  • Kubernetes cluster,或带 Docker / Docker Compose 的 VM
  • 在 Claude Console 中创建 tunnel
  • 一套认证到 Tunnels API 的方式
  • 一个或多个运行在私有网络中的 MCP servers
  • 符合要求的 outbound connectivity

认证方式推荐 Workload Identity Federation,也可以手动提供 tunnel token 和证书。


安全模型

MCP Tunnels 使用三层保护:

  1. Anthropic 与传输提供商之间的 outer mTLS 和 IP 验证
  2. Anthropic backend 到你 proxy 的 inner TLS
  3. 每个 MCP server 自身的 OAuth 或认证机制

Cloudflare 提供传输网络,但由于 inner TLS 的证书由你持有,Cloudflare 无法读取 MCP 请求和响应内容。它能看到的是连接元数据,例如 egress IP、连接时间和字节量。


责任边界

Anthropic 负责:

  • tunnel access control
  • 连接前验证 CA certificate
  • 确保 Claude 只发送请求到你组织拥有的 tunnel

你的组织负责:

  • 保护 tunnel token 和 TLS 私钥
  • 配置和续期 server certificate
  • 给每个 MCP server 配 OAuth
  • 限制 proxy 和 MCP server 的网络访问
  • 处理经过 tunnel 的内容与合规责任

如果 tunnel token 和 TLS 私钥同时泄露,攻击者可能伪装 proxy 并读取 MCP payload,因此它们应当被视为高价值密钥。


如何使用 tunneled MCP servers?

隧道启动并拥有有效 CA certificate 后,可以用于:

  • Claude Managed Agents:在 Console 的 session 中添加 MCP Server
  • Messages API:在 mcp_servers 数组中传入 tunneled MCP server URL

注意:tunnel 只负责加密传输和连接,不替代 MCP server 自身认证。如果上游 MCP server 需要 OAuth 或 bearer token,仍需要单独配置。


适合企业的场景

  • 不想开放 inbound ports
  • 不想 allowlist Anthropic IP 到 origin
  • 需要 Claude 访问内网工具
  • 希望统一管理企业 MCP 服务
  • 需要较强的 TLS、OAuth 和网络边界

对企业 Agent 平台来说,MCP Tunnels 是把 Claude 接入真实内部系统的重要基础设施能力。


来源:Anthropic 官方文档 - MCP tunnels | 整理:ClaudeEagle

相关文章推荐

教程Claude Cache Diagnostics 教程:定位 Prompt Cache Miss 的真正原因Claude Cache Diagnostics 解决 prompt cache miss 难排查问题。通过传入上一次 response id,API 会比较请求 fingerprint,告诉你 model/system/tools/messages 哪个部分破坏了缓存 prefix。2026/6/6教程Claude Mid-conversation System Messages 使用指南:长会话不再破坏 Prompt CacheClaude Opus 4.8 新增 mid-conversation system messages,可在长会话中途追加系统级指令,不改顶层 system prompt,从而保持缓存 prefix 命中,降低 Agent 循环成本。2026/6/6教程Claude Citations 完整指南:让 AI 回答带可验证引用,适合 RAG 与文档问答Claude Citations 官方能力中文整理:如何启用 citations.enabled、支持的文档类型、PDF 页码引用、文本字符索引、custom content block 索引、RAG chunk 粒度控制、与 Prompt Caching 兼容性和 Structured Outputs 不兼容限制。2026/5/21教程Claude Batch Processing 完整指南:批量处理任务如何节省 50% API 成本Claude Batch Processing 官方能力中文整理:为什么批处理能省钱、如何创建 batch、custom_id 设计、轮询状态、下载结果、处理失败请求,以及适合大规模分类、摘要、翻译、数据清洗的任务模式。2026/5/21教程Claude Prompt Caching 完整指南:降低长上下文成本与延迟的 API 实战Claude Prompt Caching 官方能力中文整理:适合缓存的内容、cache_control 使用方法、缓存断点策略、长文档和工具定义复用、成本/延迟收益、常见坑和生产环境落地建议。2026/5/21教程Claude Code MCP 完整接入指南:HTTP、SSE、stdio、OAuth 和 ChannelsClaude Code MCP 官方文档中文整理:MCP 能做什么、何时该接入、HTTP/SSE/stdio 三种安装方式、claude mcp add 命令、.mcp.json 配置、/mcp 面板、OAuth 认证、动态工具更新、自动重连、Channels 推送消息、插件内置 MCP 服务器,以及安全风险与最佳实践。2026/5/15