使用文档

进阶

接入 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 密钥 创建。密钥等同于账号凭证:不要提交到代码仓库,怀疑泄露立即重置。推荐把密钥放进环境变量(如 ~/.zshrcexport WEXIN_MCP_TOKEN=...),各客户端引用同一处。

设置 → API 密钥:创建与管理密钥 设置 → API 密钥:创建与管理密钥

国内客户端

干活 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。