TodayAI

GuidesMCP

连接远程 HTTP MCP Server

按官方 Connect to remote MCP Servers:在 Claude 中添加 Custom Connector,用远程 MCP URL 完成鉴权、资源接入与工具权限配置。

基于 Model Context Protocol Docs 整理 · 官方资料 ↗

本地 stdio Server 适合本机工具;远程 MCP Server 跑在互联网上,任何能上网的 MCP 客户端都能连,适合云端数据与团队共享能力。

官方这篇以 Claude 的 Custom Connectors 为例:填入远程 MCP URL,完成鉴权后即可使用 resources、prompts 与 tools。传输层上,远程部署主流是 Streamable HTTP。

远程 Server 和本地有什么不同

能力模型相同:仍暴露 tools / prompts / resources。差别在部署与接入——远程 Server 不需要每台设备安装进程,客户端只要持有 URL(以及鉴权)。

官方示例远程端点形态类似:

官方示例 Remote Server URL

text
https://example-server.modelcontextprotocol.io/mcp

在 Claude 里添加 Custom Connector

  • 打开 Claude Desktop 或浏览器版 Settings → Connectors
  • 点 Add → Add custom connector
  • 粘贴完整远程 MCP URL(含 https:// 与路径)
  • 按 Server 要求完成 OAuth / API Key 等鉴权

鉴权成功后,在输入框的「Add files, connectors, and more」里可把该 Server 的 resources / prompts 加入对话;回到 Connectors 设置可开关具体 tools。

鉴权与工具权限

多数远程 Server 需要鉴权。流程因实现而异,常见是 OAuth:客户端发现授权服务器、拿 token,再以 Authorization: Bearer 访问 MCP 端点。

规范层面,HTTP 传输上的授权是可选但推荐的能力;stdio 不适用同一套 header 鉴权模型。务必只连接可信来源,并审查请求的权限范围。

调试前可用 Inspector 探活远程端点

bash
npx @modelcontextprotocol/inspector --server-url https://example-server.modelcontextprotocol.io/mcp --transport http

使用远程 Server 的建议

  • 连接前核验 Server 来源与文档
  • 按项目整理多个 connector,定期删除不用的连接
  • 在 connector 设置里关闭不需要的高风险 tools

若要自己提供远程能力,需按 Streamable HTTP 暴露 MCP 端点,并按规范处理鉴权与 Protected Resource Metadata;本地开发仍可从 构建你的第一个 MCP Server 起步,再用 Inspector 验证。

容易踩的坑

URL 填错或缺路径

使用 Server 文档给出的完整 MCP 端点,通常形如 https://host/mcp,不要省略协议。

鉴权卡住或反复失败

确认允许弹窗/回调;检查是否连到正确的 authorization server,以及 token 是否过期。

能连上但工具不可用

到 Connectors 里检查该 Server 的 tool 权限开关,以及对话中是否已添加对应 connector。

官方资料

Model Context Protocol Docs

Connect to remote MCP Servers