自定义连接器使用远程 MCP 在 Claude、Cowork 和 Claude Desktop 上可用,适用于免费、专业版、最大版、团队和企业计划的用户。免费用户限制为一个自定义连接器。此功能目前处于测试阶段。
构建远程 MCP 服务器
要开始使用远程服务器,请从以下资源开始:
身份验证规范,特别是关于 第三方服务的身份验证流程 的详细信息。
TypeScript 和 Python SDK 中的远程服务器示例。
TypeScript 和 Python SDK 中的客户端和服务器身份验证实现。
其他资源(如 这个)也可能有助于了解构建、部署和排查远程服务器故障时的注意事项。
此外,一些 解决方案如 Cloudflare 提供具有内置自动扩展、OAuth 令牌管理和部署的远程 MCP 服务器托管。
MCP 支持
平台
远程 MCP 服务器在 Claude 和 Claude Desktop 上支持专业版、最大版、团队和企业计划。
要在 Claude Desktop 中配置远程 MCP 服务器,请通过 自定义 > 连接器 添加它们。Claude Desktop 不会连接到直接通过
claude_desktop_config.json配置的远程服务器。
自 7 月起,Claude iOS 和 Android 版本也支持远程 MCP 服务器!
用户可以使用他们已通过 claude.ai 添加的远程服务器中的工具、提示和资源。用户无法直接从 Claude Mobile 添加新服务器。
网络可达性
所有远程 MCP 连接都来自 Anthropic 的云基础设施,无论用户运行的是哪个 Claude 客户端。您的服务器必须接受来自 Anthropic IP 范围的入站 HTTPS 连接——请参阅 Anthropic IP 地址 了解当前列表。
即使用户在本地运行 Cowork 或 Claude Desktop,这也适用。通过 自定义 > 连接器 添加的远程连接器由服务器端代理,因此对您的 MCP 服务器的请求来自 Anthropic,而不是来自用户的计算机。
如果您的服务器在专用网络内运行,请配置您的防火墙或入口以允许来自 Anthropic 已发布 IP 范围的入站流量。仅可通过 VPN 访问或位于阻止 Anthropic 出站 IP 的防火墙后面的服务器将无法连接。
传输和身份验证
Claude 支持基于 SSE 和 Streamable HTTP 的远程服务器,尽管 SSE 的支持可能在未来几个月内被弃用。
Claude 支持无身份验证和基于 OAuth 的远程服务器。
身份验证支持
Claude 支持 3/26 身份验证规范 和(自 7 月起)6/18 身份验证规范。
Claude 支持 动态客户端注册 (DCR)。
OAuth 服务器可以通过从令牌端点返回 HTTP 401 和 invalid_client 错误来向 Claude 发出信号,表示 DCR 客户端已被删除,Claude 应重新注册该客户端,如 RFC 6749 中所述。
自 7 月起,用户还可以在配置不支持 DCR 的服务器时指定自定义客户端 ID 和客户端密钥。
Claude 的 OAuth 回调 URL 是 https://claude.ai/api/mcp/auth_callback,其 OAuth 客户端名称是 Claude。
此回调 URL 将来可能会更改为 https://claude.com/api/mcp/auth_callback ——如果您选择将 MCP 客户端回调 URL 列入白名单,请同时将此回调 URL 列入白名单,以确保您的服务器继续与 Claude 配合使用。
Claude 支持令牌过期和刷新——服务器应支持此功能以为用户提供最佳体验。
请参阅 此处 了解 Claude 用于与 MCP 服务器进行入站和出站连接的 IP 地址。希望禁止非 Claude MCP 客户端的服务器开发人员可以将这些 IP 地址、Claude 的 OAuth 回调 URL 和/或 Claude 的 OAuth 客户端名称列入白名单。
协议功能
Claude 支持工具、提示和资源。
Claude 支持基于文本和图像的工具结果。
Claude 支持基于文本和二进制的资源。
Claude 尚不支持资源订阅、采样和其他更高级或草案功能。
测试远程 MCP 服务器
测试和验证服务器的最佳方法是尝试 将其添加到 Claude。
或者,使用 检查器工具。这将允许您验证:
您的服务器是否成功启动并完成身份验证流程。
您的服务器是否正确实现了身份验证流程的各个部分。
您的服务器公开的工具、提示、资源和其他 MCP 功能。
请参阅 MCP 文档 了解有关使用检查器的更多详细信息以及有关如何调试和排查服务器故障的其他提示。
此外,其他解决方案如 Cloudflare 的 AI Playground 允许您测试远程 MCP 服务器功能。
