跳到内容

Model Context Protocol

适用于任何 MCP 客户端的发布按钮。

只需连接一次社交账号,即可让你的助手在十个网络上起草、预览和排期。SimplePost 通过带 OAuth 的托管 MCP 服务器负责发送。

服务器 URL:https://app.simplepost.social/mcp · 所有套餐和免费试用均包含

由 SimplePost 维护 · 更新于

连接

端点、传输方式和身份验证

SimplePost MCP 服务器技术详情
端点https://app.simplepost.social/mcp
传输方式Streamable HTTP,无状态(POST)
授权带 PKCE (S256) 的 OAuth 授权码流程,动态客户端注册 (RFC 7591)
发现/.well-known/oauth-protected-resource 和 /.well-known/oauth-authorization-server
权限范围accounts:read, posts:read, posts:validate, posts:write
令牌90 天后过期,仅以哈希形式存储,可撤销;没有刷新令牌
方案所有付费方案及 7 天免费试用
将其添加到支持远程 MCP 的客户端
https://app.simplepost.social/mcp
Claude Code
claude mcp add --transport http simplepost https://app.simplepost.social/mcp

未经身份验证的请求会收到 401,并带有指向受保护资源元数据的 WWW-Authenticate 标头,因此合规的客户端会自行启动 OAuth 流程。请参阅 MCP 授权规范。

工具

12 个 MCP 工具

SimplePost MCP 工具、权限范围与用途
工具范围用途
list_accountsaccounts:readReturn connected social accounts with their accountId, platform, name and credential status.
get_tiktok_creator_infoaccounts:readRead a TikTok account's allowed privacy levels, interaction settings and limits.
upload_mediaposts:writeImport a file from a compatible chat client, or a public URL, and return a SimplePost media URL.
validate_postposts:validateCheck text and media against each network's rules without creating anything.
preview_postposts:validateResolve accounts, media, schedule time and validation as data, without writing.
show_post_previewposts:read / posts:validateRender a visual preview of unsaved content or a saved post (MCP Apps UI with a text fallback).
get_scheduleposts:readReturn day, week or month calendar data, including open posting slots, in an IANA timezone.
show_scheduleposts:readRender the interactive calendar.
create_postposts:writePublish now, schedule for later or save a draft, with per-account overrides, threads, quotes and an idempotency key.
inspect_postsposts:readList drafts, scheduled, posted or failed posts, or inspect one post and its per-account results.
update_scheduled_postposts:writeEdit a draft or future scheduled post: text, accounts, media, thread, options or time.
discard_scheduled_postposts:writeDelete a draft or future scheduled post and its stored media.

写入类工具被标记为破坏性操作,因此客户端在运行前可能会询问你。完整参数请参阅工具参考。

推荐工作流

助手应如何通过 MCP 发布内容

  1. 查找真实账号

    调用 list_accounts。如果没有连接任何账户,请引导用户前往 SimplePost 网页应用。
  2. 准备内容和媒体

    起草文字,选择账户 ID,并在客户端可以传递文件时使用公开的媒体 URL 或 upload_media。
  3. 需要时预览

    preview_post 返回验证数据;show_post_preview 渲染可视化预览。两者都不会写入任何内容。
  4. 一次撰写

    使用 create_post,指定 now、schedule 或 draft,并使用新的幂等键。仅在重试同一次写入时才复用该键。
  5. 报告结果

    请查看每个账号和每个分段的结果;调用成功并不代表没有部分失败。
  6. 稍后管理

    使用 inspect_posts 查找帖子;对草稿和未来的帖子使用 update_scheduled_post 或 discard_scheduled_post。
create_post:一篇定时帖子,四个网络,两种形式
{
  "message": "Northwind 2.4 发布:离线模式。随处编辑,稍后同步。",
  "accountIds": [
    "acc_linkedin",
    "acc_x",
    "acc_bluesky",
    "acc_threads"
  ],
  "postingMode": "schedule",
  "scheduledFor": "2026-10-01T10:00:00+02:00",
  "media": [
    {
      "type": "image",
      "url": "https://northwind.example/release-card.png"
    }
  ],
  "accountOverrides": {
    "acc_bluesky": {
      "message": "Northwind 2.4 来了,支持离线使用。",
      "thread": [
        {
          "message": "编辑内容会保存在你的设备上,并在你重新连接后同步。"
        },
        {
          "message": "在合并任何内容之前,都会先向你显示冲突。"
        }
      ]
    },
    "acc_threads": {
      "message": "Northwind 2.4 来了,支持离线使用。",
      "thread": [
        {
          "message": "随处编辑。重新联网后同步。"
        }
      ]
    }
  },
  "idempotencyKey": "northwind-2-4-launch"
}

