在 Claude Console 中管理隧道

在 Claude Console 中创建隧道、注册 CA 证书、获取隧道令牌,并将通过隧道连接的 MCP 服务器附加到智能体。

本页介绍 MCP 隧道部署中 Console 一侧的内容:创建隧道、注册您的 CA 证书、获取隧道令牌,以及将上游 MCP 服务器附加到智能体。使用 Helm 部署 MCP 隧道和使用 Docker Compose 部署 MCP 隧道介绍了如何在您的网络内部运行隧道栈。

前提条件

  • 一个或多个 MCP 服务器,运行在您的私有网络中。隧道将流量路由到这些服务器;它并不托管它们。请参阅远程 MCP 服务器了解您可以部署的示例。

  • 具有"管理隧道"权限的 Console 角色,以便您可以创建和归档隧道、轮换令牌以及管理证书。组织管理员和所有者默认拥有该权限;自定义角色和按账户授予的权限也可以包含它。没有该权限的角色对 MCP 隧道页面和隧道详情仅有只读访问权限。

  • 一种让您的栈向 Tunnels API 进行身份验证的方式。请选择其一:

    • 编程访问(推荐)。在创建隧道期间设置 Workload Identity Federation(工作负载身份联合),使您的栈能够从您的身份提供商签发短期 API 令牌、获取隧道令牌,并自动生成和注册 CA 证书。需要管理联合规则的权限、一个已注册的 OIDC 颁发者,以及一条具有 workspace:manage_tunnels 作用域的联合规则。
    • 手动。跳过编程访问。创建隧道后,获取隧道令牌,自行生成并注册 CA 证书,然后将令牌和您的服务器证书作为机密提供给您的隧道栈。

创建隧道

打开 MCP 隧道页面

在 Claude Console 中,前往 MCP 隧道页面(platform.claude.com/settings/workspaces/default/mcp-tunnels)。隧道的作用域为工作区;新隧道属于 Console 中当前选定的工作区。请在侧边栏的工作区选择器中选择您需要的工作区。

为隧道命名

点击新建隧道,并在创建隧道对话框中输入名称。名称为必填项,用于在列表、详情页和智能体 MCP 服务器选择器中标识该隧道。系统会自动分配一个形如 abcd1234.tunnel.anthropic.com 的域名。

可选:设置编程访问

如果您的角色可以管理联合规则,则会出现一个设置程序化访问开关(默认关闭)。如果不能,Console 会在该位置显示一条通知,您的隧道栈将改用手动流程。无论哪种方式,创建流程的其余部分都相同。

编程访问依赖于工作负载身份联合;如果您不熟悉联合颁发者、规则和服务账户,请先阅读该页面。要打开该开关,您需要:

  1. 一个已注册的 OIDC 颁发者,对应您的栈出示令牌所用的身份提供商(例如 Kubernetes 集群、AWS IAM、Google Cloud 或 GitHub Actions)。如果您的组织还没有,请在 Claude Console 的工作负载身份页面(platform.claude.com/settings/workload-identity-federation)的颁发者选项卡中注册一个。
  2. 一条具有 workspace:manage_tunnels 作用域的联合规则。 打开开关后会显示联合规则选择器。选择一条具有该作用域的现有规则,或点击创建联合规则直接创建一条。
  3. 已将该规则的服务账户添加到此工作区。 Tunnels API 根据服务账户的工作区成员资格进行授权。如果您在组织默认工作区以外的工作区中创建隧道,请将服务账户添加到该工作区,并在部署时传入工作区 ID(Helm 使用 api.wif.workspaceId,Compose 使用 ANTHROPIC_WORKSPACE_ID)。

完全支持跳过此步骤;两份部署指南都有一个不使用编程访问选项卡。

创建隧道

点击创建隧道。Console 会配置该隧道并打开详情页面。

记录部署标识符

两种部署路径都需要:

  • 隧道 ID(tnl_...),显示在隧道详情页面上。
  • 隧道域名(abcd1234.tunnel.anthropic.com),显示在隧道详情页面上。用作代理的 tunnel_domain,并用于服务器证书的 SAN 中。

您还需要什么取决于凭据配置模式:

使用编程访问不使用编程访问
您所选规则的联合规则 ID(fdrl_...)。该规则属于组织级别,不存储在隧道上;可在 Claude Console 的工作负载身份页面(platform.claude.com/settings/workload-identity-federation?tab=rules)的规则选项卡中找到。隧道令牌,通过详情页面上令牌旁边的眼睛图标显示。请将其视为机密。请参阅获取连接详情。
组织 ID(一个 UUID),显示在 Claude Console 的组织页面(platform.claude.com/settings/organization)上。一个由您生成并在隧道上注册的 CA 证书。

使用编程访问时,您的栈通过 Tunnels API 获取隧道令牌,在本地生成 CA 和服务器证书(私钥永远不会离开您的环境),并且仅向 Anthropic 注册 CA 的公共证书。您仍然负责保护私钥的安全,并在服务器证书过期之前对其进行续期。

