MCP 隧道安全

MCP 隧道部署的加固指南、凭证轮换、入侵响应和拆除。

隧道架构提供了强大的默认设置(仅出站连接、端到端加密和 IP 验证),但您的隧道栈的整体安全性还取决于您如何配置和运维它。本页介绍推荐的加固措施、入侵响应以及如何停用隧道。

最佳实践

  • 在每个 MCP 服务器上要求 OAuth。 按照 MCP 授权规范中的说明,将每个上游 MCP 服务器配置为要求 OAuth。OAuth 在隧道的传输层身份验证之上提供纵深防御,并允许在数据层进行用户级授权。
  • 为您的组织启用 SSO。 隧道、联合规则和服务账户在 Claude Console 中管理。SSO 会对能够更改这些设置的管理员强制执行您的身份提供商的会话控制。
  • 限制 upstream.allowed_ips。 使用能够覆盖您的 MCP 服务器的最小 CIDR 范围。这是代理的主要 SSRF 防御手段。
  • 监控日志。 对来自隧道栈的警告、错误和异常流量模式设置告警。
  • 轮换凭证。 定期轮换服务器证书和隧道令牌,如果怀疑遭到泄露,请立即轮换。
  • 保持镜像更新。 跟踪新的代理版本,并通过 SHA-256 摘要固定镜像。
  • 限制网络可达范围。 代理和 cloudflared 应只能访问网络要求中列出的目标地址。使用 NetworkPolicy(Kubernetes)或主机防火墙规则(Compose)。
  • 限制 MCP 服务器范围。 每个服务器应仅暴露其用途所需的工具和数据。
  • 保护静态凭证。 对私钥和隧道令牌应用您组织的密钥管理实践。

响应疑似入侵

如果您认为您的隧道令牌、TLS 密钥或代理主机已遭泄露:

停止隧道栈

Helm

示例代码
helm uninstall mcp-tunnel -n mcp-tunnel

Docker Compose

示例代码
docker compose down --timeout 0

分离上游 MCP 服务器

从所有使用上游 MCP 服务器的 Managed Agent 会话中移除这些服务器,并停止在 Messages API 请求的 mcp_servers 块中传递它们的 URL。

归档隧道

归档会使隧道令牌失效并分离域名。在 Console 中,从 MCP 隧道列表中归档隧道。如需改为通过 API 归档,请参阅归档隧道。

联系 Anthropic

向 Anthropic 支持团队报告疑似泄露事件。

轮换下游凭证

重新配置一个新的隧道,并轮换受影响的 MCP 服务器签发的所有 OAuth 令牌。

在恢复服务前审查日志

在新隧道上线之前,检查疑似泄露时间段内的代理、cloudflared 和 MCP 服务器日志。

拆除隧道

按照以下步骤停用隧道并移除所有已存储的凭证。

停止隧道栈

Helm

示例代码
helm uninstall mcp-tunnel -n mcp-tunnel

Docker Compose

示例代码
docker compose down

归档隧道

在 Console 中,从 MCP 隧道列表中归档隧道。

移除已存储的凭证

Helm

使用编程访问时,设置组件创建了一个以 release 命名的 Secret。未使用编程访问时,您自己创建了 mcp-tunnel-token 和 mcp-tunnel-cert。删除适用的项:

示例代码
kubectl -n mcp-tunnel delete secret \
  mcp-tunnel mcp-tunnel-token mcp-tunnel-cert \
  --ignore-not-found

Docker Compose

私钥和证书位于 data/ 中。隧道令牌位于 data/tunnel-token(编程流程)或您的 shell 环境中(手动流程)。config/ 目录和 docker-compose.yaml 不包含任何密钥;如果您计划重新配置,请保留它们,否则也可以一并移除。

示例代码
sudo rm -rf data
文档内容持续同步更新