PostSider

@postsider/mcp

AI エージェントが、公開 API を通じて PostSider インスタンスに選択的にアクセスできるようにする MCP（Model Context Protocol）サーバーです。Claude Code、Claude Desktop、Codex、Cursor、および MCP 互換のあらゆるクライアントで利用できます。クラウド版 （api.postsider.com）またはセルフホスト版のインスタンスに接続し、組織 API キーで認証します。

PostSider は共有運用カレンダーです。エージェントが作業を準備してスケジュールし、実際に公開される内容を人間が確認します。

インストール

1. API キーを作成する

PostSider で Settings -> API を開き、組織 API キーを生成します。

2. クライアントを接続する

Claude Code：

claude mcp add postsider -e POSTSIDER_API_KEY=your_api_key -- npx -y @postsider/mcp

Claude Desktop または汎用 MCP クライアント：

{
  "mcpServers": {
    "postsider": {
      "command": "npx",
      "args": ["-y", "@postsider/mcp"],
      "env": {
        "POSTSIDER_API_KEY": "your_api_key"
      }
    }
  }
}

3. 読み取り専用のプロンプトで確認する

エージェントに質問し、何も変更せずに回答することを確認します。

List my connected PostSider channels. Do not create or modify anything.

次に：

Show my PostSider calendar for the next 14 days. Do not create or modify anything.

4. その後で下書きを準備する

Create one draft only for the selected channel. Show me the exact content first. Do not publish it.

ソースからインストール

pnpm --filter @postsider/mcp build

次に、ビルド済みのエントリポイントをクライアントに指定します。

{
  "mcpServers": {
    "postsider": {
      "command": "node",
      "args": ["/absolute/path/to/apps/mcp/dist/index.js"],
      "env": {
        "POSTSIDER_API_KEY": "your_api_key",
        "POSTSIDER_API_URL": "https://api.postsider.com"
      }
    }
  }
}

Claude Code プラグイン

パッケージディレクトリは Claude Code プラグインとしても機能します。.claude-plugin/plugin.json では API キーをシークレットのユーザー設定として宣言し、.mcp.json では固定されたリリースバージョンでこのサーバーを起動します。また、skills/ にはカレンダーの確認、コンテンツの公開、承認、分析、代理店業務に特化したワークフローが含まれています。リポジトリのルートはプラグインマーケットプレイスのため、プラグインはリポジトリから直接インストールします。

スキルの上限に達しています（5/5）。 リモートサーバーは、OpenAI のスキル拡張機能を通じて同梱するスキルを公開します。この拡張機能でサポートされるのは最大 5 個です。5 つすべての枠が埋まっているため、新しいスキルを追加するには既存のスキルを廃止するか統合する必要があります（5 個を超えると loadSkillCatalog は安全側に失敗します）。

claude plugin marketplace add lumizone/postsider
claude plugin install postsider@postsider

インストール時に --config api_key=your_api_key を指定するか、Claude Code 内で /plugin configure postsider@postsider を実行して後から設定すると、キーはプラグインの外部に保存されます。キーがプラグインディレクトリに書き込まれることはありません。

エージェントができること

ツールは 37 個（ローカルの stdio サーバーでは 38 個）あり、すべて postsider_ で始まります。

読み取り

