post2all

post2all Agent Plugin

post2all Agent Plugin は、AI コーディングアシスタントが post2all を通じて投稿の作成、スケジュール設定、確認、更新、キャンセル、管理、分析を行えるようにします。共有のエージェントガイダンスに加え、対応クライアント向けのホスト型 Model Context Protocol 接続が含まれています。

https://mcp.post2all.com/mcp

機能

• 接続済みのソーシャルアカウントと、それぞれの公開機能を一覧表示します。
• 対応プラットフォームの正規化されたアカウント分析、時系列データ、前期間との比較を読み取ります。
• プロバイダーがアカウントの投稿検出に対応している場合、post2all 外で公開された投稿も含め、プロバイダー全体の投稿パフォーマンスを比較します。
• post2all の複数プラットフォーム投稿について、各投稿先の分析を個別に読み取ります。
• 下書き、スケジュール済み、公開中、公開済み、一部失敗、失敗の投稿を確認します。
• テキストやメディア（画像、動画、またはプラットフォームが許可する場合はその両方）を任意で指定して投稿を作成します。
• すべてのプラットフォームで PNG 入力を受け付けます。Instagram と TikTok では公開時に PNG 画像を自動的に JPEG に変換し、その他のプラットフォームでは PNG の透過情報を保持します。
• 下書きの保存、公開日時の予約、または即時公開を行います。
• 投稿先アカウントごとに設定を個別に適用します。
• Discord チャンネルや TikTok のプライバシー設定など、動的な公開オプションを検出します。
• 保持されているメディアが利用可能な間は、下書き、スケジュール済み、失敗、一部失敗の投稿を更新し、スケジュール済みの投稿をキャンセルします。
• 公開済みの投稿先について deletion.available と deletion.reason を確認し、削除が公式にサポートされているプラットフォームで、確認済みの公開済みソーシャル投稿を1件削除します。
• 明示的に要求された場合は、post2all から投稿を削除します。このローカルでの削除によって、ソーシャルプラットフォームにすでに公開されたコンテンツが削除されることはありません。

実際に利用できる機能は、接続済みアカウント、プラットフォームの制限、ワークスペースの権限、post2all のプランによって異なります。

SaaS アカウントの組み込みオンボーディング

post2all は、ソーシャルバックエンドとして post2all を利用する製品向けに、ヘッドレスの REST／SDK アカウント接続フローも提供しています。このフローは MCP とは別のものです。MCP ではアカウント接続や再接続のツールを公開していません。

Business、Agency、および手動でオンボーディングされたクレジットワークスペースでは、オプションの Profiles を追加で利用して、同じワークスペース内のクライアント、ブランド、SaaS 顧客を整理できます。Business では 2 個、Agency では最大 10 個、クレジットワークスペースでは最大 10,000 個のプロファイルを利用できます。Profiles は MCP または CLI から管理・絞り込みできます。REST／SDK の統合では、x-profile-id（または client.forProfile(profileId)）を組織コンテキストとして使用します。Profiles は独立したセキュリティテナントではなく、アカウントを移動しても既存の投稿先には影響しません。プロバイダーの OAuth アカウント接続そのものは、引き続き REST／SDK／CLI のフローで行います。

組み込み型の本番環境向け投稿では、REST API と TypeScript SDK を通じて、冪等性のある投稿作成、リクエスト／レート制限のメタデータ、クレジット請求と投稿容量の確認、X API の正確なマークアップなしの価格設定、および署名付き Webhook の検証を利用できます。クレジットを利用するワークスペースでは、URL なしの X 投稿は 0.015 ドル、URL ありの投稿は 0.20 ドルがプリペイドクレジットから差し引かれます。通常のサブスクリプションでは、従来どおり付属の X 利用枠が適用されます。クレジットワークスペースのオーナー／管理者は post2all ダッシュボードで Webhook エンドポイントを設定し、一度だけ表示されるシークレットをコピーできます。Webhook 管理は意図的に REST、SDK、CLI、MCP では公開していません。SDK クイックスタートとWebhook ガイドを参照してください。

SaaS バックエンドは、ワークスペースの API キーを使用して接続を開始し、返されたソーシャルプロバイダーの認証 URL にエンドユーザーのブラウザーを誘導し、独自の HTTPS コールバック URL を指定します。ユーザーが認証するのはソーシャルネットワークであり、post2all ではありません。post2all はプロバイダーのコールバックを完了し、不透明な接続 ID／ステータスとともにブラウザーを SaaS にリダイレクトします。その後、SaaS バックエンドは認証済みの接続ステータスエンドポイントを通じて結果を検証します。

