连接其他 MCP 客户端

除了 Claude 和 ChatGPT，任何支持通过 HTTP 连接远程服务器并支持 OAuth 登录的 MCP 客户端都可以使用，例如 Cursor 等 IDE，或用于测试的 MCP Inspector。本文面向自己设置此类客户端或构建自有集成的人。

#关键信息

服务器 URL

https://dock.at-harbor.com/mcp

传输方式

Streamable HTTP，无状态。每个请求都是一个携带 JSON-RPC 消息（或批量消息）的 POST，响应以 JSON 返回。没有会话 ID，也没有服务器流。

协议版本

2025-11-25、2025-06-18 和 2025-03-26

方法

initialize、ping、tools/list 和 tools/call。服务器不提供 resources 或 prompts。

登录

使用 PKCE（S256）的 OAuth 2.1。没有令牌时，服务器返回 401，并在 WWW-Authenticate 响应头中指向它的元数据。

#设置客户端

1. 在你的客户端中添加一个远程 MCP 服务器（选项通常叫“Remote”“HTTP”或“Streamable HTTP”）
2. 输入 https://dock.at-harbor.com/mcp 作为 URL
3. 客户端 ID 和密钥留空，客户端会自行注册
4. 开始连接；浏览器中会打开登录页面，随后是 LinkHarbor 授权页面
5. 选择工作区和权限，然后点击“允许”

这个设置在不同程序中的叫法各不相同。例如在 MCP Inspector 中，你选择“Streamable HTTP”传输方式。

#OAuth 流程详解

1. 客户端在没有令牌的情况下调用 MCP 服务器，收到 401 以及指向资源元数据的提示
2. 它读取授权服务器元数据（端点、支持的方法、权限）
3. 它进行注册：通过动态客户端注册（Dynamic Client Registration），或使用位于 https URL 的客户端元数据文档
4. 它打开浏览器并发起授权请求，包括 PKCE 和 resource=https://dock.at-harbor.com/mcp
5. 你登录并在授权页面上做出决定
6. 客户端用授权码换取访问令牌和刷新令牌

如果客户端没有请求任何权限，就会请求全部权限；你仍然可以在授权页面上缩小范围。如果一个已被替换的刷新令牌被再次使用，出于安全原因，LinkHarbor 会终止整个连接。

#重定向地址规则

• https 地址
• http 仅限你自己电脑上的回环地址（用于桌面客户端和 IDE）
• 采用反向域名格式的自定义应用协议（scheme）
• 每个客户端最多 10 个地址，不允许片段（fragment）

如果应用发送了未为其注册的地址，LinkHarbor 会停止：“该应用发送了未为其注册的返回地址。请求已停止。”

#供开发者使用的发现地址

#未知应用

重定向地址全部位于 claude.ai、claude.com、chatgpt.com 或 openai.com 的应用被视为已知应用。在你自己电脑上运行、通过 localhost 返回的程序（例如 Claude Code、Codex 和 IDE）会在授权页面上显示提示“LinkHarbor 不认识这个应用。它在你自己的电脑上运行。只有在你刚刚亲自启动它时才继续。”，页面底部还会显示“选择后你将返回你电脑上的应用。”其他未知的网页应用会显示“LinkHarbor 不认识这个应用。只有在你亲自发起并信任 … 时才继续。”，其中 … 处是它们的地址。如果你刚刚亲自设置了客户端，这两种提示都是正常的。只有应用发送了徽标时才会显示徽标。如果登录不是你自己发起的，请点击“拒绝”。