1. 为什么我决定把 WorkBuddy 和公众号草稿箱打通做公众号的朋友大概都有这种体验选题想好了素材也攒了一堆但真正坐下来排版、配图、调格式、传封面一套流程走完一两个小时就没了。写稿本身可能只占三分之一时间剩下全耗在机械操作上。我身边好几个做垂直号的运营者一周更三篇就已经累得够呛更别说稳定日更。WorkBuddy 接入公众号这件事本质上解决的就是「从选题到草稿箱」这段重复劳动。它的核心链路是你在 WorkBuddy 里用一句话描述选题和风格它调用大模型生成文章内容再通过 MCPModel Context Protocol服务把内容、封面、排版一起推到公众号草稿箱。你只需要最后登录后台预览、点发布。整个过程如果配置顺利20 分钟内能跑通第一次。这里的关键角色是wechat_oa_api_mcp一个开源的微信公众号 MCP 服务。它把微信公众平台的素材接口、草稿接口封装成 WorkBuddy 能识别的工具让 AI 可以直接调用「创建草稿」「上传封面」这些动作。AppID 和 AppSecret 则是公众号开发者权限的凭证填在 MCP 服务的配置文件里全程本地运行内容不经过第三方服务器。适合谁认证订阅号或服务号的运营者有开发者权限愿意花 20 分钟做一次性配置。个人订阅号如果没有开发者接口这条路走不通得先完成认证。下面我按实际操作的顺序把每一步拆开讲清楚包括配置片段、验证动作和踩过的坑。2. 前置准备WorkBuddy、公众号开发者权限与 wechat_oa_api_mcp 环境在动手配置之前先把几样东西确认好不然后面容易卡住。我列一个检查清单你可以逐项对照。第一项WorkBuddy 已经安装并能正常对话。打开 WorkBuddy随便说句话看有没有回复。这一步看似废话但很多人卡在「以为装好了其实没登录」或者「模型没选对」。确认能正常对话再往下走。第二项微信公众号有开发者权限。登录 mp.weixin.qq.com左侧菜单能看到「开发」选项说明你有权限。认证订阅号和服务号一般都有个人未认证订阅号没有。如果你看不到「开发」先去微信公众平台申请认证。这是硬门槛绕不过去。第三项一个代码编辑器。VS Code、PyCharm、Cursor 任选能打开文件夹、能编辑.env文件就行。我习惯用 VS Code轻量改配置方便。第四项明确的内容定位。你写什么赛道、什么风格这直接影响 AI 生成文章的方向。比如你做职场干货提示词里就要强调「案例方法论」你做情感号就要强调「故事感共鸣」。先想清楚后面写提示词会顺很多。第五项Python 环境。wechat_oa_api_mcp是 Python 项目需要 Python 3.9 以上。终端里执行python --version确认一下。如果没有去 python.org 装一个安装时勾选「Add to PATH」。第六项公网 IP 可查。微信公众平台的 IP 白名单需要填你的公网 IP。Windows 用 PowerShell 执行curl ifconfig.meMac 或 Linux 终端执行同样命令会返回一串 IP。记下来后面要用。这六项准备好就可以进入正式配置了。整个过程我建议按顺序来先拿 AppID 和 AppSecret再装 MCP 服务再配白名单最后验证。顺序乱了容易反复改配置。3. 可复制配置AppID/AppSecret 填写位置与 wechat_oa_api_mcp 的 MCP 服务片段这一步是核心配置写对了后面基本一路顺。先拿凭证再写配置。3.1 获取 AppID 和 AppSecret登录微信开发者平台 developers.weixin.qq.com/platform左上角进入「我的业务与服务」→「公众号」→「开发密钥」。第一次使用点「激活」生成密钥。AppSecret 只显示一次立刻复制保存关掉页面就再也看不到了。记下两样东西AppID 是wx开头的一串字符AppSecret 是一长串十六进制字符。3.2 安装 wechat_oa_api_mcp直接在 WorkBuddy 里说「帮我安装 wechat_oa_api_mcp它是一个微信公众号 MCP 服务」。WorkBuddy 会自动 clone 项目并安装依赖。如果你想手动来也可以git clone https://github.com/你的仓库/wechat_oa_api_mcp.git cd wechat_oa_api_mcp pip install -r requirements.txt3.3 填写 AppID 和 AppSecret用代码编辑器打开项目文件夹找到.env文件没有就从.env.example复制一份。填入配置# .env 文件示例 WECHAT_APP_IDwx1234567890abcdef WECHAT_APP_SECRETabcdef1234567890abcdef1234567890 WECHAT_API_BASEhttps://api.weixin.qq.com MCP_SERVER_PORT8000注意WECHAT_APP_ID和WECHAT_APP_SECRET必须和公众平台里的一字不差前后不要有空格。我见过有人复制时带了个换行结果一直报invalid appid。3.4 MCP 服务配置片段WorkBuddy 通过 MCP 协议连接外部服务需要在 WorkBuddy 的 MCP 配置里注册这个服务。配置文件通常是mcp_settings.json或settings.json路径在 WorkBuddy 的配置目录下。片段如下{ mcpServers: { wechat_oa_api_mcp: { command: python, args: [main.py], cwd: /你的路径/wechat_oa_api_mcp, env: { WECHAT_APP_ID: wx1234567890abcdef, WECHAT_APP_SECRET: abcdef1234567890abcdef1234567890 } } } }如果你用的是 TOML 格式的配置部分版本 WorkBuddy 支持等价写法[mcpServers.wechat_oa_api_mcp] command python args [main.py] cwd /你的路径/wechat_oa_api_mcp [mcpServers.wechat_oa_api_mcp.env] WECHAT_APP_ID wx1234567890abcdef WECHAT_APP_SECRET abcdef1234567890abcdef1234567890这里三件套要写全Base URL 用微信官方https://api.weixin.qq.comKey 就是 AppID 和 AppSecretModel ID 在 MCP 场景下对应服务名wechat_oa_api_mcp。缺一个都连不上。3.5 启动服务在项目目录终端执行python main.py启动成功后访问localhost:8000/docs查看 Swagger 文档能看到接口列表说明服务起来了。MCP 服务需要保持运行建议用nohup或系统服务后台常驻nohup python main.py mcp.log 21 3.6 配置 IP 白名单微信公众平台 → 设置与开发 → 安全中心 → IP 白名单 → 添加你的公网 IP 并保存。动态 IP 用户要注意家庭宽带 IP 会变变了就要重新加否则报errcode: 40164。4. 验证请求一次手动触发确认草稿箱链路跑通配置写完别急着写正式文章先做一次最小验证。这一步能帮你快速定位是配置问题还是内容问题。4.1 连通性测试在 WorkBuddy 里输入「帮我测试一下微信公众号接入是否正常」。WorkBuddy 会调用 MCP 服务的测试接口返回 access_token 获取结果。如果返回access_token和一串字符说明 AppID、AppSecret、IP 白名单都对了。如果这一步报错先看错误码。40164是 IP 不在白名单40013是 AppID 无效40125是 AppSecret 无效。对照着改别瞎猜。4.2 手动触发一次草稿创建测试通过后用一句最简单的提示词触发完整链路请根据以下选题写一篇公众号文章用 HTML 格式排版字数 800 左右。 标题用 h1 标签正文用 p小标题用 h2。 完成后直接创建草稿到我的公众号草稿箱。 选题如何用 20 分钟搭建一个自动化写作流程WorkBuddy 会依次做几件事生成文章内容、调用 MCP 上传封面图如果没有现成封面会生成一张或让你指定、调用草稿接口创建草稿。整个过程在对话里能看到工具调用记录。4.3 检查草稿箱登录公众号后台 → 草稿箱应该能看到刚创建的文章。点预览检查排版是否正常、图片是否显示、标题层级对不对。如果显示乱码直接在 WorkBuddy 里说「草稿箱里的文章显示乱码帮我排查并修复」它会检查 HTML 编码和接口返回。4.4 成功结果长什么样一次成功的验证你会看到WorkBuddy 对话里显示create_draft工具调用成功返回media_id公众号后台草稿箱出现新文章预览页排版正常封面图显示。到这一步链路就通了。我实测下来第一次配置到验证通过大概 15 到 20 分钟。主要时间花在找配置文件和改 IP 白名单上。配置一次之后后面写稿就是一句话的事。5. 常见报错排查40164、local proxy failed、reading choices 与 OAuth 问题配置过程中最容易卡在几个报错上我按实际遇到的频率排一下每个给出排查路径。5.1 errcode: 40164这是 IP 白名单问题。微信返回invalid ip xxx, not in whitelist。解决重新执行curl ifconfig.me拿到当前公网 IP去公众平台安全中心更新白名单。动态 IP 用户建议每次写稿前确认一下 IP或者用固定 IP 的服务器跑 MCP 服务。5.2 local proxy failed这个报错通常出现在 MCP 服务启动阶段WorkBuddy 连不上本地服务。排查三步第一确认python main.py还在运行终端没关第二确认端口 8000 没被占用lsof -i:8000看一下第三确认 MCP 配置里的cwd路径是对的路径错了服务起不来。如果用了虚拟环境command要指向虚拟环境里的 python。5.3 reading choices 相关报错这个一般是大模型返回格式和 MCP 工具期望的格式不匹配。WorkBuddy 在解析模型输出时如果模型返回的不是标准 JSON 或 HTML就会报reading choices之类的解析错误。解决在提示词里明确要求「用 HTML 格式输出不要用 Markdown」并且指定标签。如果还不行检查 MCP 服务的版本老版本对输出格式容错差升级到最新。5.4 OAuth 相关报错如果你在配置里看到 OAuth 字样通常是误用了需要 OAuth 的接口。公众号草稿箱接口用的是 access_token 模式不需要 OAuth。检查.env里是不是混进了其他服务的配置。另外access_token 有 2 小时有效期MCP 服务一般会自动刷新如果报access_token expired重启服务即可。5.5 草稿创建成功但内容为空这种情况多半是 HTML 内容没传对。检查 WorkBuddy 生成的 HTML 是不是被转义了比如变成lt;。在提示词里强调「输出原始 HTML不要转义」。另外微信草稿接口对内容大小有限制太长会被截断建议单篇控制在 20000 字符以内。5.6 封面图上传失败封面图需要先上传到素材库拿到media_id再创建草稿时引用。如果报media_id invalid检查图片格式支持 jpg、png和大小不超过 2M。WorkBuddy 一般会自动处理如果失败手动指定一张本地图片路径再试。排查的核心思路是先看错误码再定位是凭证问题、网络问题还是格式问题。大部分报错在 WorkBuddy 对话里直接问它能帮你读日志、改配置。6. 长期使用建议把 Coding Plan 和 API 接入文档用起来链路跑通之后日常使用就是维护和优化。几个实用建议。第一MCP 服务保持常驻。用nohup或 systemd 配成开机自启避免每次写稿前手动启动。日志定期清理mcp.log大了会影响排查。第二提示词模板化。把常用的选题方向、风格要求、排版格式写成模板每次只换选题。比如「职场干货类案例开头 三个方法论 行动清单HTML 排版1500 字」。这样 AI 输出更稳定。第三草稿箱 手动审阅模式。别直接发布AI 生成的内容一定要人工过一遍检查事实、语气、敏感词。草稿箱就是你的缓冲带。第四关注 access_token 刷新。如果长时间不用token 过期后第一次调用会失败重启服务或等自动刷新即可。如果你想把这条链路用到更复杂的场景比如多账号管理、定时写稿、结合知识库可以看看 TaoToken 的 Coding Plan它适合长期编码和 Agent 场景能把 MCP 服务的调度做得更顺。API 接入文档在 https://taotoken.net/api里面有详细的接口说明和示例。模型对话入口在 https://taotoken.net/api-keys可以管理你的密钥。接入文档在 https://taotoken.net/doc配置遇到问题先翻文档比瞎试快。最后说个真实经验我第一次配的时候卡在 IP 白名单上折腾了半小时后来发现是公司网络出口 IP 和curl ifconfig.me返回的不一致。换到家里网络一次就通了。所以如果 40164 反复出现换个网络环境试试或者直接用云服务器跑 MCP 服务IP 固定省心很多。