Codex 连接文泊 MCP 教程

1. 准备插件和独立密钥

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

2. 添加远程 MCP 配置

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

在用户级 ~/.codex/config.toml 添加以下配置。桌面端启动进程必须能读取环境变量，已有配置请修改同名服务。

[mcp_servers.wenbo]
url = "https://mcp.wenbodesk.com/mcp"
env_http_headers = { "mcp-key" = "WENBO_MCP_KEY" }

重新打开 Codex 后，用 codex mcp list 查看服务是否已添加。

Codex 官方配置文档

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：先升级或核对插件能力，不要改为自动发布来绕过。

其他客户端与工具参考