Connectors 与 MCP：把外部系统接进 WorkBuddy

"让 AI 帮我整理客户名单"——结果它打开的是你三个月前清空过的旧 Excel。真正卡人的不是 AI 笨，是数据根本不在它够得着的地方：名单在腾讯文档里，会议纪要在 QQ 邮箱收件箱，项目进度在 TAPD 上，AI 站在玻璃外面看，你站在玻璃里面手动搬。

WorkBuddy 本体能直接操作本地文件，但要让 AI 真上手业务系统，靠的是两样东西：连接器（Connector）和 MCP（Model Context Protocol）。

先分清连接器、MCP、Skill 三者 #

三者都号称"扩展能力"，但入口和形态完全不同，先分清楚再动手，能省掉一半返工：

官方对连接器的定义是：把外部数据与能力引入 AI 工作流，在获得授权后访问和操作第三方服务。实现形态一种是基于 MCP + CLI 的标准化协议，另一种是 Skill + CLI 的内置脚本，两者在数据收集与权限边界上遵循一致原则。

什么时候才真的需要接外部系统 #

出现下面这些信号就该考虑接入。别为了"显得高级"硬接，多一层授权就多一层风险：

• 任务要求读写的是线上文档或表格，而不是本地文件
• 需要拿外部数据源（行情、企业工商信息等）做分析
• 需要做对外动作：发消息、建日程、代发邮件、建工单
• 同一件事每周至少耗一小时在"打开 A、复制、粘到 B"上

本地几个文件就别硬接，老实选工作空间，多一层授权就多一层风险。

连接器怎么接：三步走 #

官方路径：左侧边栏点专家·技能·连接器 → 切到连接器页签 → 找到卡片右上方的加号 → 按提示完成登录授权。授权成功后卡片名称旁出现绿色圆点，表示已连接，右侧出现「去对话」。

实际用起来有三种方式，挑顺手的一种就行：

• 连接器页直接发起对话：已授权的连接器卡片点「去对话」，直接开干。
• 建任务时挂上：新建任务，点输入框左下角的加号，选连接器，弹窗里打开需要的那个。
• 跑任务时补挂：任务执行中若用到没连过的连接器，输入框上方自动弹出连接引导卡片，授权完 WorkBuddy 会接着跑当前任务，不用重开对话。

后两条对批量交付特别友好。客户临时要一份邮件汇总，你不用中断手上的活重开一轮。

MCP 怎么接：先挑对级别 #

MCP 官方的说法是"AI 的 USB 接口"。现在 WorkBuddy 已经把 MCP 配置集成进界面了，无需编码、无需手动改配置文件，可视化操作即可完成接入。入口在侧边栏插件 → 右上角MCP 服务器 → 配置 MCP。

配置分两个级别，选错会出现"在 A 项目配好了，B 项目死活调不动"：

判断标准很简单：跨项目都要用的通知类能力放用户级；某个客户项目专属的查询接口放项目级。

以企业微信机器人为例，四步走：群里添加群机器人拿到 WebHook URL → 侧边栏插件打开 MCP 配置入口 → 把下面这段填进编辑器，换掉占位地址后保存 → 看状态灯。

{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

配好之后用自然语言下指令就行，不用记工具名："请通过企业微信机器人通知：正式产品已发布，请 @张三 进行验收。"

状态灯与常见红灯原因 #

保存后看 MCP Server 状态指示灯：

• 绿色：连接成功，可正常使用
• 红色：配置异常，要检查配置内容、命令环境或地址

企业内网里最常见的红灯原因：WebHook URL 复制丢了末尾字符；那台机器缺运行环境依赖；出口防火墙拦了域名。第一种占我经手案例的绝大多数，肉眼比对一遍通常就解决。

积分怎么算、边界在哪 #

两条要记牢：

• 连接器自身的读写不消耗积分；只有 WorkBuddy 对外部数据进行理解、汇总时才计积分。读一百封邮件不扣，"把一百封邮件归纳成三页摘要"才扣。批量交付前心里得有这根弦。
• 边界官方写得很清楚：每个连接器独立授权、不主动定时抓取、不超出你已有权限范围。API 密钥与 Token 是访问你第三方账号的钥匙，别在公共设备上填，不用了及时解绑。

十八年运维踩过的坑 #

• 别给每个员工开全量授权。 财务只开腾讯文档，行政只开会议，最小权限够用。
• 内网老机器先跑通再铺开。 我公司有台 Win10 老台式机，第一次配企微 MCP 直接红灯，补了运行环境才转绿。现场部署务必当着客户面把状态灯变绿再签验收单。
• 对外发送前人眼看一遍。 连接器发出的消息以你本人身份执行，发错群就是事故。

小结 #

本地文件 + 连接器 + MCP，等于把所有数据搬进了 AI 的工位，而不是让它隔着玻璃跟你聊天。这是进阶用户和普通用户的分水岭。

相关阅读 #

• /tutorials/mcp-server
• /tutorials/wework-assistant-guide
• /tutorials/permission-and-sandbox