ツール	操作
postsider_list_channels	接続済みのソーシャルチャンネルを一覧表示します（ID、名前、プラットフォーム）。最初に呼び出してチャンネル ID を取得します。
postsider_get_agency_overview	組織全体の概要：顧客、チャンネル、キュー内、下書き、公開済み、エラー、承認待ち。
postsider_get_customer_report	特定の顧客に絞り込んだ同じレポート。
postsider_list_groups	チャンネルグループを一覧表示します。
postsider_list_media	メディアライブラリをページ分割・検索して閲覧し、アップロード済みのファイルを再利用します。
postsider_get_channel_rules	1 つのチャンネルのプラットフォームルール、最大文字数、および必須の settings スキーマ。新しいチャンネルに投稿する前に呼び出します。
postsider_get_queue_plan	チャンネルの定期投稿枠とタイムゾーン。
postsider_get_smart_slots	予約済みの枠を避けた、チャンネルの次回以降の最適な投稿時刻。
postsider_get_content_library	保存済みのハッシュタググループ、キャプションテンプレート、UTM プリセット。
postsider_find_slot	チャンネルの次の空きキュー枠（UTC）。
postsider_list_posts	指定した期間の投稿を一覧表示します。state（例：ERROR）とチャンネルで絞り込みでき、ページ分割されます。
postsider_get_post	公開エラーがある場合はその内容も含めた、投稿の詳細情報。
postsider_get_post_missing_fields	チャンネルごとの検証上の問題。公開前に修正できます。
postsider_get_post_analytics	1 件の投稿の分析データ。
postsider_get_channel_analytics	チャンネルのアカウントレベルの分析データ。
postsider_get_notifications	最近の通知：公開失敗、再接続が必要なチャンネル。
postsider_get_publishing_state	組織の公開が有効か一時停止中かを示します。
postsider_get_approval_status	下書きの承認状況。却下された場合はレビュー担当者のメモも含みます。

書き込み

ツール	操作	リスク
postsider_create_post	下書き、予約投稿、または各チャネルへの即時公開として投稿を作成します。	コンテンツを作成し、公開する場合があります
postsider_update_post	既存の投稿をその場で編集します。対象はテキスト、メディア、日付、設定、最初のコメントです。公開済みまたは承認待ちの投稿には使用できません。	コンテンツを変更し、予約投稿を再設定します
postsider_update_post_status	投稿を draft と schedule の間で切り替えます。	元に戻せます
postsider_request_approval	下書きを人間による承認キューに送ります。	元に戻せます
postsider_upload_media_from_url	公開 HTTPS URL からメディアをライブラリにインポートします。	メディアを作成します
postsider_upload_media_base64	バイトデータとして保持している画像または MP4 をアップロードします（base64：ローカルサーバーでは 25 MB、リモート接続では 2.5 MB）。公開 URL は不要です。	メディアを作成します
postsider_upload_media_from_file	ローカル stdio サーバーのみ。 お使いのマシン上のファイルパスから画像または動画（jpg、png、gif、webp、avif、bmp、tiff、mp4、mov、webm、mkv。最大 500 MB）をアップロードします。その他のファイル形式は、読み取る前に拒否されます。	メディアを作成します
postsider_connect_channel	ソーシャルアカウントを接続または再接続するためのサインインリンクを取得します（ユーザーはプラットフォーム上で承認します）。channels:write が必要です。	接続を開始します
postsider_set_channel_enabled	チャネルを有効または無効にします。channels:write と管理者ロールが必要です。	元に戻せます
postsider_disconnect_channel	チャネルを切断します。未公開の投稿は下書きになります。channels:write が必要です。	取り消しできません
postsider_set_queue_plan	チャネルの投稿枠（{time, days?}：午前 0 時からの分数、任意の曜日 0～6）を置き換えます。先にプランを読み取ってください。全体が置き換えられます。channels:write と管理者ロールが必要です。	設定を置き換えます
postsider_set_channel_customer	名前を指定して、チャネルをクライアントに割り当てます。channels:write と管理者ロールが必要です。	元に戻せます
postsider_save_library_item	ハッシュタググループ、キャプションテンプレート、または UTM プリセットを作成または更新します。	コンテンツを作成します
postsider_delete_library_item	ライブラリアイテムを削除します。	取り消しできません
postsider_duplicate_post	投稿を新しい下書きとしてコピーします。別のチャネルにコピーすることもできます。	下書きを作成します
postsider_check_post	最大 3 つのプラットフォーム向けに、下書きのテキストを AI でチェックします（月間 AI 利用枠を使用します）。	AI 利用枠を使用します
postsider_rewrite_post	選択したトーンでテキストを AI で書き直します（月間 AI 利用枠を使用します）。	AI 利用枠を使用します
postsider_delete_media	ライブラリとストレージからメディアファイルを削除します。	取り消しできません
postsider_delete_post	投稿をそのすべてのチャネル版とともに完全に削除します（1 グループ）。先に投稿を読み取ってください。	取り消しできません
postsider_pause_publishing	組織全体の緊急停止です。再開できるのは人間のみです。	取り消しできません

