MCP 是什么，如何接入企业微信机器人

MCP（Model Context Protocol，模型上下文协议）用于将外部工具和服务接入 WorkBuddy，让 AI 获得发送通知、连接业务系统、访问数据源等扩展能力。官方把它比作 AI 的"USB 接口"——电脑通过 USB 连外设，AI 通过 MCP 连外部工具和数据源。

核心价值

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

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

MCP 市场

WorkBuddy 提供现成的 MCP 资源入口，也可以到腾讯云 MCP 市场获取更多开放生态能力。

两种配置级别

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

选择原则：频繁跨项目使用的能力（如企微机器人通知）→ 用户级；仅特定项目需要的专属服务 → 项目级。

快速上手：接入企业微信机器人

1. 获取 WebHook URL

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

添加企微群机器人获取 WebHook — 在企业微信群添加机器人并获取 WebHook 地址

2. 打开 MCP 配置入口

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

3. 填写 mcp.json

将以下配置粘贴到编辑器，替换 WebHook 地址后保存：

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

4. 确认配置状态

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

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

使用方式

配置完成后，用自然语言描述需求即可，WorkBuddy 会自动调用对应的 MCP Server。官方示例指令：「请通过企业微信机器人通知：正式产品已发布，请 @某某进行验收。」

适用场景与最佳实践

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

配置建议：公共能力配用户级、专属接入配项目级、从路径清晰的成熟示例起步、描述尽量明确（说清通知对象、内容、是否需要 @）。

安全提醒：妥善保管 WebHook URL（它是机器人调用凭证，切勿泄露）；配置失败时优先检查 JSON 括号与引号是否完整；关注状态指示灯，绿色可用、红色需排查。

MCP 服务加载时对话流会显示连接进度（已连接数 / 服务总数），加载完成后进度提示自动消失，详见对话与追问。