概述
WorkBuddy的连接器功能，底层就是MCP（Model Context Protocol，模型上下文协议）。
两种使用方式
| 方式 | 说明 | 适合谁 |
|---|---|---|
| 平台预置连接器 | WorkBuddy内置的常用服务（腾讯文档、乐享知识库等） | 新手，一步授权就能用 |
| 自定义MCP Server | 通过配置文件添加自己的MCP服务 | 有特定需求的进阶用户 |
实操：配置一个MCP Server（以Playwright为例）
第一步：确认前置条件
| 项目 | 要求 | 检查方法 |
|---|---|---|
| WorkBuddy版本 | 5.3及以上 | 设置→关于，查看版本号 |
| Node.js | 18及以上 | 终端执行 node -v |
| npm源 | 国内建议配置镜像 | npm config get registry |
Node.js 是必须的，因为大多数社区MCP服务器都是Node包，WorkBuddy通过npx拉起子进程来运行它们。
第二步：找到配置文件
MCP配置文件放在用户目录下：
- Windows:
C:\Users\<用户名>\.workbuddy\mcp.json - macOS:
~/.workbuddy/mcp.json - Linux:
~/.workbuddy/mcp.json
注意：是 mcp.json，不是 .mcp.json。少一个点，路径就完全不同了。
第三步：写入配置
用任意编辑器打开 mcp.json，把目标MCP Server加进 mcpServers 字段：
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
已有配置要合并，不要覆盖。如果你的 mcp.json 里已经有别的服务器，只需把新条目加进 mcpServers 对象里。
第四步：信任并启用
回到 WorkBuddy，进入"连接器管理"页面，找到刚写入的MCP Server，点击"信任"，然后重启当前会话或新开会话，MCP工具即被注入。
MCP vs Skill：有什么区别
| 对比维度 | Skill | MCP Server |
|---|---|---|
| 本质 | AI能力封装（提示词+流程） | 工具调用协议 |
| 安装方式 | SkillHub或对话安装 | 配置文件或连接器配置 |
| 典型用途 | 数据处理、内容生成 | 操作浏览器、连数据库、调API |
Skill 是"知道怎么做"，MCP 是"有工具可用"。两者搭配使用效果最好。
常见MCP Server推荐
- Playwright — 浏览器自动化，适合网页数据采集、自动化测试
- GitHub — 代码仓库操作，支持PR管理、Issue跟踪
- FileSystem — 本地文件操作（谨慎使用，建议只开放工作目录）
- PostgreSQL/MySQL — 数据库连接，直接查询分析
- Slack/Discord — 消息平台集成，自动推送通知
注意事项
- MCP Server 的版本可能与 WorkBuddy 客户端不兼容，连接失败时首先检查版本
- 涉及敏感权限（文件系统、生产数据库）的 Server，遵循最小权限原则
- 建议使用只读权限先行测试，确认正常后再开放写权限
- 凭证管理要用专门的服务账号，不要用人账号的长期 Token