Postiz MCP
官方使用 Postiz 簡化您的社交媒體管理。排程貼文、分析成效,並在單一平台管理所有帳號。
你可以用 Postiz MCP 做什麼?
- 列出已連結的帳戶 — 請代理列出您已連結的社群媒體帳戶,也可依群組篩選。
- 查看平台規則 — 在撰寫貼文前,取得各平台專屬的發文規則與設定結構。
- 排程或發布貼文 — 將貼文排程、儲存為草稿,或立即發布至已連結的帳戶。
- 檢視已排程的貼文 — 列出您組織在兩個日期之間排程的貼文及其目前設定。
- 生成媒體 — 為貼文生成 AI 圖片或影片,並列出可用的影片生成選項。
- 剪輯長影片 — 將長篇 YouTube 影片轉換為附字幕的直式短片和草稿貼文,然後查看剪輯狀態。
文件
簡介
使用 Model Context Protocol (MCP) 將 AI 代理連接至 Postiz
MCP (Model Context Protocol) 可讓 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 | 列出您組織的所有群組(客戶) |
integrationConnectTool | 取得連接新社群媒體帳戶的連結 |
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 金鑰相同。
連線
[tab] Bearer 權杖
使用
/mcp端點,並將 API 金鑰或 OAuth 權杖作為 Bearer 權杖:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-key此方法同時支援 API 金鑰和 OAuth 權杖(前綴為
pos_)。
[tab] URL 中的 API 金鑰
使用
/mcp/:apiKey端點,並將 API 金鑰嵌入 URL:URL: https://mcp.postiz.com/mcp/your-api-key
快速範例
以下是 AI 代理使用 Postiz MCP 時的典型互動:
- 代理呼叫
integrationList,取得您已連接的帳戶(X、LinkedIn 等) - 代理呼叫
integrationSchema,並傳入platform: "x",了解 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 金鑰不會自動輪替,但如果您在 Settings → Developers → Public 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 觸發留言回覆。
此文件使用開發者文件平台 Mintlify 建置並託管。