您的组织最多可以拥有 10 个活跃隧道。创建隧道本身不会建立任何连接;只有当您的栈使用隧道令牌接入并且已注册 CA 证书后,才会建立连接。

获取连接详情

打开隧道。详情页面显示一个包含域名和令牌的连接部分,以及一个证书部分。

字段描述
域名复制分配的 abcd1234.tunnel.anthropic.com 值。您代理的路由是此域名的子域名。
令牌点击眼睛图标(显示令牌)获取隧道令牌,然后使用复制图标将其复制到您隧道栈的机密存储中。点击轮换令牌可使当前令牌失效并签发新令牌。

添加 CA 证书

Anthropic 根据您在隧道上注册的 CA 证书来验证到您代理的内层 TLS。没有活动证书的隧道无法接受连接,并且在注册证书之前不会出现在智能体 MCP 服务器选择器中。

找到证书部分

在隧道的详情页面上,滚动到证书部分并点击添加证书。

提供证书

点击选择文件选择 .pem、.crt 或 .cer 文件,将文件拖到文本区域,或直接粘贴 PEM 块。模态窗口会拒绝私钥内容以及非 -----BEGIN CERTIFICATE----- 块的内容。文件大小不得超过 8 kB。

添加证书

点击添加证书。指纹和到期时间会出现在证书列表中,并且该部分标题上的槽位计数会递增。

一个隧道最多可持有两个活动证书,以便您可以在不停机的情况下进行轮换:在旧证书旁注册新证书,使用新密钥对重新部署您的代理,确认流量正常流动,然后点击旧证书所在行的撤销。已吊销的证书仍会在列表中显示,并带有已撤销标记。

部署隧道栈

隧道已存在于 Console 中,但在隧道栈于您的网络内部运行并使用隧道令牌拨入之前,不会有任何流量流动。请按照以下部署指南之一进行操作:

使用 Helm 部署

在 Kubernetes 集群上运行隧道栈。涵盖编程访问和手动两种流程。

在智能体中使用隧道

一旦您的栈正在运行,即可在创建 Claude Managed Agents 会话时,将通过隧道连接的 MCP 服务器添加到智能体。如需改为从 Messages API 调用相同的服务器,请参阅使用通过隧道连接的 MCP 服务器。

打开创建会话对话框

在 Claude Console 中,前往会话页面(platform.claude.com/sessions)。在侧边栏的工作区选择器中,选择包含该隧道的工作区。点击创建会话。

创建新智能体

从智能体下拉菜单中选择新建智能体,因为该对话框只能将 MCP 服务器添加到新智能体中。在名称字段中输入智能体的名称。

添加 MCP 服务器

在 MCP 服务器下,点击 MCP 服务器。在出现的卡片上,打开选择服务器下拉菜单,并从列表顶部选择您的隧道。只有所选工作区中拥有活跃 CA 证书的隧道才会列出。

输入子域名和路径

在子域名字段中,输入您代理的 routes 映射发送到该 MCP 服务器的子域名,例如 wiki。在路径字段中,输入该 MCP 服务器所需的路径,例如 mcp。检查解析为行是否在隧道域名下显示了您的子域名和路径,例如 https://wiki.abcd1234.tunnel.anthropic.com/mcp。

如果 MCP 服务器需要凭据,请添加凭据

隧道负责将流量承载到上游 MCP 服务器,但不会向其进行身份验证。如果服务器需要 OAuth 或 bearer 令牌,请点击卡片上的连接并将凭据保存到 vault 中。如果卡片上显示的是 Needs vault,请前往凭据保管库并添加一个 vault,其中包含用于解析为 URL 的凭据。如果服务器不需要身份验证,请忽略卡片上的连接或 Needs vault。要了解 vault 的工作原理,请参阅使用 vault 进行身份验证。

选择环境

在 MCP 服务器上方的环境字段中,选择一个环境。如果该字段下方没有出现警告,请继续下一步。如果警告提示该环境阻止 MCP 服务器,请点击编辑环境,这会在新的浏览器标签页中打开该环境。在网络下,将解析为行中的主机(例如 wiki.abcd1234.tunnel.anthropic.com)添加到已允许的主机。按照限制网络部分的建议,保持允许 MCP 服务器复选框未选中。点击保存,然后返回包含该对话框的浏览器标签页。

创建会话

在凭据保管库下,移除会话不需要的所有 vault。如果仍有 vault 保留,请选中确认您有权使用它的复选框。在对话框中,点击创建会话。Console 会保存该智能体并打开会话。

测试连接

让智能体使用该 MCP 服务器的某个工具。您应该会看到一次工具调用及其结果。如果智能体无法访问该服务器,请参阅MCP 隧道故障排查。

归档隧道

归档会立即使隧道停止接受连接,并且是永久性的。

在 Claude Console 中,前往 MCP 隧道页面(platform.claude.com/settings/workspaces/default/mcp-tunnels)。在侧边栏的工作区选择器中,选择包含该隧道的工作区。打开该隧道的行菜单并选择归档。当您按已归档或全部筛选列表时,已归档的隧道仍然可见。

后续步骤

安全

加固指南、凭据轮换和入侵响应。

文档内容持续同步更新