PostSider

@postsider/mcp

MCP（Model Context Protocol）服务，让 AI Agent 通过 PostSider 的公共 API 有选择地访问 PostSider 实例。可与 Claude Code、Claude Desktop、Codex、Cursor 以及任何兼容 MCP 的客户端配合使用。可连接云端 （api.postsider.com）或可自托管的实例，并通过组织 API 密钥进行身份验证。

PostSider 是一个共享的运营日历：Agent 负责准备和安排工作，人类则负责审核实际发布的内容。

安装

1. 创建 API 密钥

在 PostSider 中，打开 Settings -> API 并生成组织 API 密钥。

2. 连接客户端

Claude Code：

claude mcp add postsider -e POSTSIDER_API_KEY=your_api_key -- npx -y @postsider/mcp

Claude Desktop 或任何通用 MCP 客户端：

{
  "mcpServers": {
    "postsider": {
      "command": "npx",
      "args": ["-y", "@postsider/mcp"],
      "env": {
        "POSTSIDER_API_KEY": "your_api_key"
      }
    }
  }
}

3. 使用只读提示词进行验证

向 Agent 提问，并确认它在不做任何更改的情况下作答：

List my connected PostSider channels. Do not create or modify anything.

然后：

Show my PostSider calendar for the next 14 days. Do not create or modify anything.

4. 只有完成上述步骤后，才准备草稿

Create one draft only for the selected channel. Show me the exact content first. Do not publish it.

从源代码安装

pnpm --filter @postsider/mcp build

然后将客户端指向构建后的入口点：

{
  "mcpServers": {
    "postsider": {
      "command": "node",
      "args": ["/absolute/path/to/apps/mcp/dist/index.js"],
      "env": {
        "POSTSIDER_API_KEY": "your_api_key",
        "POSTSIDER_API_URL": "https://api.postsider.com"
      }
    }
  }
}

Claude Code 插件

此软件包目录同时也是 Claude Code 插件：.claude-plugin/plugin.json 将 API 密钥声明为机密用户设置，.mcp.json 会以固定的已发布版本启动此服务，而 skills/ 包含针对日历审核、内容发布、审批、分析和代理运营的专用工作流。仓库根目录是插件市场，因此可直接从仓库安装插件：

技能额度已满（5/5）。 远程服务通过 OpenAI 的技能扩展公布其捆绑的技能，该扩展最多支持 5 个。所有 5 个名额均已占用，因此要添加新技能，必须停用或合并现有技能（loadSkillCatalog 在超过 5 个时会失败关闭）。

claude plugin marketplace add lumizone/postsider
claude plugin install postsider@postsider

安装时会将密钥保存在插件目录之外：安装时通过 --config api_key=your_api_key 传入，或在 Claude Code 中使用 /plugin configure postsider@postsider 之后设置。密钥绝不会写入插件目录。

Agent 可以执行的操作

提供 37 个工具（本地 stdio 服务提供 38 个），名称均以 postsider_ 开头。

读取

工具	操作
postsider_list_channels	列出已连接的社交渠道（ID、名称、平台）。先调用此工具以获取渠道 ID。
postsider_get_agency_overview	组织级概览：客户、渠道、排队内容、草稿、已发布内容、错误和待审批事项。
postsider_get_customer_report	同一份报告，但范围限定为一位客户。
postsider_list_groups	列出渠道组。
postsider_list_media	浏览媒体库（分页、可搜索），以重复使用已上传的文件。
postsider_get_channel_rules	获取某个渠道的平台规则、长度上限及必需的 settings 结构。向新渠道发布内容前调用。
postsider_get_queue_plan	获取渠道的定期发布时段和时区。
postsider_get_smart_slots	获取渠道即将到来的最佳发布时间，并避开已预订时段。
postsider_get_content_library	获取已保存的话题标签组、说明文字模板和 UTM 预设。
postsider_find_slot	获取渠道下一个空闲的排队时段（UTC）。
postsider_list_posts	列出指定日期范围内的帖子，可按 state（例如 ERROR）和渠道筛选，并支持分页。
postsider_get_post	获取帖子的完整详情，包括任何发布错误。
postsider_get_post_missing_fields	获取各渠道的验证问题，以便在发布前修复。
postsider_get_post_analytics	获取单条帖子的分析数据。
postsider_get_channel_analytics	获取渠道的账号级分析数据。
postsider_get_notifications	获取近期通知：发布失败、需要重新连接的渠道。
postsider_get_publishing_state	获取组织是否启用了发布功能，或是否已暂停发布。
postsider_get_approval_status	获取草稿的审批状态；若被拒绝，还会包含审核者备注。

编写

