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投稿をスケジュール、下書き、または即時公開します
postsListTool2 つの日付の間にスケジュールされた組織の投稿を、現在の設定とともに一覧表示します
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 を使うときの一般的なやり取りは次のとおりです。

  1. エージェントが integrationList を呼び出し、接続済みのアカウント(X、LinkedIn など)を取得します
  2. エージェントが integrationSchema を platform: "x" とともに呼び出し、X の文字数制限、設定、ルールを確認します
  3. エージェントが 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 で構築・ホスティングされています。