> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 连接器：让专家去查你的应用

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


![连接器](/images/ui-connectors.png "连接器")

## 先连一个你每天都在用的


### 打开内置连接器

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

### 点击连接

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

### 授权并探测

按页面提示扫码、一键授权或粘贴密钥，然后点**探测**。探测成功后再保存。令牌保存在本机 `~/.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：

```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。关掉后，每一轮需要自己勾选。


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

