连接器：用内置应用和 MCP 扩展专家#

连接器为 Octop 专家扩展了访问外部服务和工具的能力。Octop 把连接器分为两类：内置连接器（一次授权即可使用的现成集成）和自定义连接器（您自己接入的 MCP 服务器）。同一连接器可以建多个实例，也可以共享给本实例其他用户。对话时按需勾选要用的实例。

#内置连接器

Octop 目前内置连接器（含 catalog 驱动的 MCP OAuth）：

在页面中连接：

连接器 → 内置连接器 → 点击连接

授权后，Octop 会把令牌保存在本机 ~/.octop/secrets/ 下，不会离开您的机器。同一连接器可添加多个实例；共享后其他登录用户也能选用。

#自定义连接器（MCP）

MCP（Model Context Protocol）是连接 AI 智能体与外部工具服务器的开放标准。在连接器 → 自定义连接器中，您可以用可视化表单或直接粘贴 JSON 来注册任意兼容 MCP 的服务器：

{
  "deepwiki": {
    "display_name": "DeepWiki",
    "url": "https://mcp.deepwiki.com/mcp",
    "transport": "streamable_http"
  }
}

支持两种服务器类型：

对于 streamable HTTP 自定义 MCP 服务器，如果服务端暴露标准 protected-resource 元数据，Octop 可以引导完成 OAuth。先保存服务器，点击探测连接；如果探测结果提示需要授权，再按一键授权完成登录。非 loopback 的 OAuth 回调需要公开 HTTPS Octop 地址。

打开对话默认选中后，未手动选择连接器的页面对话、IM 与 Cron 运行会自动带上该自定义 MCP。关闭时，你需要在每轮对话中手动勾选。

#专家如何使用连接器

从专家的视角看，每个启用的连接器——无论内置还是 MCP——都只是对话中可调用的一个工具。当您的请求需要用到外部服务时，专家会自行选择合适的工具、调用它，并把结果融入回复。您不需要手动触发。