WorkBuddy 的连接器和 MCP 有什么区别？一个是成品一个是接口
想让它读你的邮件、查公司知识库、发群通知——这些需求可能走连接器，也可能走 MCP。第一次配的人经常搞不清该走哪条。
好消息是：两者不是竞争关系，是同一件事的两层。 官方文档里其实把关系说清楚了，只是分散在两页。
本文依据 WorkBuddy 官方文档《连接器》与《MCP》（
Function-Description/下两篇），核对日 2026-08-16。我们没有安装客户端，本文不含实测数据。
一、官方原话里的两条关键句
连接器文档里：
连接器是 WorkBuddy 与外部系统之间的桥梁。它**基于标准化协议（如 MCP）**将外部服务的能力引入到 AI 工作流中。
自定义连接器那一节：
如需接入其他外部服务，可点击连接器管理页面右上角的「自定义连接器」按钮，按照引导配置自定义的 MCP 连接器。 自定义连接器的配置方式与 MCP 配置类似，详细说明可参考 MCP 配置指南。
把这两句合起来读，关系就清楚了：MCP 是协议，连接器是基于这个协议做出来的成品。
打个比方：MCP 相当于插座标准，连接器相当于官方已经配好插头的那几件电器。
二、并列对照
| 连接器 | MCP | |
|---|---|---|
| 本质 | 官方封装好的现成服务对接 | 底层协议（官方比喻：AI 的「USB 接口」） |
| 入口 | 左侧导航栏「连接器」 | 侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」 |
| 怎么配 | 点 + → 授权 → 完成 | 在 mcp.json 里写配置 |
| 要不要碰配置文件 | 不用 | 要（但官方强调已集成到界面，无需编码） |
| 覆盖范围 | 目前五个：QQ 邮箱、腾讯乐享、腾讯文档、TAPD、微云 | 任何支持 MCP 的服务 |
| 有没有分级 | 无 | 有：用户级 / 项目级 |
| 状态显示 | 卡片旁绿色圆点 + 启用/禁用开关 | 🟢 绿灯 / 🔴 红灯 |
三、选择顺序：先看连接器
判断只有一步：你要接的服务，在那五个官方连接器里吗？
- 在 → 走连接器。点
+、授权、完成，不用碰任何配置文件，也不会遇到 JSON 格式、命令环境这些问题。 - 不在 → 走 MCP 或自定义连接器。
这个顺序的理由很实在：连接器的失败面小得多。 MCP 那边官方给的红灯排查方向有三个——配置内容（JSON 格式）、命令环境（uvx 这类命令在不在）、地址；连接器这边基本就是授权成没成功。
四、连接器能做什么
官方给的场景表：
| 场景 | 说明 | 官方示例 |
|---|---|---|
| 数据查询 | 从外部数据源获取信息 | 查询数据库、检索文档 |
| 服务调用 | 调用第三方 API 完成操作 | 发送邮件、创建日程 |
| 文件管理 | 访问云端存储与文件系统 | 读取网盘文件、上传附件 |
| 消息通知 | 与即时通讯工具集成 | 发送企业微信/飞书消息 |
两个官方展开说明了能力的：
- QQ 邮箱：收发、搜索和整理 QQ 邮件；用自然语言读取邮件内容、汇总邮件线程、管理文件夹；
- 腾讯乐享：搜索、创建和管理知识库文档；支持导入 Markdown、按标签整理内容、追踪团队文档的更新动态。
五、MCP 能做什么
官方给的四类核心价值：
| 能力 | 说明 |
|---|---|
| 上下文共享 | 向模型提供文件内容、数据库记录、业务信息等上下文 |
| 工具调用 | 将文件读写、接口调用、消息发送等能力暴露给模型 |
| 可组合工作流 | 多个工具和服务通过 MCP 串联，组成自动化流程 |
| 数据控制 | 支持本地或受控方式运行，兼顾灵活性与安全性 |
想找现成的 MCP Server，官方给了入口：腾讯云 MCP 市场。
六、MCP 独有的一个能力：分级配置
这是连接器没有的。官方支持两个配置级别，配置文件路径不同：
| 级别 | 适用场景 | 路径 |
|---|---|---|
| 用户级 | 配置一次，所有项目复用 | ~/.workbuddy/mcp.json |
| 项目级 | 仅当前项目生效，互不影响 | <项目目录>/.workbuddy/mcp.json |
官方的选择标准：频繁跨项目使用的能力（如企微机器人通知）→ 用户级；仅特定项目需要的专属服务 → 项目级。
这个能力在什么时候有价值：你同时服务几个客户，每个客户有自己的业务系统接口——配成项目级，互不干扰，切换项目时也不会误调用到别人的。
七、两者共同的安全考虑
不管走哪条，本质都是把外部服务的操作能力交给了 AI。有几条通用的：
一、只授予完成任务所需的权限。 这是官方在 Google Calendar 与 Drive 实践里给的建议原话。具体到 QQ 邮箱连接器，官方列了四项权限：账号信息、读取邮件（近一个月）、发送邮件（代为发送）、删除邮件（标注为可选）。用不到的别勾。
二、凭证要保管好。 官方对 MCP 的安全提示：妥善保管 WebHook URL——它是机器人调用凭证，切勿泄露。
三、对外发送类动作要过人。 发邮件、发群通知这类，发出去收不回来。建议让它起草、你过目、再手动发，别放进无人值守的自动化任务里。
四、定期检查。 官方在连接器注意事项里写了：建议定期检查连接器状态，确保服务正常运行。用不到的及时断开——授权是长期挂着的。
五、断开 ≠ 撤销授权。 官方给了 QQ 邮箱的撤销路径：QQ 邮箱 App「设置 - 账号 - 安全管理 - 应用授权」。在 WorkBuddy 里点开关只是这边不用了，彻底解除要两边都做。
八、一条实用的推进路线
如果你是刚开始配：
第一步：先看连接器里有没有现成的（QQ 邮箱、腾讯乐享、腾讯文档、TAPD、微云）
第二步：有就直接授权用，把使用流程摸熟
第三步：确实需要连接器没有的服务，再去配 MCP
第四步：第一个 MCP 挑官方给了完整示范的（企微机器人）
第五步：跑通之后，再接别的
第四步是官方在最佳实践里明说的：从成熟示例起步——先接入 WeCom Bot 等路径清晰的 MCP Server。
九、按需求类型对号入座
把常见需求分一下，看该走哪条：
| 你想做的事 | 走哪条 | 理由 |
|---|---|---|
| 让它读我的 QQ 邮件、整理邮件线程 | 连接器 | 官方现成的，扫码授权即可 |
| 查公司在腾讯乐享上的知识库 | 连接器 | 官方现成的，登录授权即可 |
| 动腾讯文档 / TAPD / 微云 | 连接器 | 都在官方五个之内 |
| 任务完成后往企微群发通知 | MCP | 官方给了完整示范配置 |
| 接公司自建的业务系统 | MCP 或自定义连接器 | 连接器里没有 |
| 接 Google 日历、Google Drive | 连接器相关授权入口 | 官方实践文档里走的是这条 |
| 接某个开源工具 | MCP | 看它支不支持 MCP 协议 |
关于 Google 那一行：官方在实践案例里给的步骤是「进入连接器或相关授权入口 → 选择 Google Calendar 或 Google Drive → 按页面提示完成账号授权」。官方在使用建议里还给了一条很实在的：授权时只授予完成任务所需的权限。
十、两条都要注意的成本问题
连接器和 MCP 本身不直接消耗积分，但它们让 AI 能做的事变多了——而任务本身是消耗积分的。
两个实际影响：
一、能力多了，任务容易变复杂。 接了一堆服务之后，很容易写出「查日历、找资料、生成议程、发通知」这种复合指令。官方对复合任务的态度很明确：减少一次性过长过大的复合任务，拆分成多个独立任务。
二、无人值守的自动化要特别小心。 自动任务配上了对外发送能力（发邮件、发群通知），一旦提示词有问题，错误会被重复执行且没人当场发现。这类能力别放进无人值守的流程里。
小结
- 关系：MCP 是协议，连接器是基于这个协议做出来的成品。官方明确写了连接器基于标准化协议（如 MCP）实现，自定义连接器的配置方式也与 MCP 配置类似。
- 判断一步走：你要接的服务在那五个官方连接器里吗？ 在就走连接器，不在走 MCP。
- 入口不同：连接器在左侧导航栏；MCP 在侧边栏「插件」→ 右上角「MCP 服务器」。
- 连接器失败面小得多——MCP 有 JSON 格式、命令环境、地址三类失败方向。
- MCP 独有分级配置：用户级
~/.workbuddy/mcp.json/ 项目级<项目目录>/.workbuddy/mcp.json。 - 通用安全：只授予必需权限、凭证别泄露、对外发送要过人、定期检查并断开不用的、断开 ≠ 撤销授权。
功能与文档表述以官方为准，核对日 2026-08-16。