Postiz MCP
官方使用Postiz简化社交媒体运营。在一个平台上安排帖子、分析表现并管理所有账户
你可以用 Postiz MCP 做什么?
- 列出已连接的账号 — 请代理列出你已连接的社交媒体账号,也可以按群组筛选。
- 查看平台规则 — 在起草帖子前,获取特定平台的发布规则和设置架构。
- 安排或发布帖子 — 将帖子安排到已连接的账号发布、保存为草稿,或立即发布。
- 查看已安排的帖子 — 列出组织在两个日期之间安排发布的帖子及其当前设置。
- 生成媒体内容 — 为帖子生成 AI 图片或视频,并列出可用的视频生成选项。
- 剪辑长视频 — 将较长的 YouTube 视频转换为带字幕的竖屏短片和帖子草稿,然后查看剪辑状态。
文档
简介
使用模型上下文协议 (MCP) 将 AI 代理连接到 Postiz
MCP(模型上下文协议)让 AI 代理能够直接与 Postiz 交互,通过标准化的工具调用接口列出集成、安排帖子、生成图片和视频,以及将长视频剪辑成短视频。
这意味着你可以将 Claude、ChatGPT、Cursor 或任何兼容 MCP 的客户端连接到你的 Postiz 账户,并通过自然语言管理社交媒体。
工作原理
Postiz 提供一个 MCP 服务器,为 AI 代理提供 13 个工具。代理会发现这些工具、理解其架构,并代表你调用它们。
sequenceDiagram
participant Agent as AI Agent
participant MCP as Postiz MCP Server
participant Postiz as Postiz Backend
Agent->>MCP: Connect with API key / OAuth token
MCP-->>Agent: List available tools
Agent->>MCP: Call tool (e.g., schedule post)
MCP->>Postiz: Execute action
Postiz-->>MCP: Return result
MCP-->>Agent: Tool response
可用工具
| 工具 | 描述 |
|---|---|
integrationList | 列出所有已连接的社交媒体账户(可按群组筛选) |
groupList | 列出组织中的所有群组(客户) |
integrationConnectTool | 获取用于连接新社交媒体账户的链接 |
integrationSchema | 获取特定平台的发布规则和设置架构 |
triggerTool | 执行特定平台的辅助操作(例如,列出 Discord 频道) |
schedulePostTool | 安排发布、保存草稿或立即发布帖子 |
postsListTool | 列出组织在两个日期之间安排发布的帖子(及其当前设置) |
postSettingsTool | 更新尚未发布的已安排帖子或草稿的平台设置 |
generateImageTool | 为帖子生成 AI 图片 |
generateVideoOptions | 列出可用的视频生成选项 |
videoFunctionTool | 获取视频生成器设置(例如,可用的语音) |
generateVideoTool | 为帖子生成视频 |
clippingTool | 将较长的 YouTube 视频转换为带字幕的竖屏短片,并创建帖子草稿 |
clippingStatusTool | 检查剪辑任务并获取已完成的短片 |
身份验证
有两种方式可以通过 MCP 服务器进行身份验证:
API 密钥
可直接在 MCP 端点 URL 中使用,也可将其作为 Bearer 令牌使用。
OAuth 令牌
如果你正在为其他 Postiz 用户构建应用,请使用 OAuth2 获取令牌。OAuth 令牌以 pos_ 开头,使用方式与 API 密钥相同。
连接
[tab] Bearer 令牌
使用
/mcp端点,并将 API 密钥或 OAuth 令牌作为 Bearer 令牌:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-key此方法同时支持 API 密钥和 OAuth 令牌(前缀为
pos_)。
[tab] URL 中的 API 密钥
使用
/mcp/:apiKey端点,并将 API 密钥嵌入 URL:URL: https://mcp.postiz.com/mcp/your-api-key
快速示例
以下是 AI 代理使用 Postiz MCP 时的典型交互:
- 代理调用
integrationList,获取你已连接的账户(X、LinkedIn 等) - 代理调用
integrationSchema,并传入platform: "x",了解 X 的字符数限制、设置和规则 - 代理调用
schedulePostTool,按照正确格式安排发布你的帖子
当你对 AI 代理说出类似下面的话时,以上操作都会自动完成:
“安排明天上午 10 点在 X 发布一条帖子:很高兴宣布我们的新功能!”
常见问题
使用 Postiz MCP 需要 OpenAI 密钥吗?
不需要。MCP 服务器只负责提供 Postiz 的工具。你的 AI 客户端(Claude、ChatGPT、Cursor 等)提供模型。只有在使用 Postiz 自带的 AI 功能(图片生成、copilot)时,Postiz 才需要 OPENAI_API_KEY;这些功能与提供给客户端的 MCP 工具是分开的。
API 密钥过期或轮换后会怎样?
Postiz API 密钥不会自动轮换,但如果你在 Settings → Developers → Public API 中重新生成密钥,所有使用旧密钥的 MCP 客户端都会停止工作,直到你更新其配置。在客户端配置中更新 URL 或 Authorization 标头,然后重新连接。
自托管:如何公开 MCP 端点?
MCP 服务器会作为 Postiz 后端的一部分启动,可通过 /mcp(Bearer 身份验证)、/mcp/:apiKey(密钥位于 URL 中)和 /mcp-oauth(受 OAuth 保护)访问。你的反向代理必须将这些路径转发到后端,并支持流式 HTTP(Transfer-Encoding: chunked)。请参阅反向代理。
MCP 能读取或回复评论吗?
目前还不能。当前工具集对集成仅提供读取权限,对帖子和媒体仅提供写入权限。MCP 未提供 getComments 或 replyToComment。必须通过 Postiz 界面触发评论回复。
本文档使用开发者文档平台 Mintlify 构建并托管。