Postiz MCP

公式

Postizでソーシャルメディアを効率化。投稿のスケジュール、パフォーマンス分析、全アカウント管理を一箇所で行えます。

postiz.pro で表示

Postiz MCPで何ができますか？

List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using generateVideoTool.

ドキュメント

はじめに

Model Context Protocol (MCP) を使用して AI エージェントを Postiz に接続する

MCP (Model Context Protocol) を使用すると、AI エージェントは Postiz と直接やり取りできます。統合の一覧表示、投稿のスケジュール設定、画像や動画の生成など、すべて標準化されたツール呼び出しインターフェースを通じて行えます。

つまり、Claude、ChatGPT、Cursor、または MCP 互換のクライアントを Postiz アカウントに接続し、自然言語でソーシャルメディアを管理できるようになります。

仕組み

Postiz は、AI エージェントに 9 つのツール を提供する 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`	組織のすべてのグループ（顧客）を一覧表示します
`integrationSchema`	プラットフォーム固有の投稿ルールと設定スキーマを取得します
`triggerTool`	プラットフォーム固有のヘルパーを実行します（例：Discord チャンネルの一覧表示）
`schedulePostTool`	投稿のスケジュール設定、下書き保存、または即時公開を行います
`generateImageTool`	投稿用の AI 画像を生成します
`generateVideoOptions`	利用可能な動画生成オプションを一覧表示します
`videoFunctionTool`	動画ジェネレーターの設定を取得します（例：利用可能な音声）
`generateVideoTool`	投稿用の動画を生成します

認証

MCP サーバーで認証する方法は 2 つあります。

API キー

Postiz の 設定 > 開発者 > 公開 API から API キーを取得します。MCP エンドポイント URL で直接使用するか、Bearer トークンとして使用します。

OAuth トークン

他の Postiz ユーザー向けのアプリを構築している場合は、OAuth2 を使用してトークンを取得します。OAuth トークンは pos_ で始まり、API キーと同じように機能します。

接続

API キーまたは OAuth トークンを Bearer トークンとして、`/mcp` エンドポイントを使用します。

```
URL: https://api.postiz.com/mcp
Authorization: Bearer your-api-key
```

この方法は、API キーと OAuth トークン（`pos_` で始まる）の両方をサポートします。

API キーを URL に埋め込んだ `/mcp/:apiKey` エンドポイントを使用します。

```
URL: https://api.postiz.com/mcp/your-api-key
```

セルフホストインスタンスの場合は、`https://api.postiz.com` をあなたの `NEXT_PUBLIC_BACKEND_URL` に置き換えてください。

クイック例

AI エージェントが Postiz MCP を使用する際の典型的なやり取りは次のとおりです。

エージェントが integrationList を呼び出す — 接続されているアカウント（X、LinkedIn など）を取得します。
エージェントが integrationSchema を platform: "x" で呼び出す — X の文字数制限、設定、ルールを学習します。
エージェントが schedulePostTool を呼び出す — 正しい形式で投稿をスケジュール設定します。

これらはすべて、AI エージェントに次のように指示するだけで自動的に行われます。

「明日の午前 10 時に X への投稿をスケジュールして: 新機能の発表に興奮しています！」

よくある質問

Postiz MCP を使用するには OpenAI キーが必要ですか？

いいえ。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 を通じてトリガーする必要があります。