AI 智能体 (MCP)

PostClaw 提供远程 Model Context Protocol 服务器。连接 AI 助手后，你可以直接说：“为下周写三篇帖子，并安排发布到我的 Facebook 主页”。助手会以你的身份查看频道、起草帖子并放进日历。

所有套餐均可使用，包括 Free。 套餐限额与在应用中完全相同。

准备工作

至少连接了一个频道的 PostClaw 账号。
能通过 Streamable HTTP 发送 Authorization 请求头的 MCP 客户端：Claude Code、Cursor、VS Code 以及大多数其他 MCP 客户端。
在 设置 → AI 智能体 中创建的令牌。

暂不支持浏览器版 Claude.ai 和 ChatGPT。它们需要 OAuth 登录，该功能已在计划中。

两分钟完成连接

打开设置 → AI 智能体，点击 新建令牌。
起一个好认的名字（例如“笔记本上的 Cursor”），并选择权限。
复制令牌。令牌只显示一次。 如果丢失，请撤销后重新创建。
将服务器添加到客户端。设置页面会显示已填好令牌的以下配置片段。

服务器地址: https://app.postclaw.fun/mcp

Claude Code

claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "postclaw": {
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "postclaw": {
      "type": "http",
      "url": "https://app.postclaw.fun/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

然后问助手一句“我在 PostClaw 里有哪些频道？”来检查连接。

权限

每个令牌都有自己的权限。助手只能看到令牌允许的工具。

权限	助手能做什么
读取 (始终开启)	查看频道、帖子、媒体和数据分析，获取发布时间建议
写入	创建和编辑草稿、上传媒体、用 AI 写帖子、生成 AI 图片
发布 (默认关闭)	在你的真实账号上安排、发布、取消安排和删除帖子

没有发布权限时，助手只能留下草稿，由你在 PostClaw 中审核和批准。只为你信任、可以代你发帖的助手开启此权限。

最多可保留 10 个有效令牌。撤销令牌会在助手下一次请求时生效。

工具

工具	权限	作用
`list_channels`	读取	可用于发布的已连接账号和主页
`list_posts`, `get_post`	读取	草稿、已安排和已发布的帖子，附链接和错误信息
`get_analytics`	读取	总量、按平台细分、最佳时间、热门帖子
`suggest_posting_times`	读取	各平台的推荐发布时段
`list_media`	读取	最近上传的媒体
`generate_post`	写入	根据简要说明撰写帖子，可选用你的品牌语气
`adapt_post`	写入	将一份内容改写成适合各平台的版本
`create_image`	写入	为帖子生成 AI 图片
`upload_media`, `add_media_to_post`	写入	附加你自己的图片和视频
`create_post`, `update_post`	写入	创建和编辑草稿；设置时间即安排发布（需要发布权限）
`publish_post`	发布	立即发布并返回各平台的帖子链接
`unschedule_post`	发布	把已安排的帖子退回草稿
`delete_post`	发布	从 PostClaw 删除帖子

媒体必须是 https:// 链接，或通过 upload_media 上传的文件。

create_post 和 publish_post 可选接收 idempotency_key。如果助手在 24 小时内用相同的键重试，PostClaw 会返回第一次的结果，而不会重复创建或发布。

限额与积分

助手使用与你在应用中相同的套餐：

每月帖子数、AI 积分和图片配额在 PostClaw 中和通过助手使用时计算方式相同。
如果你在设置中连接了自己的 AI 密钥，AI 工具会使用该密钥。
每个令牌每分钟最多 60 次请求。
每次调用都会记录在你的账号中。

问题排查

现象	原因	处理方法
`401` / “invalid token”	令牌错误或已被撤销	创建新令牌并更新客户端
`429`	单个令牌每分钟请求超过 60 次	等待几秒；响应中会说明需等待多久
缺少某个工具	令牌没有该工具所需的权限	创建带有该权限的令牌
`scope_missing`	在没有发布权限时安排或发布	在新令牌上开启发布，或在应用中安排
`quota_exceeded`, `credit_cap_exceeded`	套餐的月度限额已用完	等待下一个周期或升级套餐
”your … configuration failed”	你自己的 AI 密钥返回错误（配额、账单、登录过期）	在设置 → Providers 中修复或删除该密钥

保护好你的令牌

令牌以你的身份操作。请像对待密码一样对待它：

不要提交到代码仓库，也不要粘贴到共享聊天中。
每台设备或每个工具使用一个令牌，这样撤销其中一个不会影响其他。
在 设置 → AI 智能体 中撤销不再使用的令牌。