For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /guide/concepts/connectors.md.
  • 简体中文
  • 连接器:让专家去查你的应用

    连接器是专家能动手操作的外部应用。你先完成一次授权,之后不用记工具名:直接说「查一下我明天的腾讯会议」或「把这段纪要写进腾讯文档」。专家会自己决定要不要调用。

    连接器

    连接器

    先连一个你每天都在用的

    打开内置连接器

    侧栏进入连接器,打开内置连接器。

    点击连接

    选一个服务,点点击连接。同一个服务可以建多个实例,例如两个邮箱账号。

    授权并探测

    按页面提示扫码、一键授权或粘贴密钥,然后点探测。探测成功后再保存。令牌保存在本机 ~/.octop/secrets/。

    在对话里勾选并用白话提问

    打开对话,在输入框打开连接器,勾选刚才的实例。然后说出要办的事。需要每次都带上时,编辑该实例并打开是否默认开启。这个开关只对你自己的新对话生效。

    打开是否共享后,本实例其他登录用户可以选用这个实例,但不能查看或修改配置。只有所有者能编辑。

    注意

    你在外部服务里取消授权后,已保存的令牌会失效。专家下次调用时会报错。回到连接器重新授权即可恢复。

    按你要办的事来选

    页面上的分类和下面一致。名称旁是它能帮你做的事。

    办公协作

    连接器你可以让专家做的事
    腾讯文档读、写文档、智能表格和空间文件
    腾讯会议查会议、管理会议、看录制和智能纪要
    腾讯乐享检索、阅读、创建知识库文档
    腾讯微云列出、上传、下载、分享网盘文件
    腾讯设计 Ardot通过官方 MCP 授权后使用设计协作能力
    飞书 CLI用主机上的 lark-cli 操作文档、多维表格、日历和消息
    企业微信 CLI用主机上的 wecom-cli 操作文档、日程和消息
    钉钉 CLI用主机上的 dws 操作通讯录、日程和文档。保存后在连接器设置里用设备码登录
    Agent Mail给专家一个独立邮箱。先装好主机 CLI,再点登录授权

    笔记与知识

    连接器你可以让专家做的事
    腾讯 IMA读写、检索和管理笔记与知识库
    有道云笔记创建、搜索、整理笔记
    Notion搜索、读写页面和数据库
    OpenAlex检索论文和作者
    Obsidian通过主机 CLI 访问本机 Obsidian 库
    语雀(官方 MCP)用个人令牌访问语雀
    WeKnora检索并阅读你自己的 WeKnora 知识库
    RAGFlow列出知识库、检索已解析文档,并阅读返回的片段。填写服务地址和 API Key。不会把文件复制进 Octop 知识库

    出行与地图

    连接器你可以让专家做的事
    飞猪查机票、酒店、景点和行程
    百度地图查地点、路线和天气
    携程问道问酒店、机票和行程
    美团旅游助手问酒店、机票、火车票、景点和行程
    滴滴在开发者控制台拿到个人 MCP Key 后使用滴滴工具

    通讯与效率

    连接器你可以让专家做的事
    个人邮箱用 IMAP/SMTP 连接 QQ 邮箱、网易邮箱、Gmail 等
    滴答清单通过官方 MCP 授权后处理任务

    资讯与娱乐

    连接器你可以让专家做的事
    腾讯新闻搜新闻、订阅热点
    微信读书同步书架和读书笔记
    QQ 音乐搜歌、看排行榜、歌单和听歌报告

    专业工具

    连接器你可以让专家做的事
    元典查法规、案例、企业信息,并做法律幻觉检测
    企查查查企业信息。可以一键授权,也可以填 API Key

    自托管

    连接器你可以让专家做的事
    Dify连接已经发布的 Dify 应用或工作流提供的 MCP Server URL

    带 CLI 的连接器要先在运行 octop run 的那台机器上装好对应命令。页面上可以点安装 CLI,或把命令交给管理员执行。

    内置列表里没有时

    在连接器 → 自定义连接器里登记任意 MCP 服务器。可以用可视化表单,也可以粘贴 JSON:

    {
      "deepwiki": {
        "display_name": "DeepWiki",
        "url": "https://mcp.deepwiki.com/mcp",
        "transport": "streamable_http"
      }
    }
    类型什么时候用
    HTTP Server服务器有一个地址,例如 streamable_http
    Stdio Server服务器是本机上的一个程序,由 Octop 拉起
    说明

    Stdio 程序必须装在运行 octop run 的机器上。HTTP 地址必须从这台机器访问得到。公网 HTTPS 上的自定义 MCP 可以走 OAuth:Octop 从 MCP 地址发现授权服务器(401 / RFC 9728),加密保存令牌,并在加载工具时带上 Authorization: Bearer。授权服务器没有动态客户端注册时,探测会带上 oauth.client_required,你填入预先登记的客户端 ID。客户端密钥可选,保存后不再回显。把 <公网地址>/api/connectors/oauth/callback 登记为回调地址。回环和内网地址不会做远程 OAuth 发现。共享连接器只有创建者能改。

    如果服务端提供了标准的受保护资源元数据,先保存,再点探测。探测提示需要授权时,点一键授权完成登录。非回环地址的 OAuth 回调需要一个公网 HTTPS 的 Octop 地址。

    打开对话默认选中后,你没有手动选择连接器的页面对话、IM 和定时任务会自动带上这个 MCP。关掉后,每一轮需要自己勾选。

    提示

    生态里没有现成服务器时,可以自己搭一个,再用自定义连接器接进来。