进阶
接入 AI 助手(MCP)
把 wexin 接进干活AI、Claude、Codex、Cursor 等主流 Agent 客户端,让 AI 写完直接送草稿箱
wexin 提供标准 MCP(Model Context Protocol)服务。接入后,你的 AI 助手就能直接调用 wexin 的能力:查模板、排版、传图、把文章送进公众号草稿箱——你只需要说一句"写一篇 XX,发到我的草稿箱"。
AI / MCP 接入需要有效套餐或试用;套餐到期后所有 MCP 工具都会暂停。免费能力是网页端排版工具,可直接在浏览器里使用。
通用参数
所有客户端的配置都只需要两样东西:
| 项目 | 值 |
|---|---|
| 端点 | https://wexin.ai/api/mcp(Streamable HTTP) |
| 鉴权 | 请求头 Authorization: Bearer <你的 API 密钥> |
API 密钥在 设置 → API 密钥 创建。密钥等同于账号凭证:不要提交到代码仓库,怀疑泄露立即重置。推荐把密钥放进环境变量(如 ~/.zshrc 里 export WEXIN_MCP_TOKEN=...),各客户端引用同一处。
国内客户端
干活 AI(推荐,已内置)
干活 AI 是免费、易用的桌面 AI Agent,已内置 wexin——下载安装、登录后即可直接使用,无需任何手动配置。
Cherry Studio
设置 → MCP 服务器 → 添加服务器:类型选 streamableHttp,URL 填 https://wexin.ai/api/mcp,请求头加一行:
Authorization=Bearer 你的API密钥
其他支持 MCP 的国内客户端
凡是支持「远程 MCP(Streamable HTTP)+ 自定义请求头」的客户端(Chatbox、DeepChat 等),都按上面的通用参数填写即可。
国外客户端
Claude Code
claude mcp add --transport http wexin https://wexin.ai/api/mcp \
--header "Authorization: Bearer ${WEXIN_MCP_TOKEN}"
验证:claude mcp list 应显示 wexin ✓ Connected。
Codex CLI
codex mcp add wexin --url https://wexin.ai/api/mcp \
--bearer-token-env-var WEXIN_MCP_TOKEN
或直接编辑 ~/.codex/config.toml:
[mcp_servers.wexin]
url = "https://wexin.ai/api/mcp"
bearer_token_env_var = "WEXIN_MCP_TOKEN"
Cursor
在 ~/.cursor/mcp.json(或项目内 .cursor/mcp.json)添加:
{
"mcpServers": {
"wexin": {
"url": "https://wexin.ai/api/mcp",
"headers": { "Authorization": "Bearer 你的API密钥" }
}
}
}
OpenClaw
openclaw mcp add wexin \
--url https://wexin.ai/api/mcp \
--transport streamable-http \
--header "Authorization: Bearer ${WEXIN_MCP_TOKEN}"
Hermes Agent
在 Hermes 的 config.yaml 里添加:
mcp_servers:
wexin:
url: "https://wexin.ai/api/mcp"
headers:
Authorization: "Bearer 你的API密钥"
Cline / Windsurf 等
在各自的 MCP 配置文件里按同样结构添加远程服务器(url + headers.Authorization)即可。
ChatGPT
ChatGPT 的连接器(开发者模式)支持远程 MCP 服务,在设置中按界面提示添加 https://wexin.ai/api/mcp。各版本支持程度不同,以 OpenAI 当前文档为准。
连上之后怎么用
直接对 AI 说自然语言即可,比如:
「把这篇文章排成公众号格式,用知识科普类模板,配好封面,发到我的草稿箱。」
AI 会自动调用 wexin 的工具完成排版、传图和草稿投递。几个有用的细节:
- 绑定了多个公众号时,直接告诉 AI 发到哪个号;
- 文章只会进草稿箱,公开发表永远由你在微信后台亲手操作;
- 让 AI 先调用
capabilities工具,它会拿到模板目录和写作规则,排版质量更稳。
排查
- 连不上:先确认环境变量非空(
echo $WEXIN_MCP_TOKEN),新开终端或重启客户端让它生效; - 401:密钥失效或填错,去 设置 → API 密钥 重新生成;
- 投递失败:确认已绑定公众号且开通 Pro。