### [使用 WorkBuddy 配置 MCP 服务的完整教程](https://youshipu.cn/article/47)

**Published:** 2026-08-10T09:33:47

**Author:** 优势铺

**Excerpt:** 一、什么是 MCP MCP（Model Context Protocol，模型上下文协议）是一套让 AI 工具…

## 一、什么是 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 或自定义请求头。

## 三、方法一：图形界面添加（推荐）

1.  打开左侧「连接器」面板，进入「更多连接器」→「自定义连接器」。
2.  点击「配置 MCP」，把配置 JSON 粘贴进去并保存。
3.  回到连接器列表，找到刚添加的服务，点击「信任 / 启动」开关。

## 四、方法二：直接编辑配置文件

用编辑器打开 ~/.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）。

## 六、启用与验证

1.  重启 WorkBuddy 让配置加载。
2.  在连接器面板点击「信任 / 启动」，状态变绿即连接成功。
3.  直接下发任务测试，例如：列出支持的内容类型。

## 七、实战：添加 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 或重开连接器开关。

**Categories:** 教程

---