MCP 服务器配置

MCP 是什么

MCP（Model Context Protocol）是 AI 调用外部工具和数据源的标准接口。

配好之后，WorkBuddy 能直接操作浏览器、读写在线文档、查数据库、调用第三方服务——不用你手动复制粘贴数据。

配置文件位置

~/.workbuddy/mcp.json

⚠️ 注意不是 ~/.workbuddy/.mcp.json（带点的那个）。文件名错了不报错，就是不生效，能卡你半小时。

配置格式

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    },
    "my-service": {
      "command": "node",
      "args": ["/path/to/server.js"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

也支持远程服务（用 url + headers 而不是 command）。

配置四步法

第一步：查官方文档拿准确配置 别凭印象写。每个 MCP 服务的 README / 文档里都有标准配置片段，command、args、env、headers 这些字段不同服务差别很大，猜出来的基本跑不通。

第二步：读现有文件 如果 mcp.json 已存在，先读出来，把新服务合并进 mcpServers，不要整个覆盖——会把之前配好的服务冲掉。

第三步：写入配置 需要凭据的服务，按文档要求写进 env 或 headers。

第四步：手动启用（最关键） 写完配置不会自动生效。需要打开连接器管理页面，在右上角的自定义连接器入口里，对新加的服务点「信任」。

这一步经常被人忘掉，然后到处找“为什么 MCP 配了没反应”。

三个高频坑

坑一：字段瞎猜 不同服务的字段不通用。A 服务用 command，B 服务可能只支持 url。永远以官方文档为准。

坑二：不要手动运行 MCP 服务器 配好就行，WorkBuddy 会自己拉起进程。你手动跑反而会端口冲突。

坑三：连不上就别死磕 某些 MCP 服务报“Not connected”且反复重试无效时，换本地方案更快。比如浏览器自动化，MCP 版不稳定时，直接用本地 Playwright 驱动 + 指定本机 Chromium 路径，反而更稳。

验证是否生效

配完问一句：

你现在能用到哪些 MCP 工具？

它应该能列出新服务的工具。列不出来，按上面的四步逐项排查：文件名对不对 → JSON 格式对不对 → 有没有点信任 → 命令路径对不对。

安全提醒

MCP 服务拿到的是你本机的一部分能力（读文件、执行命令、访问网络）。只装你信任来源的服务，装之前看一眼它到底要干什么。

下一篇

自动化与定时任务——让它每天自己干活。