Postiz MCP

公式

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

postiz.pro で表示このMCPを試すスポンサー

Postiz MCPで何ができますか？

Postiz MCPを使用すると、AIアシスタントにソーシャルメディア投稿の管理やメディアの直接生成を依頼できます。

接続済みアカウントの一覧表示 — integrationListを使用して、接続されているすべてのソーシャルメディアアカウントを取得します。グループでフィルタリングすることも可能です。
プラットフォームルールの取得 — integrationSchemaを使用して、Xなどのプラットフォームの投稿ルールと設定を取得します。
投稿のスケジュール設定 — schedulePostToolを使用して、投稿をスケジュール、下書き、または即時公開します。
予定投稿の一覧表示 — postsListToolを使用して、2つの日付の間に予定されている投稿を表示します。
画像の生成 — generateImageToolを使用して、投稿用のAI画像を作成します。
動画の生成 — generateVideoToolを使用して動画を生成します。オプションはgenerateVideoOptionsから選択できます。

ドキュメント

はじめに

Model Context Protocol（MCP）を使用してAIエージェントをPostizに接続

MCP（Model Context Protocol）により、AIエージェントは標準化されたツール呼び出しインターフェースを通じて、Postizと直接対話し、インテグレーションの一覧表示、投稿のスケジュール設定、画像や動画の生成を行うことができます。

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

仕組み

PostizはAIエージェントに11のツールを提供する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`	投稿のスケジュール設定、下書き保存、即時公開
`postsListTool`	指定した2つの日付の間にスケジュールされた組織の投稿を一覧表示（現在の設定を含む）
`postSettingsTool`	まだ公開されていないスケジュール投稿または下書きのプロバイダー設定を更新
`generateImageTool`	投稿用のAI画像を生成
`generateVideoOptions`	利用可能な動画生成オプションを一覧表示
`videoFunctionTool`	動画ジェネレーターの設定を取得（例：利用可能な音声）
`generateVideoTool`	投稿用の動画を生成

認証

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

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`エンドポイントをURLにAPIキーを埋め込んで使用します：

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

クイック例

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

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

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

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

FAQ

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

いいえ。MCPサーバーはPostizのツールを公開するだけです。モデルはAIクライアント（Claude、ChatGPT、Cursorなど）が提供します。PostizがOPENAI_API_KEYを必要とするのは、Postiz独自のAI機能（画像生成、コパイロット）を使用する場合のみで、これらはクライアントに公開される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はコメントを読み取ったり返信したりできますか？

現時点ではできません。現在のツールセットは、インテグレーションに対して読み取り専用、投稿/メディアに対して書き込み専用です。getCommentsやreplyToCommentはMCP経由では公開されていません。コメントへの返信はPostiz UIを通じて行う必要があります。