WorkBuddy 怎么加第一个 MCP？官方拿企微机器人做了完整示范

2026-08-16

MCP 这个词听着技术，但官方把它做成了可视化配置——文档里有一句话值得先看：

WorkBuddy 已将 MCP 配置集成到界面中，无需编码、无需手动改配置文件，可视化操作即可完成接入。

官方给的第一个练手对象是企业微信群机器人，路径清晰、验证直观。这篇按官方的四步走一遍。

本文依据 WorkBuddy 官方文档《MCP》（Function-Description/MCP-Guide），核对日 2026-08-16。企业微信侧规则以企业微信官方为准。我们没有安装客户端，本文不含实测数据。

一、先搞清楚 MCP 是什么

官方给的比方很形象：

MCP 可以理解为 AI 的「USB 接口」——就像电脑通过 USB 连接外设一样，MCP 让 AI 连接各种外部工具和数据源。

全称是 Model Context Protocol（模型上下文协议），用于把外部工具和服务接入 WorkBuddy，让 AI 获得发送通知、连接业务系统、访问数据源等扩展能力。

官方列的四类核心价值：

能力	说明
上下文共享	向模型提供文件内容、数据库记录、业务信息等上下文
工具调用	将文件读写、接口调用、消息发送等能力暴露给模型
可组合工作流	多个工具和服务通过 MCP 串联，组成自动化流程
数据控制	支持本地或受控方式运行，兼顾灵活性与安全性

二、Step 1：获取 WebHook URL

在企业微信群中：添加群机器人 → 获取 WebHook URL。

官方给的地址格式示例：

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

这个地址就是凭证。官方在安全提示里专门写了：妥善保管 WebHook URL——它是机器人调用凭证，切勿泄露。

拿到之后建议存进密码管理器，别放聊天记录或临时记事本。

三、Step 2：找到 MCP 配置入口

官方给的路径：

进入侧边栏「插件」→ 点击右上角「MCP 服务器」→「配置 MCP」

这个入口有点深，第一次找的人容易在「设置」里绕。记住是「插件」，不是「设置」。

四、Step 3：填 mcp.json

官方给了一段可以直接改的配置：

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

把 your-webhook-url 替换成你实际的地址，保存。

两个容易出错的地方：

一、JSON 格式。 官方安全提示里有一条：检查 JSON 格式——配置失败时优先确认括号、引号是否完整。 手改 JSON 最常见的错误就是少个逗号、多个引号。粘贴前后各看一眼括号是否配对。

二、替换的时候把引号弄丢。 "WECOM_WEBHOOK_URL": "你的地址" ——地址两边的双引号要留着。

还有一个选择要顺带做：配到哪一级。官方支持两个配置级别：

级别	适用场景	配置文件路径
用户级	配置一次，所有项目复用	`~/.workbuddy/mcp.json`
项目级	仅当前项目生效，互不影响	`<项目目录>/.workbuddy/mcp.json`

官方的建议是：频繁跨项目使用的能力（如企微机器人通知）→ 用户级；仅特定项目需要的专属服务 → 项目级。

所以这个练手例子，配用户级就对了。

五、Step 4：看状态灯

保存后在界面中查看 MCP Server 状态：

状态	含义
🟢 绿色	连接成功，可正常使用
🔴 红色	配置异常，需检查配置内容、命令环境或地址

红灯的三个方向官方直接给了：

配置内容——JSON 格式对不对（优先查这个）；
命令环境——配置里那个 uvx 命令，你的机器上有没有；
地址——WebHook URL 是不是完整正确的，有没有带进多余空格。

官方在安全提示里也复述了这条：关注状态指示灯——绿色可用，红色需排查。

六、配好之后怎么用

官方说明：配置完成后，用自然语言描述需求即可，WorkBuddy 会自动调用对应的 MCP Server。

官方给的示例指令：

请通过企业微信机器人通知：正式产品已发布，请 @xxxx 进行验收。

不需要写任何命令或代码——这就是「已将 MCP 配置集成到界面中」的实际效果。

官方在最佳实践里对指令有个建议：描述尽量明确——说清通知对象、内容、是否需要 @，调用效果更稳定。

