一、什么是 MCP
MCP（Model Context Protocol，模型上下文协议）是一套让 AI 工具连接外部服务、调用其工具的标准协议。配置好一个 MCP 服务后，你就可以在对话中直接让 AI 去操作网站、数据库、邮箱等系统。
二、准备工作
添加 MCP 服务前，需要从服务提供方拿到三样信息：
- 服务地址（URL）：MCP Server 的 HTTP 端点，通常以 /mcp 结尾，例如 https://你的域名/wp-json/gqapi/v1/mcp。
- 传输类型：主流为 Streamable HTTP（也可称 HTTP MCP / Remote MCP）。
- 鉴权方式：多数需要 Bearer Token 或自定义请求头。
三、方法一：图形界面添加（推荐）
- 打开左侧「连接器」面板，进入「更多连接器」→「自定义连接器」。
- 点击「配置 MCP」，把配置 JSON 粘贴进去并保存。
- 回到连接器列表，找到刚添加的服务，点击「信任 / 启动」开关。
四、方法二：直接编辑配置文件
用编辑器打开 ~/.workbuddy/mcp.json（不存在就新建），在 mcpServers 下新增一项（注：标准 JSON 请使用双引号，下方示例为便于阅读使用单引号）：
{ 'mcpServers': { 'my-server': { 'url': 'https://你的域名/wp-json/gqapi/v1/mcp', 'headers': { 'Authorization': 'Bearer 你的令牌' }, 'disabled': false } }}注意：用了 url 就不要写 command/args（两者互斥）；保存后重启 WorkBuddy 生效。
五、鉴权方式详解（常见坑）
很多 MCP 服务（尤其是基于 WordPress 的）要求的是 应用程序密码（Application Password），而不是后台登录密码：
- 令牌格式通常是 BASE64(用户名:应用程序密码)，注意应用程序密码保留空格。
- 把编码结果放在 Authorization: Bearer
请求头中。 - 用登录密码编码往往会被服务端拒绝（返回 401）。
六、启用与验证
- 重启 WorkBuddy 让配置加载。
- 在连接器面板点击「信任 / 启动」，状态变绿即连接成功。
- 直接下发任务测试，例如：列出支持的内容类型。
七、实战：添加 guaqi 内容 MCP
以本文用到的 guaqi 内容 MCP 为例，mcp.json 配置如下：
{ 'mcpServers': { 'guaqi': { 'url': 'https://你的域名/wp-json/gqapi/v1/mcp', 'headers': { 'Authorization': 'Bearer <BASE64(用户名:应用程序密码)>' }, 'disabled': false } }}连接成功后，即可在对话中让 AI 帮你创建文章、商品、社区帖子等草稿，甚至做多语言翻译与发布。
八、常见问题排查
- 一直 401：检查令牌是否用对了应用程序密码而非登录密码；确认请求头名称与大小写。
- 面板里看不到独立方块：自定义 MCP 会被聚合进 connector-proxy，工具以 mcp__服务名__* 形式提供给 AI，属正常。
- 工具没加载：改完配置后需重启 WorkBuddy 或重开连接器开关。
