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 等）
代理程式以 platform: "x" 呼叫 integrationSchema，了解 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 介面觸發。

本文件由 Mintlify 建置與託管，這是一個開發人員文件平台。