Postiz MCP

官方

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

访问 postiz.pro

你可以用 Postiz MCP 做什么？

列出已关联的社交媒体账户 — 让代理使用 integrationList 检索所有已关联的平台，可选择按客户群组过滤。
检查平台发布规则 — 在发布前使用 integrationSchema 获取特定平台的字符限制、支持的媒体类型和设置。
安排或发布帖子 — 通过 schedulePostTool 创建、草稿或立即发布社交媒体帖子，并支持平台特定的格式。
为帖子生成AI图像 — 直接通过 generateImageTool 生成图像，以附加到已安排的内容中。
为帖子生成视频 — 使用 generateVideoOptions 和 videoFunctionTool 探索可用的视频选项，然后使用 generateVideoTool 创建视频。

文档

简介

使用模型上下文协议 (MCP) 将 AI 智能体连接到 Postiz

MCP（模型上下文协议）让 AI 智能体能够直接与 Postiz 交互——列出集成、安排帖子、生成图片和视频——所有这些都通过标准化的工具调用接口完成。

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

工作原理

Postiz 公开一个 MCP 服务器，向 AI 智能体提供 9 个工具。智能体发现这些工具，理解它们的模式，并代表你调用它们。

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`	安排、草稿或立即发布帖子
`generateImageTool`	为帖子生成 AI 图片
`generateVideoOptions`	列出可用的视频生成选项
`videoFunctionTool`	获取视频生成器设置（例如，可用的语音）
`generateVideoTool`	为帖子生成视频

认证

有两种方式对 MCP 服务器进行认证：

API 密钥

从 Postiz 中的 设置 > 开发者 > 公共 API 获取你的 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
```

对于自托管实例，请将 `https://api.postiz.com` 替换为你的 `NEXT_PUBLIC_BACKEND_URL`。

快速示例

以下是 AI 智能体使用 Postiz MCP 时的典型交互过程：

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

当你告诉你的 AI 智能体类似以下内容时，所有这些都会自动发生：

"安排一条明天上午 10 点发布到 X 的帖子：很高兴宣布我们的新功能！"

常见问题

使用 Postiz MCP 需要 OpenAI 密钥吗？

不需要。MCP 服务器只公开 Postiz 的工具——你的 AI 客户端（Claude、ChatGPT、Cursor 等）提供模型。Postiz 仅在你使用 Postiz 自身的 AI 功能（图片生成、副驾驶）时需要 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 触发。