使用占位账号 ID 的输入示例。LinkedIn 和 X 使用共享消息;Bluesky 和 Threads 通过 accountOverrides 获得各自的串文。

功能

定时发布、预览、变体与媒体

定时发布

  • 使用包含偏移量的 ISO 8601 时间来安排发布;日历工具则使用 IANA 时区,例如 Europe/Berlin。
  • SimplePost 会存储帖子并在到期时间发布,并在发送前再次校验。
  • get_schedule 会返回已安排、待处理、已发布和失败的活动,以及可用的发布时段。

预览

  • show_post_preview 和 show_schedule 会在支持 MCP Apps 的客户端(如 ChatGPT 和 Claude)中渲染小组件。
  • 每个工具也会返回文本和结构化数据,供不支持小组件的客户端使用。

按网络区分的变体和串帖

  • accountOverrides 会在一条帖子内,为特定账号替换消息、媒体或帖子串。
  • 最多 24 条后续内容的串帖在 X、Bluesky、Threads 和 Telegram 上为原生支持;其他网络只会收到第一条帖子并显示警告。
  • 在 X、Bluesky、Threads 和 LinkedIn 上通过 quotePostId 引用帖子。

媒体

  • 公开的图片和视频 URL,或由客户端传给 upload_media 的文件。
  • JPEG、PNG、GIF、WebP、MP4、QuickTime 和 WebM;通过 MCP 每个文件最大 500 MB。
  • 远程服务器不接受 Base64 数据、本地文件路径和 blob: URL。

托管版与开源版

托管版 SimplePost 与开源组件的对比

使用哪个 SimplePost 组件
托管 MCP 服务器app.simplepost.social/mcp。使用在托管版 SimplePost 中已连接的账号;平台应用由 SimplePost 提供。适用于所有套餐和试用。
自托管的调度器与 MCP同样的调度器应用,包括其 MCP 和 OAuth 服务器,来自 MIT 许可的 simple-post/core 仓库。平台开发者应用和凭据由你自行提供。
TypeScript SDKnpm 上的 @simple-post/sdk 1.4.0。使用您自己的凭据直接发布;不含托管定时发布或 MCP。
CLI@simple-post/cli 1.4.0。Advanced 和 Pro 套餐可使用托管账号,也可使用自带凭据的本地账号。立即发布。
托管 HTTP APIPro 和试用版提供 Bearer API 密钥,支持草稿、定时发布、幂等性和 webhook。

源代码:github.com/simple-post/core · 已发布的软件包和托管功能

常见问题

MCP 服务器常见问题

SimplePost 有 MCP 服务器吗?

是的。SimplePost 托管了一个远程 MCP 服务器,地址为 https://app.simplepost.social/mcp。它使用 Streamable HTTP 和 OAuth,并包含在每个 SimplePost 方案及 7 天免费试用中。

MCP 服务器可以发布到哪些社交网络?

X、LinkedIn、Instagram、Facebook、Threads、Bluesky、TikTok、YouTube、Pinterest 和 Telegram:与 SimplePost 网页应用相同的十个网络,使用你在那里连接的账户。

MCP 服务器可以排期帖子吗?

是的。create_post 支持三种发布模式:now、schedule 或 draft。定时帖子由 SimplePost 存储,并在到期时发布,即使助手已不再运行。

它需要 API 密钥吗?

不需要。客户端通过 OAuth 和 PKCE 授权,并通过动态客户端注册自行注册。SimplePost API 密钥仅用于 Pro 套餐的 HTTP API,MCP 服务器不接受。

MCP 服务器是开源的吗?

是的。MCP 服务器是 SimplePost Scheduler 应用的一部分,位于采用 MIT 许可证的 simple-post/core 代码仓库中。您可以使用自己的平台应用自托管 Scheduler,并使用您部署实例的 /mcp 端点。

助手可以通过 MCP 连接社交账户吗?

不是。社交账号需在 SimplePost 网页应用中连接和重新连接。MCP 服务器只能使用已连接的账号,并且绝不会暴露其令牌。

几分钟内连接助手

开始免费试用,连接一个社交账号,然后将服务器 URL 添加到你的 MCP 客户端。

免费 7 天 · 无需信用卡 · 所有套餐均支持 MCP