WorkBuddy 连接文泊 MCP 教程

1. 准备插件和独立密钥

1. 下载安装文泊插件，登录文泊与目标平台，并保持浏览器在线。
2. 在控制台创建独立 MCP 密钥，命名为 WorkBuddy 以便分别管理。
3. 将密钥保存在客户端的本机凭证或 WENBO_MCP_KEY 环境变量中；不要发到 AI 对话。

2. 添加远程 MCP 配置

服务地址为 https://mcp.wenbodesk.com/mcp；mcp-key 是认证请求头。

使用支持用户自填 Token 的自定义连接器。现有接入指南要求 WorkBuddy 4.23.0 或更新版本，并在连接器元信息设置 auth_mode: token 与凭证表单，将 Token 注入 mcp-key。

{
  "mcpServers": {
    "wenbo": {
      "type": "streamableHttp",
      "url": "https://mcp.wenbodesk.com/mcp",
      "headers": {
        "mcp-key": "${WENBO_MCP_KEY}"
      }
    }
  }
}

此处是配置示例；真实密钥只填入本机凭证表单，然后保存并启用连接器。仅复制服务 URL 无法完成认证。

WorkBuddy 官方配置文档

3. 先验证只读连接

请调用文泊 get_workspace，只读取浏览器、插件版本、平台账号和 submissionModes；不要创建、同步或发布内容。

返回当前浏览器、版本和平台账号后，再检查 submissionModes 是否包含 draft_sync。多个浏览器在线时先选定一个，后续请求保持同一 deviceId。

4. 明确请求草稿同步

先读取工作台能力。仅对声明支持 draft_sync 的平台，以 submissionMode: draft_sync 同步我明确指定的内容；禁止直接发布。完成后列出 fieldResults、missingFields 和草稿保存确认状态，不要把任务创建或部分字段成功称为保存成功。

草稿已确认保存不代表已发布。只有 draft_synced 且 draftPersistence.state=confirmed 才能称为保存确认；缺失字段仍需作者补齐。不支持草稿同步的平台或形式会明确提示不可用，不进行页面填写、直接发布或失败降级。

常见问题与排障

• 401：检查密钥、mcp-key 请求头和环境变量是否被客户端读取。
• 找不到浏览器：保持插件在线，核对网站、插件和客户端所用文泊账号。
• 未声明 draft_sync：先升级或核对插件能力，不要改为自动发布来绕过。

其他客户端与工具参考