这跟官方讲指令写法时的三要素公式是一回事：做什么 + 有什么 + 怎么样，别让 AI 猜你的意图。

七、能用来做什么

官方列的四类适用场景：

场景	说明
发布通知	版本上线后自动通知项目群相关人员
任务提醒	将待办、验收、协作事项同步到企微群
流程打通	连接 WorkBuddy 任务处理与外部平台
能力扩展	通过更多 MCP Server 调用丰富的外部服务

想找更多现成的：官方提供了腾讯云 MCP 市场这个入口。

八、官方给的四条最佳实践

照录，都挺实在：

公共能力配用户级：通知类能力配置一次，多项目复用；
专属接入配项目级：独立配置，避免互相影响；
从成熟示例起步：先接入 WeCom Bot 等路径清晰的 MCP Server；
描述尽量明确：说清通知对象、内容、是否需要 @。

第三条正是本文这个例子存在的意义——第一个 MCP 别挑冷门的，先用官方给了完整示范的这个跑通，把整条链路摸清楚，再去接别的。

九、跟连接器怎么分工

顺带说清楚：官方在连接器文档里写明，连接器基于标准化协议（如 MCP）将外部服务能力引入 AI 工作流；自定义连接器那一节也说明配置方式与 MCP 配置类似。

分工很简单：

连接器是官方封装好的现成服务，目前支持 QQ 邮箱、腾讯乐享、腾讯文档、TAPD、微云——点一下授权就能用；
MCP 是底层协议，可以接任何支持 MCP 的服务。

能用连接器解决的走连接器，连接器里没有的走 MCP。

十、跑通之后，第二个 MCP 该怎么挑

第一个跑通了，接下来就有得选了。给一套推进顺序：

第二个：挑跟第一个同类的。 比如你第一个配了企微机器人通知，第二个可以配飞书或钉钉的通知——同类的东西配置结构相似，你已经摸清的经验能直接复用，遇到问题也知道往哪查。

第三个开始：按你的真实痛点挑。 别为了「多接几个」而接。每个 MCP Server 都是一个长期挂着的外部连接，接得越多，你要维护和检查的面越大。

挑之前先问三个问题：

这个能力我一周会用几次？ 一个月才用一次的，手动做可能更省事。
有没有现成的连接器能替代？ 官方连接器目前有 QQ 邮箱、腾讯乐享、腾讯文档、TAPD、微云五个，点一下授权就能用，比配 JSON 省事得多。
它要什么凭证，凭证泄露的后果多大？ 一个只读的数据查询接口，和一个能对外发消息的接口，风险不是一个量级。

关于第三条，有个实用的分级习惯：只读类的能力可以配用户级（全局复用），带写入或对外发送能力的，优先配项目级——缩小暴露面。用不到的时候，从配置里删掉比留着强。

十一、配完之后的两个习惯

一、隔一阵看一眼状态灯。 MCP Server 依赖外部服务和本地命令环境，这两样都可能变——服务改了接口、你更新了系统、凭证过期了。官方在连接器那边给的建议是「定期检查连接器状态，确保服务正常运行」，MCP 同理。

二、备份你的 mcp.json。 知道路径的用处就在这儿：换电脑、重装系统的时候，把 ~/.workbuddy/mcp.json 拷过去比重新配一遍快得多。

但备份之前先想一件事：这个文件里有凭证。别把它扔进公共的云盘同步目录，也别提交到代码仓库。

小结

官方比方：MCP 是 AI 的「USB 接口」；官方强调无需编码、可视化操作即可接入。
四步：企微群里拿 WebHook URL → 侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」 → 粘 mcp.json 并替换地址 → 看状态灯。
入口在「插件」不是「设置」。
配置级别选用户级 ~/.workbuddy/mcp.json（通知类能力跨项目复用）。
红灯三方向：配置内容（先查 JSON 括号引号）、命令环境（uvx 有没有）、地址。
配好之后用自然语言说就行，官方示例：请通过企业微信机器人通知……
WebHook URL 是调用凭证，切勿泄露。
官方建议从成熟示例起步——第一个 MCP 就用这个企微机器人。

功能与流程以官方为准，核对日 2026-08-16。