Postiz MCP

官方

使用Postiz简化社交媒体运营。在一个平台上安排帖子、分析表现并管理所有账户

访问 postiz.pro试用此 MCP赞助

你可以用 Postiz MCP 做什么？

列出已连接的账户 — 让您的助手通过 integrationList 显示所有关联的社交媒体资料，并可按群组筛选。
安排或发布帖子 — 指示您的助手通过 schedulePostTool 创建草稿、安排时间或立即发布内容。
生成AI图像 — 直接通过 generateImageTool 请求为您的帖子生成AI视觉内容。
创建视频片段 — 使用 clippingTool 将长YouTube视频转换为带字幕的竖屏短片并起草帖子。
查看平台规则 — 在安排之前，通过 integrationSchema 询问特定平台的发布限制和设置。

文档

简介

使用模型上下文协议（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`	列出您组织的所有分组（客户）
`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 密钥相同。

连接

使用 `/mcp` 端点，并将您的 API 密钥或 OAuth 令牌作为 Bearer 令牌：

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

此方法同时支持 API 密钥和 OAuth 令牌（以 `pos_` 为前缀）。

使用 `/mcp/:apiKey` 端点，并将您的 API 密钥嵌入 URL 中：

```text theme={null}
URL: https://mcp.postiz.com/mcp/your-api-key
```

快速示例

以下是 AI 代理使用 Postiz MCP 时的典型交互过程：

代理调用 integrationList，获取您已连接的账户（X、LinkedIn 等）
代理调用 integrationSchema，传入 platform: "x"，了解 X 的字符限制、设置和规则
代理调用 schedulePostTool，以正确的格式安排您的帖子

当您对 AI 代理说类似这样的话时，这一切都会自动发生：

“安排一个帖子到 X，明天上午 10 点：很高兴宣布我们的新功能！”

常见问题

使用 Postiz MCP 需要 OpenAI 密钥吗？

不需要。MCP 服务器只是暴露 Postiz 的工具。您的 AI 客户端（Claude、ChatGPT、Cursor 等）提供模型。只有当您使用 Postiz 自身的 AI 功能（图像生成、副驾驶）时，Postiz 才需要 OPENAI_API_KEY，这些功能与暴露给客户端的 MCP 工具是分开的。

当我的 API 密钥过期或被轮换时会发生什么？

Postiz API 密钥不会自动轮换，但如果您在设置 → 开发者 → 公共 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 构建和托管，这是一个开发者文档平台。