アクセススコープ（リモートサーバー）

スコープ	許可される操作
posts:read	すべての読み取りツール。
posts:write	投稿、メディア、ライブラリ、複製、AI チェック。
channels:write	チャネルの接続、有効化、無効化、投稿時刻の変更、再割り当て、切断。投稿の予約のみが許可されたエージェントがワークスペースを再設定できないよう、個別に付与されます。このスコープが導入される前に作成された接続でこのスコープを取得するには、再接続が必要です。

請求、チームとロール、API キー、MFA、アカウントの削除、および一時停止した ワークスペースの再開は、意図的にエージェントから利用できないようにしており、ダッシュボードでのみ操作できます。

各ツールは readOnlyHint、destructiveHint、idempotentHint、openWorldHint を明示的に宣言しているため、 クライアントは読み取り操作と緊急停止を区別できます。

設定

変数	必須	デフォルト	説明
POSTSIDER_API_KEY	はい	-	組織の API キー（Settings -> API）
POSTSIDER_API_URL	いいえ	https://api.postsider.com	インスタンスのベース URL

POSTSIDER_API_URL は HTTPS である必要があります。プレーン HTTP が許可されるのは、ローカル開発用のループバック （localhost、127.0.0.1、[::1]）に限られます。

セルフホスト可能なインスタンスの場合は、公開 API が提供されている場所を POSTSIDER_API_URL に指定します。同梱の nginx の背後では、API は /api の下にあるため、 ドメインに /api を追加して指定します。例：https://social.example.com/api。サーバーは、 指定した値に /public/v1 を追加します。

安全性

• API キーは環境変数から読み取られ、設定された PostSider API URL にのみ送信されます。表示、ログへの記録、エラーメッセージへの 含め込みは行われません。
• POSTSIDER_API_URL に埋め込まれた認証情報は拒否されます。
• リダイレクトは追従せず、拒否されます。リダイレクトにより、認証済みリクエストが 設定されたオリジンから別の場所へ送られるため、クライアントは 対処方法がわかるメッセージを表示して失敗します。
• リクエストは 30 秒でタイムアウトし、失敗したレスポンス本文は報告前に 最大 8 KB まで読み取られます。
• ツールの引数は、ネットワーク呼び出しの前にローカルで検証されます。ID は 空であってはならず、日付は実在する ISO 8601 の日付である必要があります （2026-02-30 は API に送信されず、拒否されます）。投稿のステータスは draft または schedule で、メディアのインポートには公開 HTTPS URL が必要です。
• API キーがない場合は、stderr に説明メッセージを出力して終了コード 1 で終了します。stdout には プロトコルフレームのみが出力されます。

開発

pnpm --filter @postsider/mcp typecheck
pnpm --filter @postsider/mcp typecheck:tests
pnpm --filter @postsider/mcp test
pnpm --filter @postsider/mcp build
pnpm --filter @postsider/mcp version:gate
pnpm --filter @postsider/mcp validate:registry
pnpm --filter @postsider/mcp smoke:tarball
claude plugin validate --strict apps/mcp

設計

このサーバーは、選択した /public/v1 REST API エンドポイントをラップする薄い層で、 API キーをそのまま使って認証します。バックエンドには依存せず、@modelcontextprotocol/sdk と zod のみを 取り込むため、軽量で保守しやすい構成です。すべてのツール登録は単一のファクトリーに 集約されているため、現在の stdio トランスポートと将来のあらゆるトランスポートで、エージェント向けの インターフェースを共有できます。