消息MCP 隧道

MCP 隧道快速入门

使用本地 Docker Compose 部署将 Claude 连接到私有 MCP 服务器。

MCP 隧道目前处于研究预览阶段。申请访问权限以进行试用。

本快速入门指南将带您从零开始，实现 Claude 通过隧道调用私有 MCP 服务器。它使用 Docker Compose 配合手动凭据配置，这是本地测试的最短路径。对于生产部署，请参阅使用 Helm 部署或使用 Docker Compose 部署。

您将构建什么

一个双容器的隧道堆栈（包含 proxy 和 cloudflared），以及一个与之并行运行的示例 MCP 服务器。当一切运行正常时，即使没有任何服务监听公共端口，Claude 也可以通过 https://echo.<your-tunnel-domain>/mcp 访问该示例服务器。

您需要准备什么

在具有出站互联网访问权限的机器上安装 Docker 和 Docker Compose。
在 Claude Console 中拥有可以管理 MCP 隧道的角色。请参阅 Console 指南先决条件。
OpenSSL 1.1.1 或更高版本。macOS 和大多数 Linux 发行版已预装；在 Windows 上需单独安装（openssl 二进制文件必须位于您的 PATH 中）。

创建隧道
在 Claude Console 侧边栏中，转到 Manage > MCP tunnels 并点击 New tunnel。为其命名。保持 Set up programmatic access 处于关闭状态；本快速入门使用手动凭据配置。
创建完成后，打开该隧道。从 Connection 部分复制两个值：
- Domain（形如 abcd1234.tunnel.anthropic.com）
- Token（点击眼睛图标，然后复制）
设置部署目录
生成 CA 和服务器证书
代理使用由您控制的 CA 签名的证书来终止内部 TLS。生成这两者：
返回 Console，在隧道详情页面上，点击 Add certificate 并上传 data/ca.crt（或粘贴其内容）。隧道状态将变为 Active。
编写示例 MCP 服务器
编写代理配置和 compose 文件
启动
您应该会看到一行针对 echo 的 route configured 日志和四行 Registered tunnel connection 日志。容器需要几秒钟才能启动；如果日志命令返回为空，请重新运行。
从 Claude 调用
在 Console 中，转到 Managed Agents > Sessions 并创建一个会话。在智能体选择器中选择 Create new agent，为智能体命名，并保留预填的模型。点击 + MCP Server，选择您的隧道，将 Subdomain 设置为 echo，将 Path 设置为 mcp。然后询问：

Use the hello tool to greet tunnel.

您应该会看到一次工具调用及其结果。

后续步骤

隧道已完成端到端验证。要替换为您自己的 MCP 服务器，请将其添加到 docker-compose.yaml（或在同一 Docker 网络上运行它），在 config/mcp-proxy.yaml 中为其添加路由，然后重启代理（docker compose restart mcp-proxy）。

对于生产部署：

使用 Docker Compose 部署

强化的单主机部署，支持或不支持编程访问。

使用 Helm 部署

具有自动凭据管理的 Kubernetes 部署。

Was this page helpful?

您需要准备什么

在具有出站互联网访问权限的机器上安装 Docker 和 Docker Compose。

在 Claude Console 中拥有可以管理 MCP 隧道的角色。请参阅 Console 指南先决条件。

OpenSSL 1.1.1 或更高版本。macOS 和大多数 Linux 发行版已预装；在 Windows 上需单独安装（openssl 二进制文件必须位于您的 PATH 中）。

创建隧道
在 Claude Console 侧边栏中，转到 Manage > MCP tunnels 并点击 New tunnel。为其命名。保持 Set up programmatic access 处于关闭状态；本快速入门使用手动凭据配置。
创建完成后，打开该隧道。从 Connection 部分复制两个值：
- Domain（形如 abcd1234.tunnel.anthropic.com）
- Token（点击眼睛图标，然后复制）
设置部署目录
生成 CA 和服务器证书
代理使用由您控制的 CA 签名的证书来终止内部 TLS。生成这两者：
返回 Console，在隧道详情页面上，点击 Add certificate 并上传 data/ca.crt（或粘贴其内容）。隧道状态将变为 Active。
编写示例 MCP 服务器
编写代理配置和 compose 文件
启动
您应该会看到一行针对 echo 的 route configured 日志和四行 Registered tunnel connection 日志。容器需要几秒钟才能启动；如果日志命令返回为空，请重新运行。
从 Claude 调用
在 Console 中，转到 Managed Agents > Sessions 并创建一个会话。在智能体选择器中选择 Create new agent，为智能体命名，并保留预填的模型。点击 + MCP Server，选择您的隧道，将 Subdomain 设置为 echo，将 Path 设置为 mcp。然后询问：

Use the hello tool to greet tunnel.

您应该会看到一次工具调用及其结果。

后续步骤

对于生产部署：

Was this page helpful?