Postiz MCP

公式

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

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

Postiz MCPで何ができますか？

接続済みアカウントの一覧表示 — アシスタントに、integrationList を使用してリンク済みのすべてのソーシャルメディアプロフィールを表示するよう依頼します。グループでフィルタリングすることも可能です。
投稿のスケジュールまたは公開 — アシスタントに、schedulePostTool を使用して下書きの作成、スケジュール設定、または即時公開を指示します。
AI画像の生成 — generateImageTool を使用して、投稿用のAI生成ビジュアルを直接リクエストします。
動画クリップの作成 — clippingTool を使用して、長いYouTube動画をキャプション付きの縦型ショート動画に変換し、投稿の下書きを作成します。
プラットフォームルールの確認 — スケジュール設定前に、integrationSchema を使用して特定のプラットフォームの投稿制限と設定を確認します。

ドキュメント

はじめに

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`	組織のすべてのグループ（顧客）を一覧表示
`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キーと同じように機能します。

接続

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

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

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

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

```text theme={null}
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は、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を通じて実行する必要があります。

このドキュメントは、開発者向けドキュメントプラットフォームであるMintlifyで構築・ホストされています。