Postbase

@postbasehq/mcp

オープンソースのソーシャルメディア予約投稿ツールであるPostbase向けのModel Context Protocolサーバーです。Claude、Cursor、または任意のMCPクライアントに追加すれば、AI エージェントにX、LinkedIn、Bluesky、Mastodonへの投稿やスレッドの作成・予約投稿を任せられます。（TikTokとYouTubeでは動画が必要なため、アプリから予約投稿してください。）

どこにでも投稿。AIからでも。

ホスト型サーバー（APIキー不要）

Postbaseは、APIキーの代わりにOAuthサインインを使用するサーバーをhttps://mcp.postbase.so/mcpで運用しています。このURLをClaudeまたはChatGPTのカスタムコネクターとして、あるいはCursor、VS Code、Windsurf、Claude Code、Gemini CLIのリモートMCPサーバーとして追加してください。MCP設定ジェネレーターで、それぞれに必要な設定を確認できます。

代わりにAPIキーを使いたい場合や、Postbaseをセルフホストしたい場合は、このnpmパッケージを使用してください。

クイックスタート

1. PostbaseダッシュボードのDevelopersからAPIキーを作成します。
2. MCPクライアントの設定にサーバーを追加します（以下の例を参照）。
3. エージェントに「このスレッドをXとBlueskyに午前9時に予約投稿して」と指示します。

設定例

任意のMCPクライアント — 最小限の設定：

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
    }
  }
}

Claude Desktop — 同じブロックを設定ファイルに追加します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

その後、Claude Desktopを再起動します。

Cursor — ~/.cursor/mcp.jsonに追加します（または「設定」→「MCP」から追加します）：

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": { "POSTBASE_API_KEY": "pb_live_your_key_here" }
    }
  }
}

ローカル開発 — マシン上で実行しているPostbaseインスタンスを指定します：

{
  "mcpServers": {
    "postbase": {
      "command": "npx",
      "args": ["@postbasehq/mcp"],
      "env": {
        "POSTBASE_API_KEY": "pb_live_your_key_here",
        "POSTBASE_API_URL": "http://localhost:3000/api/v1"
      }
    }
  }
}

ツール

ツール	説明
list_channels	ワークスペースに接続されているチャンネルを一覧表示します。
create_post	下書きを作成するか、投稿またはthreadを予約投稿します。channel_ids、scheduled_at（オフセット付きISO 8601形式）または schedule_in_minutes、チャンネルごとのテキストを指定するchannel_bodies、media_idsまたはmedia_urls、youtubeの詳細、再試行時の二重投稿を防ぐidempotency_keyを指定できます。TikTokへの投稿は下書きとしてのみ作成できます。
get_post	各チャンネルでの投稿状況（ステータス、公開URL、エラー、再試行時刻、最新の指標）を取得します。
update_post	下書きまたは予約投稿を編集または再予約します。変更されるのは指定したフィールドのみです。
retry_post	失敗したチャンネルに投稿を再送信します。
get_analytics	投稿およびチャンネルごとのインプレッション、いいね、コメント、シェア、保存数と合計を取得します。
list_media	IDを指定して添付できるよう、Postbaseメディアライブラリ内の画像と動画を一覧表示します。
add_media	公開HTTPSリンクからメディアライブラリに画像または動画を追加します。
list_scheduled	予約投稿、またはstatusを指定して下書き、公開済み、失敗した投稿を一覧表示します。
cancel_post	IDを指定して予約投稿をキャンセルします（下書きに戻ります）。
schedule_thread	スレッド（順序どおりのtweets）を作成します。古い設定との互換性のために残されています。同じ処理はthreadを指定したcreate_postでも行えます。

環境変数

変数	必須	デフォルト
POSTBASE_API_KEY	はい	—
POSTBASE_API_URL	いいえ	https://www.postbase.so/api/v1

マシン上のPostbaseインスタンスを使ってローカル開発する場合は、 POSTBASE_API_URL=http://localhost:3000/api/v1を設定します。

ライセンス

AGPL-3.0-or-later。オープンソースのPostbaseプロジェクトの一部です。