Postiz MCP

官方

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

访问 postiz.pro试用此 MCP赞助

你可以用 Postiz MCP 做什么？

借助 Postiz MCP，你可以让 AI 助手直接管理社交媒体帖子并生成媒体内容。

列出已连接的账户 — 通过 integrationList 查询所有已连接的社交媒体账户，可选按分组筛选。
获取平台规则 — 使用 integrationSchema 获取 X 等平台的发帖规则和设置。
安排帖子 — 使用 schedulePostTool 安排、草拟或立即发布帖子。
列出已安排的帖子 — 使用 postsListTool 查看两个日期之间安排的帖子。
生成图片 — 使用 generateImageTool 为帖子创建 AI 图片。
生成视频 — 使用 generateVideoTool 制作视频，选项来自 generateVideoOptions。

文档

简介

使用模型上下文协议（MCP）将 AI 代理连接到 Postiz

MCP（模型上下文协议）让 AI 代理直接与 Postiz 交互，列出集成、安排帖子、生成图片和视频，全部通过标准化的工具调用接口完成。

这意味着你可以将 Claude、ChatGPT、Cursor 或任何兼容 MCP 的客户端连接到你的 Postiz 账户，并通过自然语言管理你的社交媒体。

工作原理

Postiz 暴露了一个 MCP 服务器，为 AI 代理提供 11 个工具。代理会发现这些工具、理解它们的模式，并代表你调用它们。

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`	为帖子生成视频

身份验证

有两种方式可以对 MCP 服务器进行身份验证：

API 密钥

直接在 MCP 端点 URL 中使用它，或作为 Bearer 令牌使用。

OAuth 令牌

如果你正在为其他 Postiz 用户构建应用，请使用 OAuth2 获取令牌。OAuth 令牌以 pos_ 开头，其工作方式与 API 密钥相同。

连接

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

```
URL: https://api.postiz.com/mcp
Authorization: Bearer your-api-key
```

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

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

```
URL: https://api.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 功能（图片生成、copilot）时，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 UI 触发。