posterly

posterly MCP 服务：Instagram、TikTok、LinkedIn 和另外 15 个平台

通过任意 MCP 客户端，在 18 个平台上安排并发布社交媒体帖子。

posterly 是一款社交媒体排程工具，提供托管式 MCP 服务。连接 Claude、ChatGPT、Cursor、Windsurf、Cline 或任意 MCP 客户端后，你的助手便可以列出已连接的账号、使用 validate_post 检查帖子、使用 create_post 安排帖子、上传媒体、撰写说明文字、查看分析数据、回复评论，以及管理 Google Business 评论。支持 Instagram、Facebook、TikTok、X、LinkedIn、YouTube、Pinterest、Threads、Google Business、Telegram、Bluesky、Discord、Slack、Mastodon、Dev.to、Hashnode、WordPress 和 Lemmy。你可以使用托管端点（https://www.poster.ly/api/mcp，通过 OAuth 登录），也可以使用 npx -y posterly-mcp-server@latest 在本地运行。

需要 Instagram MCP、TikTok MCP 或 LinkedIn MCP 的用户可以使用同一服务。一个连接即可支持全部 18 个平台，无需为每个社交网络单独使用一个服务。

可安装的软件包是 npm 上的 posterly-mcp-server。源代码：github.com/awpthorp/posterly-mcp-server。官方 MCP Registry 名称为 io.github.awpthorp/posterly。Smithery 列出了同一个托管端点：smithery.ai/servers/awpthorp/posterly。

所需条件

• 本地运行 npx 服务需要 Node.js 20 或更高版本。
• 使用需要身份验证的工具，需要订阅包含 API 和 MCP 访问权限的 posterly 套餐。
• 通过 poster.ly/mcp 注册的新账号，可通过一个 Stripe 订阅同时获得套餐、API 和 MCP，并享受 7 天免费试用。需要提供银行卡，第 8 天将扣费，除非更早开始付费套餐。已试用过的账号会在结账时扣费。Starter + API 的费用为每月 $10。
• 附加服务单独订阅时，Starter 套餐每月 $3，新版 Pro 每月 $4（现有 Pro 客户仍为每月 $3），Power 每月 $5，Agency 每月 $29。基础套餐起价为每月 $7。合并后的月费分别为 $10、$19、$30 和 $78。
• 结账后，如果客户端需要密钥，请在 Dashboard, API and MCP 中创建。托管式 OAuth 连接器会直接登录，无需粘贴密钥。

用户创建的 API 密钥数量：Starter 1 个，Pro 2 个，Power 3 个，Agency 4 个。

托管端点

POST https://www.poster.ly/api/mcp

请使用 www 主机。https://poster.ly/api/mcp 会重定向，而一些连接器客户端不会跟随该重定向。

• 线路格式：通过一次 HTTPS POST 传输 JSON-RPC 2.0。响应为 JSON 正文。此 v1 端点不会打开 SSE 流。GET https://www.poster.ly/api/mcp 会返回简短的 JSON 功能提示，且无需身份验证。
• 身份验证：Claude 和 ChatGPT 自定义连接器使用 OAuth 登录；或者在客户端支持请求头时使用 Authorization: Bearer pst_live_...。
• 文档：poster.ly/mcp 和 MCP 服务文档。
• 服务卡片：/.well-known/mcp/server-card.json。

curl -s https://www.poster.ly/api/mcp \
  -H "Authorization: Bearer pst_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

托管工具调用仅支持 JSON。聊天附件不会传到 posterly。在 ChatGPT 网页版、Claude.ai 和 Gemini 网页版中，请求调用 create_media_drop，打开返回的 https://www.poster.ly/drop/... 链接（每个链接最多 20 个文件），然后调用 list_media。能够上传字节的客户端（Cursor、Claude Code、Codex）可以使用 create_signed_upload（每次调用 1 到 20 个文件），并将每个文件 PUT 到其返回的 upload_url。小图片可以使用 upload_media。

每个密钥每小时最多可发起 100 次创建帖子的请求。create_posts_batch 可在一次经确认的请求中提交最多 25 篇帖子。媒体写入和读取有各自独立的限额。

只有在你同意且调用中包含确认字段（confirm: true）后，create_post 才会执行。评论回复、私信、Google 评价回复以及类似的公开或破坏性操作会先返回预览，之后需要再次提供相同字段，并附上该 preview_id。

源码

此仓库是只读镜像，由 posterly monorepo 发布。欢迎提交问题。这里不会合并拉取请求：获接受的更改会重新应用到 posterly monorepo，并在下一次同步时发布。

git clone https://github.com/awpthorp/posterly-mcp-server.git

客户端应使用下方的 npx 配置块，或托管 URL。克隆仓库只是公开源码，并非另一种安装方式。

本地服务

{
  "mcpServers": {
    "posterly": {
      "command": "npx",
      "args": ["-y", "posterly-mcp-server@latest"],
      "env": {
        "POSTERLY_API_KEY": "pst_live_your_key_here"
      }
    }
  }
}