エンドユーザーに post2all のアカウント、ログイン、ブラウザーセッションは不要です。また、SaaS の API キーをフロントエンドコードに配置してはいけません。アカウント接続ガイドとREST API リファレンスを参照してください。

エージェントは、まずアカウントを一覧表示し、選択したすべてのアカウント ID を指定して publishing_schema を 1 回呼び出してから投稿を作成してください。このツールは、公開されている投稿機能、固定の選択肢、X のサブスクリプション制限などのアカウント別の上書き設定のみを返します。スキーマでアカウントの検出が求められている場合（Discord チャンネルや TikTok クリエイターの制限など）に限り、publishing_options を呼び出してください。固定の投稿タイプは送信しないでください。投稿の形式は添付されたメディアから推定されます。プラットフォームで media.allowMixedMedia が設定されている場合に限り、画像と動画を混在させることができます。

選択した機能に media.convertPngToJpeg: true が含まれる場合、PNG の変換は投稿時に自動で処理されるため、MCP や API に追加のフィールドを指定する必要はありません。元のメディアまたはクロップ済みの派生ファイルが存在しない、あるいは削除されている場合、影響を受ける投稿先のみが MEDIA_UNAVAILABLE とメッセージ Media is unavailable. を返して失敗し、ほかの投稿先はそれぞれ独立して処理を継続します。

MCP では、投稿先を構成したあと、投稿を作成する前に、読み取り専用の post_validate ツールを呼び出してください。

対応クライアント

このリポジトリには、次のクライアント向けのメタデータと共通ガイダンスが含まれています。

• Claude Code
• OpenAI Codex
• Cursor
• Gemini CLI
• リモート HTTP MCP サーバーに対応した MCP 互換クライアント
• @post2all/cli パッケージにシェルアクセスできるコーディングエージェント

共通の MCP 設定は、.mcp.json（Claude および Codex）と mcp.json（Cursor）にあります。server.json は公式 MCP Registry 向けのサーバー情報を記述しています。エージェント向けガイダンスは skills/post2all/SKILL.md で管理され、パッケージ化されたプラグインディレクトリにも反映されています。

始める前に

必要なもの：

• post2all アカウントとワークスペース。
• 投稿用に接続済みのソーシャルアカウントが少なくとも 1 つ。
• 対応している MCP クライアント、または post2all CLI。
• MCP OAuth 同意フロー用のブラウザー。

ホスト型 MCP サーバーでは OAuth 2.1 を使用します。CLI ではローカルに設定した post2all API キーを使用します。エージェントがユーザーに API キーをチャットに貼り付けるよう求めることは絶対にありません。

Claude の設定

Claude プラグインディレクトリから post2all をワンクリックでインストールします。Claude が初めて post2all に接続するときに、ブラウザーで OAuth フローを完了します。

Claude Code の設定

claude plugin marketplace add zexahq/post2all-agent
claude plugin install post2all@post2all-plugins

Claude が初めて post2all に接続するときに、ブラウザーで OAuth フローを完了します。

Codex の設定

codex plugin marketplace add https://github.com/zexahq/post2all-agent
codex plugin add post2all@post2all-agent

MCP を手動で設定する場合：

[mcp_servers.post2all]
url = "https://mcp.post2all.com/mcp"

ブラウザーでサインインし、エージェントに使用させる post2all ワークスペースを承認します。

Cursor の設定

Cursor Marketplace から post2all をインストールするか、~/.cursor/mcp.json にサーバーを手動で追加します。

{
  "mcpServers": {
    "post2all": { "url": "https://mcp.post2all.com/mcp" }
  }
}

Cursor が初めて post2all に接続するときに、ブラウザーで OAuth フローを完了します。

Gemini CLI の設定

gemini extensions install https://github.com/zexahq/post2all-agent

次に、Gemini CLI 内で /mcp auth post2all を実行し、ブラウザーで OAuth フローを完了します。

ターゲットと配信モデル

各配信先は、プラットフォーム識別子、ソーシャルアカウント ID、設定を含むターゲットとして表されます。

{
  "targets": [
    {
      "platform": "discord",
      "accountId": "acc_discord_123",
      "settings": {
        "channelId": "1234567890",
        "autoCrosspost": true
      }
    },
    {
      "platform": "threads",
      "accountId": "acc_threads_123",
      "settings": {
        "caption": "A shorter Threads version",
        "topicTag": "buildinpublic"
      }
    }
  ],
  "delivery": {
    "mode": "scheduled",
    "scheduledAt": "2026-07-20T09:00:00+05:30"
  }
}

