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 等）
代理使用 platform: "x" 呼叫 integrationSchema — 了解 X 的字元限制、設定和規則
代理呼叫 schedulePostTool — 以正確的格式排程你的貼文

當你告訴你的 AI 代理類似以下的內容時，這一切都會自動發生：

「排程一篇明天上午 10 點發布到 X 的貼文：興奮地宣布我們的新功能！」

常見問題

我需要 OpenAI 金鑰才能使用 Postiz MCP 嗎？

不需要。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 觸發。