只有在助手应先启动注册时，才省略 POSTERLY_API_KEY。以下公开工具在密钥尚不存在时也可使用：将 view 设为 status 的 whoami、get_agent_signup_info、start_signup 和 get_signup_session。这些工具仅在本地 npm 服务上提供，托管端点不提供。

本地程序包提供完整的工具目录。托管端点提供相同的工具目录，但不包含三个注册工具。当前列表见 poster.ly/mcp。

Claude

自定义连接器（Claude 聊天以及 Claude 桌面应用中的同一连接器）：

1. 打开 Settings、Connectors、Add custom connector。在 claude.ai 上，也可以从聊天中的 +、Connectors、Add connector、Add custom connector 开始。
2. 将名称设为 posterly。
3. 粘贴 https://www.poster.ly/api/mcp。
4. 选择 Connect，登录 posterly，然后按 Allow。
5. 将高级 OAuth 客户端 ID 和密钥留空。

Claude Desktop 本地配置文件：claude_desktop_config.json，使用上方的 npx 配置块。

Claude Code，托管模式：

claude mcp add --transport http posterly https://www.poster.ly/api/mcp

Claude Code，本地 stdio：

claude mcp add --scope user -e POSTERLY_API_KEY=pst_live_your_key_here posterly -- npx -y posterly-mcp-server@latest

设置页面：poster.ly/claude。

ChatGPT

ChatGPT 网页版仅连接托管端点。不要将 npx 配置粘贴到 ChatGPT 中。

1. 在 chatgpt.com 打开 Settings、Security and login，并开启 Developer mode。
2. 打开 chatgpt.com/plugins，选择 +、Create app、Create MCP App。
3. 将服务 URL 设为 https://www.poster.ly/api/mcp，并选择 OAuth。
4. 登录 posterly。

写入操作（create_post 和其他写入操作）需要 ChatGPT Business、Enterprise 或 Edu。Pro 自定义 MCP 仅支持读取和获取。自定义 MCP 仅限网页版使用，不支持移动端 MCP。

这是需要你自行添加的自定义应用，并非一键添加的目录列表。

设置页面：poster.ly/chatgpt。

Cursor

项目文件 .cursor/mcp.json，或全局文件 ~/.cursor/mcp.json。你也可以在 Settings、MCP 中添加服务。

本地 stdio（Cursor Desktop 和本地 CLI）使用上方的 npx 配置块。该方式可以读取真实的 file_path。

托管 HTTP，供无法访问本地 npx 进程的 Cloud Agents 使用：

{
  "mcpServers": {
    "posterly": {
      "url": "https://www.poster.ly/api/mcp",
      "headers": {
        "Authorization": "Bearer pst_live_your_key_here"
      }
    }
  }
}

Cursor 也支持 OAuth。SSE 不是 posterly v1 的传输方式。

设置页面：poster.ly/cursor。

Windsurf、Cline 和 Codex

Windsurf 在 ~/.codeium/windsurf/mcp_config.json 中使用相同的 npx JSON 配置。

Cline、Continue 和 Zed 在其 MCP 设置中使用相同的 JSON 结构。

Codex（终端、IDE 扩展，以及 ChatGPT 桌面应用中的 Codex 标签页）共用 ~/.codex/config.toml：

codex mcp add posterly --env POSTERLY_API_KEY=pst_live_your_key_here -- npx -y posterly-mcp-server@latest
codex mcp add posterly --url https://www.poster.ly/api/mcp
codex mcp list

--url 命令使用 ChatGPT 页面中说明的托管端点。posterly 服务会返回单个 JSON-RPC 请求体，而不是 SSE 流。

工具

工具分为多个集合：core（账户、发布、媒体、日程、分析、支持）、creative（AI 图像和视频生成、帖子建议）、inbox（评论和私信）、google_business（评价、媒体、个人资料审核）、admin（API 密钥、webhook、工作区成员、暂停发布）以及 billing（订阅变更）。注册工具仅限本地使用。

实际工具名称包括 whoami、list_accounts、list_platforms、validate_post、create_post、create_posts_batch、list_posts、update_post、find_available_slot、upload_media、generate_captions、generate_image、list_analytics、list_comments、manage_comment、list_google_business_reviews、manage_google_business_review 和 audit_google_business_profile。

完整列表（含视图和操作）请参见 poster.ly/mcp。

目前，分析工具（list_analytics）支持 Instagram、X、Facebook Pages、LinkedIn、Google Business Profile、Pinterest、YouTube 和 Threads。

链接

• 产品和设置：https://www.poster.ly/mcp
• 文档：https://www.poster.ly/docs/integrations/mcp
• 隐私：https://www.poster.ly/privacy
• 条款：https://www.poster.ly/terms
• npm：https://www.npmjs.com/package/posterly-mcp-server

许可证

MIT。参见 LICENSE。