Postiz MCP
公式Postizでソーシャルメディアを効率化。投稿のスケジュール、パフォーマンス分析、全アカウント管理を一箇所で行えます。
Postiz MCPで何ができますか?
- 接続済みアカウントの一覧表示 — エージェントに、接続済みのソーシャルメディアアカウントを一覧表示するよう依頼します。必要に応じてグループで絞り込めます。
- プラットフォームのルールを確認 — 投稿を作成する前に、プラットフォーム固有の投稿ルールと設定スキーマを取得します。
- 投稿の予約または公開 — 接続済みアカウントへの投稿を予約、下書きとして保存、またはすぐに公開します。
- 予約済み投稿を確認 — 2つの日付の間に予約されている組織の投稿を、現在の設定とともに一覧表示します。
- メディアを生成 — 投稿用のAI画像や動画を生成し、利用可能な動画生成オプションを一覧表示します。
- 長い動画をクリップに分割 — 長いYouTube動画から字幕付きの縦型クリップと下書き投稿を作成し、クリップの処理状況を確認します。
ドキュメント
はじめに
Model Context Protocol (MCP) を使って AI エージェントを Postiz に接続する
MCP (Model Context Protocol) を使うと、AI エージェントは Postiz と直接やり取りできます。連携サービスの一覧表示、投稿のスケジュール設定、画像や動画の生成、長い動画のショート動画への切り抜きなどを、標準化されたツール呼び出しインターフェースを通じて実行できます。
つまり、Claude、ChatGPT、Cursor、または MCP 対応クライアントを Postiz アカウントに接続し、自然言語でソーシャルメディアを管理できます。
仕組み
Postiz は、AI エージェントに 13 個のツールを提供する MCP サーバーを公開しています。エージェントはこれらのツールを検出し、スキーマを理解して、ユーザーに代わって呼び出します。
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 | 2 つの日付の間にスケジュールされた組織の投稿を、現在の設定とともに一覧表示します |
postSettingsTool | まだ公開されていないスケジュール済み投稿または下書きのプロバイダー設定を更新します |
generateImageTool | 投稿用の AI 画像を生成します |
generateVideoOptions | 利用可能な動画生成オプションを一覧表示します |
videoFunctionTool | 動画生成の設定を取得します(例:利用可能な音声) |
generateVideoTool | 投稿用の動画を生成します |
clippingTool | 長い YouTube 動画を字幕付きの縦型クリップに変換し、投稿の下書きを作成します |
clippingStatusTool | クリップ作成の状況を確認し、完成したクリップを取得します |
認証
MCP サーバーの認証方法は 2 つあります。
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 キー
URL に API キーを埋め込んで
/mcp/:apiKeyエンドポイントを使用します。URL: https://mcp.postiz.com/mcp/your-api-key
簡単な例
AI エージェントが Postiz MCP を使うときの一般的なやり取りは次のとおりです。
- エージェントが
integrationListを呼び出し、接続済みのアカウント(X、LinkedIn など)を取得します - エージェントが
integrationSchemaをplatform: "x"とともに呼び出し、X の文字数制限、設定、ルールを確認します - エージェントが
schedulePostToolを呼び出し、正しい形式で投稿をスケジュールします
AI エージェントに次のように伝えると、これらすべてが自動的に行われます。
「明日の午前 10 時に X へ投稿をスケジュールして。新機能を発表できることを嬉しく思います!」
FAQ
Postiz MCP を使うには OpenAI キーが必要ですか?
いいえ。MCP サーバーは Postiz のツールを公開するだけです。モデルは AI クライアント(Claude、ChatGPT、Cursor など)が提供します。Postiz の独自 AI 機能(画像生成、コパイロット)を使う場合に限り、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 で構築・ホスティングされています。