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 等）
代理以 platform: "x" 呼叫 integrationSchema，了解 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 金鑰不會自動輪換，但如果您在「設定 → 開發人員 → 公開 API」中重新產生金鑰，所有使用舊金鑰的 MCP 用戶端都會停止運作，直到您更新其設定。請更新用戶端設定中的 URL 或 Authorization 標頭，然後重新連線。

自架：如何公開 MCP 端點？

MCP 伺服器會隨 Postiz 後端一起啟動，可透過 /mcp（Bearer 驗證）、/mcp/:apiKey（金鑰在 URL 中）和 /mcp-oauth（OAuth 保護）存取。您的反向代理必須將這些路徑轉發到後端，並支援串流 HTTP（Transfer-Encoding: chunked）。請參閱反向代理。

MCP 可以讀取或回覆留言嗎？

目前不行。目前的工具集對整合項目是唯讀的，對貼文／媒體是唯寫的。MCP 未公開 getComments 或 replyToComment。留言回覆必須透過 Postiz 介面觸發。