platform の値によって、使用する設定スキーマが正確に選択されます。プラットフォーム間で無効なフィールドを指定すると拒否されます。同じプラットフォーム上の複数のアカウントは、それぞれ別のターゲットです。

配信モードは次のとおりです。

• draft：公開せずに保存します。ターゲットと未完了の設定は省略できます。
• now：すぐに公開します。
• scheduled：タイムゾーン対応の ISO 8601 タイムスタンプで指定した時刻に公開します。

CLI の使用例

post2all config whoami --json
post2all constraints <accountId...> --json
post2all accounts --json
post2all account publishing-options acc_discord_123 --json
post2all account analytics acc_instagram_123 --json
post2all account analytics-posts acc_instagram_123 --sort-by views --json
post2all post analytics post_abc --json

下書きを作成する：

post2all post create \
  --content "Work in progress" \
  --delivery draft \
  --json

すぐに公開する：

post2all post create \
  --content "New release shipping today 🚀" \
  --targets '[{"platform":"linkedin","accountId":"acc_linkedin_123","settings":{}}]' \
  --delivery now \
  --json

予約投稿する：

post2all post create \
  --content "Scheduled update" \
  --targets '[{"platform":"linkedin","accountId":"acc_linkedin_123","settings":{}}]' \
  --delivery scheduled \
  --scheduled-at "2026-07-20T09:00:00+05:30" \
  --json

プロンプトの例

• 「接続済みの post2all アカウントを一覧表示してください。」
• 「このアカウントで利用できる Discord チャンネルを表示してください。」
• 「この変更履歴をもとに LinkedIn の投稿の下書きを作成してください。」
• 「このお知らせを明日の午前 9 時（IST）に予約投稿してください。」
• 「LinkedIn と Threads に投稿してください。ただし、Threads では短い文面を使ってください。」
• 「今週の予約投稿を表示してください。」
• 「過去 30 日間の Instagram アカウント分析を表示してください。」
• 「最近の投稿のうち、最も閲覧数が多かったものはどれですか？」
• 「この投稿の各プラットフォームターゲットの分析を表示してください。」
• 「予約済みのローンチ投稿をキャンセルしてください。」

認証と権限

• MCP のアクセス範囲は、OAuth を通じて承認されたワークスペースに限定されます。
• エージェントが実行できる操作は、ユーザーの post2all アカウントとプランで許可されているものに限られます。
• MCP セッションを長期間維持するには、クライアントが要求するスコープでリフレッシュトークンが利用できる必要があります。
• アクセスは post2all のアカウント設定から取り消せます。

安全性

すぐに公開する操作、時間が重要な予約投稿、公開済み投稿の削除、post2all レコードの破壊的な削除を確認する前に、内容を確認してください。確認が必要なワークフローでは下書きを優先してください。公開中のソーシャル投稿を削除する前に、post_get を使用し、deletion.available が true であることを確認して、対象のアカウントとプラットフォームを正確に表示したうえで、明示的な確認を得てください。削除できない場合は、deletion.reason を使って理由を説明してください。この実行時の状態には、公開ロールアウトと現在のアカウント／プラットフォームの制約がすでに反映されています。プライベートロールアウト中のプラットフォームは、公開 MCP／CLI サーフェスでは引き続きブロックされます。post2all レコードの削除は別の操作であり、公開中のソーシャルコンテンツは削除されません。

トラブルシューティング

• ツールが表示されない場合は、プラグインまたは MCP サーバーが有効になっていることを確認してください。
• 認証に失敗した場合は、OAuth サインインをやり直してください。
• アカウント ID またはプラットフォームが拒否された場合は、アカウントを再度一覧表示してください。
• 必須の動的設定が見つからない場合は、アカウントの投稿オプションを読み込んでください。
• 公開に失敗した場合は、メディアの種類、サイズ、ターゲットプラットフォームの対応状況、必須設定を確認してください。
• MEDIA_UNAVAILABLE が発生した場合は、対象ターゲットを再試行する前に、不足している元メディアまたはクロップ済みの派生メディアを復元するか、再アップロードしてください。

Links

• post2all: https://www.post2all.com
• MCP setup: https://www.post2all.com/docs/mcp
• REST API: https://www.post2all.com/docs/api-reference
• Privacy policy: https://www.post2all.com/privacy-policy
• Repository: https://github.com/zexahq/post2all-agent
• Issues: https://github.com/zexahq/post2all-agent/issues