跳到主要内容

自定义 MCP 服务器

除了 Rephlo连接器目录中的连接器之外,您还可以连接一台自定义 MCP 服务器——由您自己运维,或由您信任的人运维。这适合已经拥有 MCP 服务器及访问令牌的高级用户。

自定义服务器在桌面应用的 Settings → Connectors → Add custom connector 中添加。此功能没有网页端界面;一切都在您本机上完成。

开始之前​

您需要准备:

  • 一台您可以访问的 MCP 服务器(其命令,或其 URL)。
  • 该服务器所需的持有者令牌(bearer token)(如果它要求身份验证)。

目前仅支持持有者令牌认证。 自定义服务器目前仅通过单一的预共享持有者令牌进行身份验证——您粘贴一个令牌,Rephlo 会在每次请求中附带该令牌。基于 OAuth 的自定义服务器(即需要通过浏览器登录的方式,类似 Notion)尚不支持,将在后续版本中推出。

添加自定义服务器​

  1. 打开 Settings → Connectors,点击 Add custom connector。
  2. 为服务器取一个名称,方便您日后识别。
  3. 选择一种传输方式(transport)——即 Rephlo 与服务器通信的方式:
    • Streamable HTTP——Rephlo 通过网络连接到服务器的 URL。
    • Stdio——Rephlo 在您本机上启动一个本地可执行文件(executable),并直接与其通信。
  4. 填写与所选传输方式对应的设置(见下表)。
  5. 粘贴服务器的持有者令牌。
  6. 保存。Rephlo 会建立连接,询问服务器提供哪些工具,随后该服务器的工具便可在对话中使用。

Add Custom Connector 面板——传输方式选择(Streamable HTTP 与 Stdio)、配置字段以及持有者令牌

Add custom connector 面板,包含传输方式选择和持有者令牌字段。

传输方式设置​

传输方式必填可选
Streamable HTTP服务器 URL用于身份验证的持有者令牌
Stdio要启动的可执行文件路径参数(Arguments)

Rephlo 自身的连接器目录会将部分服务器绑定到一个 SHA-256 二进制哈希值以做额外校验,但这由 Rephlo 一侧管理——添加您自己的自定义连接器时,这不是您需要设置的字段。

您的数据存放在哪里​

  • 自定义服务器及其持有者令牌以加密方式存储在您的设备上。它们不会发送到 Rephlo 的后端。
  • 自定义服务器的工具调用直接从您的桌面运行到该服务器——不会经过 Rephlo 的云端。
  • 与所有连接器一样,工具结果只在会话期间保留在内存中,本地审计日志仅记录工具名称、耗时和状态——绝不记录参数或内容。

故障排查​

服务器拒绝连接(401 / unauthorized)。 持有者令牌错误或已被轮换。请移除该服务器,并使用正确的令牌重新添加。

连接超时。 请检查服务器 URL 是否可达,以及服务器的响应速度是否足够快——工具调用有固定的时间限制。如果服务器本身较慢,请排查其性能或可用性问题。

工具未出现,或工具调用解析失败。 服务器必须使用有效的 MCP 协议,并在 Rephlo 连接时声明其工具。请确认服务器发出的是格式正确的 MCP 工具定义与响应。

相关内容​