工具	操作	风险
postsider_create_post	在各渠道创建草稿、定时帖子或立即发布帖子。	创建内容并可能发布
postsider_update_post	直接编辑现有帖子：文本、媒体、日期、设置、首条评论。不适用于已发布或待审批的帖子。	更改内容，并重新启用定时帖子
postsider_update_post_status	将帖子从 draft 切换为 schedule，或反向切换。	可撤销
postsider_request_approval	将草稿发送到人工审批队列。	可撤销
postsider_upload_media_from_url	从公开的 HTTPS URL 将媒体导入素材库。	创建媒体
postsider_upload_media_base64	上传你持有字节数据的图片或 MP4（base64：本地服务为 25 MB，远程连接为 2.5 MB）。无需公开 URL。	创建媒体
postsider_upload_media_from_file	仅限本地 stdio 服务。 从你自己机器上的文件路径上传图片或视频（jpg、png、gif、webp、avif、bmp、tiff、mp4、mov、webm、mkv；最大 500 MB）。其他文件类型会在读取前被拒绝。	创建媒体
postsider_connect_channel	获取用于连接或重新连接社交账号的登录链接（由用户在平台上批准）。需要 channels:write。	开始连接
postsider_set_channel_enabled	开启或关闭某个渠道。需要 channels:write 和管理员角色。	可撤销
postsider_disconnect_channel	断开某个渠道；未发布的帖子会变为草稿。需要 channels:write。	破坏性操作
postsider_set_queue_plan	替换某个渠道的发布时间段（{time, days?}：从午夜起算的分钟数，可选的星期几 0-6）。请先读取计划；此操作会整体替换。需要 channels:write 和管理员角色。	替换设置
postsider_set_channel_customer	按名称将某个渠道分配给客户。需要 channels:write 和管理员角色。	可撤销
postsider_save_library_item	创建或更新话题标签组、文案模板或 UTM 预设。	创建内容
postsider_delete_library_item	删除素材库项目。	破坏性操作
postsider_duplicate_post	将帖子复制为新草稿，可选择复制到其他渠道。	创建草稿
postsider_check_post	使用 AI 检查最多 3 个平台的草稿文本（会消耗每月 AI 配额）。	消耗 AI 配额
postsider_rewrite_post	使用所选语气通过 AI 改写文本（会消耗每月 AI 配额）。	消耗 AI 配额
postsider_delete_media	从素材库和存储中删除媒体文件。	破坏性操作
postsider_delete_post	永久删除帖子及其在所有其他渠道上的版本（一个帖子组）。请先读取帖子。	破坏性操作
postsider_pause_publishing	整个组织的紧急停止。只能由人工恢复。	破坏性操作

访问范围（远程服务）

范围	允许的操作
posts:read	所有读取工具。
posts:write	帖子、媒体、素材库、复制和 AI 检查。
channels:write	连接、启用、禁用、重新设置发布时间、重新分配和断开渠道。此权限单独授予，因此只能安排帖子发布的 Agent 无法重新配置工作区。在此范围推出前建立的连接需要重新连接才能获得该权限。

账单、团队和角色、API 密钥、MFA、账号删除以及恢复已暂停的工作区，均刻意不向 Agent 开放；这些操作只能在控制面板中进行。

每个工具都会明确声明 readOnlyHint、destructiveHint、idempotentHint 和 openWorldHint，因此客户端可以区分读取操作和紧急停止开关。

配置

变量	必需	默认值	描述
POSTSIDER_API_KEY	是	-	组织 API 密钥（Settings -> API）
POSTSIDER_API_URL	否	https://api.postsider.com	实例基础 URL

POSTSIDER_API_URL 必须使用 HTTPS。仅在环回地址（localhost、127.0.0.1、[::1]）上接受普通 HTTP，用于本地开发。

对于可自托管的实例，请将 POSTSIDER_API_URL 指向公共 API 的服务地址。在内置 nginx 后，API 位于 /api 路径下，因此请使用你的域名加上 /api，例如 https://social.example.com/api。服务端会将 /public/v1 追加到你设置的地址后。

安全

• API 密钥从环境中读取，只会发送到配置的 PostSider API URL。它绝不会被打印、记录日志或包含在错误信息中。
• POSTSIDER_API_URL 中嵌入的凭据会被拒绝。
• 不会跟随重定向，而是直接拒绝：重定向会使经过身份验证的请求离开配置的来源，因此客户端会返回一条可采取行动的提示信息。
• 请求会在 30 秒后超时，并且在报告失败响应前，最多读取 8 KB 的响应正文。
• 工具参数会在本地验证，然后才会发起网络调用：ID 必须非空，日期必须是有效的 ISO 8601 日期（2026-02-30 会被拒绝，不会发送到 API），帖子的状态必须是 draft 或 schedule，媒体导入必须使用公共 HTTPS URL。
• 缺少 API 密钥时，程序会退出并返回代码 1，同时在 stderr 上输出说明信息。stdout 仅承载协议帧。

开发

pnpm --filter @postsider/mcp typecheck
pnpm --filter @postsider/mcp typecheck:tests
pnpm --filter @postsider/mcp test
pnpm --filter @postsider/mcp build
pnpm --filter @postsider/mcp version:gate
pnpm --filter @postsider/mcp validate:registry
pnpm --filter @postsider/mcp smoke:tarball
claude plugin validate --strict apps/mcp

设计

此服务是对所选 /public/v1 REST API 端点的轻量封装，使用原始 API 密钥进行身份验证。它不依赖后端，仅引入 @modelcontextprotocol/sdk 和 zod，因此保持轻量且易于维护。所有工具注册都位于单个工厂中，因此当前的 stdio 传输以及未来的任何传输都共享同一面向 Agent 的接口。