Chirpie

@chirpie/mcp

AI エージェント向けの公開コネクターです。 Chirpie は、X/Twitter、Bluesky、LinkedIn、Threads、Mastodon、Instagram、Facebook、Telegram への投稿、スレッド投稿、予約投稿を 1 つの API で実現し、投稿、スレッド、予約投稿、下書き、削除、分析をカバーします。この MCP サーバーを使えば、これらすべてを Claude、Cursor、ChatGPT、その他の MCP 対応エージェントから利用できるため、「これを X と LinkedIn に投稿して、フォローアップを午前 9 時に予約して」という指示を、各プラットフォームの SDK を寄せ集めたり、OAuth の手続きをしたり、レート制限に対処したりせず、ひとこと伝えるだけで実行できます。

ホステッドサーバー（推奨）

インストールは不要です。クライアントの接続先を次に設定してください。

https://chirpie.ai/mcp

プロンプトが表示されたらサインインすれば、接続完了です。コピーする API キーも、更新し続けるものもありません。

Claude Code

claude mcp add --transport http chirpie https://chirpie.ai/mcp

Claude：Claude Connectors Directoryから Chirpie を追加するか、Customize → Connectors → + → Add custom connector → https://chirpie.ai/mcp の順に選択します（ガイド）。

Cursor：.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "chirpie": {
      "url": "https://chirpie.ai/mcp"
    }
  }
}

ChatGPT（ウェブ、開発者モード）：Settings → Apps → Create → MCP server URL https://chirpie.ai/mcp → OAuth → Scan Tools（ガイド）

OAuth ではなくキーを使いたい場合（CI、スクリプト、OAuth フローに対応していないクライアントなど）は、ヘッダーとして送信してください。

{
  "mcpServers": {
    "chirpie": {
      "type": "http",
      "url": "https://chirpie.ai/mcp",
      "headers": { "Authorization": "Bearer chirpie_sk_your_key_here" }
    }
  }
}

ローカルサーバー（このパッケージ）

同じツールセットを stdio 経由でローカル実行します。

npm install -g chirpie
chirpie login

Claude Code

claude mcp add chirpie -- npx @chirpie/mcp

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "chirpie": {
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

Cursor：MCP 設定に追加します。

{
  "mcpServers": {
    "chirpie": {
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

ローカルサーバーは、次の順序で認証情報を読み込みます。

1. CHIRPIE_API_KEY 環境変数
2. chirpie login によって書き込まれる ~/.chirpie/config.json

CLI とこのサーバーは同じ設定を使うため、chirpie login を 1 回実行すれば、両方で利用できます。

ツール

ツール	機能
chirpie_upload_media	画像または動画をアップロードし、投稿に添付できる ID を取得します。idempotency_key を指定すると、安全に再試行できます
chirpie_post	接続済みのアカウントに、今すぐ、予約投稿、または複数アカウントへの同時投稿を行います。configuration を指定すると、フィード投稿ではなくストーリーまたはリールとして公開します。timezone を指定すると、オフセットのない schedule_at を IANA タイムゾーンとして解釈します。idempotency_key を指定すると、安全に再試行できます。代わりに draft を指定すると、下書きとして保存します
chirpie_thread	1 つまたは複数のアカウントに、2～25 件の投稿からなるスレッドを投稿します。timezone と idempotency_key も指定できます。代わりに draft を指定すると、下書きとして保存します
chirpie_list_posts	ステータス、アカウント、または複数アカウントへの同時投稿グループで絞り込んで、投稿を一覧表示します
chirpie_get_post	1 件の投稿を取得します
chirpie_update_post	まだ公開されていない投稿を編集するか、下書きを完成させて予約または公開します。configuration で公開先を変更します
chirpie_retry_first_comment	投稿に失敗した最初のコメントを再投稿します。idempotency_key を指定すると、安全に再試行できます
chirpie_delete_post	プラットフォームから投稿を削除します。Chirpie では削除済みとして保持されます
chirpie_hide_post	Chirpie の一覧から投稿を非表示にします。プラットフォームには何も送信されません
chirpie_unhide_post	非表示にした投稿を一覧に戻します
chirpie_list_accounts	接続済みのソーシャルアカウントを、アクティブと非アクティブの両方を含めて一覧表示します
chirpie_activate_account	アカウントをアクティブにして、投稿できるようにします
chirpie_deactivate_account	アカウントを非アクティブにします（接続は維持され、プラン枠が空きます）
chirpie_disconnect_account	アカウントの接続を解除します（接続を終了し、予約済みの投稿をキャンセルして、プラン枠を空けます）
chirpie_analytics	公開済み投稿のエンゲージメント指標を取得します。refresh を指定すると、保存済みスナップショットではなく、その時点でプラットフォームに問い合わせます。1 投稿につき 5 分ごとに 1 回実行できます
chirpie_create_key	API キーを作成します。必要に応じて scopes で権限を絞り込み、自分のキーよりもできることを制限できます
chirpie_list_keys	API キーを一覧表示します
chirpie_revoke_key	API キーを取り消します
chirpie_connect_x	X/Twitter を接続します（認証リンクを返します）
chirpie_connect_linkedin	LinkedIn プロフィールを接続します
chirpie_connect_linkedin_pages	管理している LinkedIn ページを接続します（近日公開）
chirpie_connect_threads	Threads を接続します
chirpie_connect_instagram	via に instagram（デフォルト）または facebook を指定して、Instagram を接続します
chirpie_connect_facebook	Facebook ページを接続します
chirpie_connect_bluesky	アプリパスワードで Bluesky を接続します
chirpie_connect_mastodon	任意のインスタンスで Mastodon を接続します
chirpie_connect_telegram	Telegram ボットを接続します
chirpie_set_x_keys	X アカウントを接続するために、自分の X デベロッパーアプリを登録します
chirpie_get_x_keys_status	自分の X デベロッパーアプリが設定されているか確認します
chirpie_remove_x_keys	自分の X デベロッパーアプリを削除します

ホスト型サーバーとローカルサーバーは、まったく同じツールを公開します。ホスト型サーバーでは、 chirpie_create_key、chirpie_list_keys、chirpie_revoke_key、chirpie_remove_x_keys を使うには API キー認証が必要です。OAuth でサインインした場合、これらのツールは提供されません。OAuth 接続では、 長期間有効なキーを残したり、ほかの接続が依存する認証情報を破棄したりしてはならないためです。

実行前に確認を求めるツールはどれですか？

すべてのツールにはタイトルと標準の MCP ツールアノテーション （readOnlyHint、destructiveHint、idempotentHint、openWorldHint）が付いているため、 クライアントは実行前に呼び出しの内容を把握できます。一覧表示ツールと読み取りツールは 読み取り専用です。投稿やコメントの削除、アカウントの接続解除や無効化、予約投稿の編集、 キーの取り消し、自分の X アプリの設定や削除は破壊的な操作であり、許可されていない限り、 Claude などのクライアントは実行前に確認を求めます。 非表示、再表示、アクティブ化はどちらにも該当しません。それぞれを元に戻す方法が 明確にあります。作成ツールには冪等性のマークが付いていません。idempotency_keyを受け取る ツールは、キーを渡した場合にのみ、安全に再試行できます。キーなしでchirpie_post、 chirpie_thread、chirpie_reply_to_comment、chirpie_retry_first_commentを繰り返すと 二重に公開される可能性があり、chirpie_upload_mediaを繰り返すと、未使用のまま期限切れになる コピーがもう1つ保存されます。

1回の呼び出しで複数のアカウントを扱う

chirpie_postとchirpie_threadは、account_idの代わりに最大25個のaccount_idsを受け取ります。 応答にはgroup_idと、指定した順に並んだアカウントごとの結果が含まれ、 account_configurationsでは、個々のアカウントに独自のテキスト、メディア、またはスレッドを 設定できます。別のアカウントでプラットフォームに拒否されても、正常に処理されたアカウントの 投稿は公開されたままなので、エージェントは各結果のsuccessを確認する必要があります。 chirpie_list_postsにgroup_idを渡すと、グループ全体を読み取れます。

最初のコメント

chirpie_postとchirpie_threadはfirst_commentを受け取り、投稿の公開と同時にその投稿の下に コメントを公開します。スレッドの場合、コメントはスレッド全体に対して1つで、最後の部分の下に 公開されます。対応するのはX、Threads、Instagram、Facebookのみです。それ以外ではコメントが 破棄されるのではなく、400 first_comment_unsupportedが返され、呼び出しが拒否されます。 月間の投稿数には1件としてカウントされます。

複数アカウントへの呼び出しでは、account_configurationsのエントリで別途指定しない限り、 共通のfirst_commentがすべてのアカウントに適用されます。first_commentを指定したエントリは、 そのアカウントについて共通の値を置き換えます。また、"first_comment": ""を指定すると、 そのアカウントではコメントなしで投稿が公開されます。これにより、最初のコメントに対応する アカウントにはコメントを送り、対応していないプラットフォームのアカウントではコメントなしで 投稿を公開するという処理を、1回の呼び出しで行えます。

すべての投稿にはfirst_commentが含まれ、値はnullまたは { text, status, comment_id, error }です。statusはpending、posted、failedのいずれかです。 最初のコメントが失敗しても投稿自体は失敗しないため、公開済みの投稿に、公開されなかったコメントが 紐づいている場合があります。chirpie_retry_first_commentで再送でき、 chirpie_update_postでテキストを変更するか、空文字列を指定して削除できます。

ストーリー、リール、その他の公開オプション

chirpie_post、chirpie_thread、chirpie_update_post は、プラットフォームごとの公開オプションである configuration を受け取ります。オプションはプラットフォームをキーとして指定します。Instagram では feed 投稿、story、reel を、Facebook Page では feed 投稿または story を指定できます。省略すると、すべてフィードに公開されます。

{
  "account_id": "...",
  "text": "Three minutes on how we schedule posts.",
  "media_ids": ["..."],
  "configuration": {
    "instagram": {
      "placement": "reel",
      "video_cover_timestamp_ms": 1500,
      "collaborators": ["a_co_author"],
      "share_to_feed": true
    }
  }
}

各配置には、それぞれ独自のオプションがあります。

• instagram の feed：画像は最大 10 枚、collaborators（ユーザー名は最大 3 件）、および user_tags。user_tags にはそれぞれ x と y の両方が必要です。
• instagram の story：画像または動画がちょうど 1 つ必要です。キャプションは指定できません（空のテキストを送信してください）。最初のコメントとコラボレーターも指定できません。user_tags には座標を指定することも、省略することもできます。
• instagram の reel：動画がちょうど 1 つ必要で、画像は指定できません。また、collaborators、user_tags（Instagram が座標を読み取るのは画像とストーリーのみのため、ユーザー名のみを指定します）、cover または video_cover_timestamp_ms（両方は指定できません）、share_to_feed、trial_reel を指定できます。
• facebook の feed：プレビューとして表示される link を指定できます。
• facebook の story：画像または動画がちょうど 1 つ必要です。テキスト、最初のコメント、リンクは指定できません。

指定した内容が黙って破棄されることはありません。オプションを受け付けないプラットフォームに対するブロックや、選択した配置で使えないフィールドは、プラットフォーム名とフィールド名を示す 400 configuration_unsupported エラーで拒否されます。ストーリーとリールはそれぞれ単独の投稿であるため、chirpie_thread ではどちらの配置も拒否されます。複数アカウントを指定した呼び出しでは、同じプラットフォームのすべてのアカウントに 1 つのブロックが適用されます。account_configurations にそのアカウント自身の configuration を指定すると、そのアカウントでは置き換えられます。chirpie_update_post で configuration を省略すると、投稿にすでに設定されているオプションが維持されます。一方、"configuration": {} を指定すると、通常のフィード投稿に戻ります。

Instagram アカウントの接続方法は 2 通りあり、chirpie_connect_instagram の via で選択します。instagram（デフォルト）では Instagram にサインインし、facebook では Facebook にサインインして、ユーザーが共有する Pages にリンクされた Instagram アカウントを複数まとめて接続します。配置にかかわらず、どちらの方法でも同じように公開できます。唯一の違いは公開済み投稿の削除です。Facebook 経由で接続したアカウントでは削除できますが、Instagram 経由で接続したアカウントでは 501 delete_unsupported エラーで拒否されます。別の方法ですでに接続されているアカウントを接続すると、2 つ目のアカウントが追加されるのではなく、接続方法が切り替わります。アカウント ID と公開済みの内容はそのまま維持され、削除機能の利用可否だけが変わります。2 つの方法で異なる Instagram アカウントが返された場合は、別のアカウントが追加されているため、その後にアカウント一覧をもう一度取得してください。

下書き

chirpie_post または chirpie_thread で draft: true を指定すると、コンテンツが保存され、何も送信されません。プラットフォームへの呼び出しも、クォータの消費もなく、下書きが自動的に公開されることもありません。下書きでは投稿よりも要件が大幅に緩和されるため、テキストを空にしたり、スレッドを 1 パートだけにしたりできます。応答には warnings リストが含まれ、現状のまま送信した場合に問題となる内容がアカウントごとに示されます。

chirpie_update_post で下書きを公開します。schedule_at を指定すると予約され、publish: true を指定するとすぐに送信されます。この 2 つを同時に指定することはできません。公開時には新規作成と同じルールがすべて適用され、クォータも消費されます。拒否された場合、下書きはまったく変更されません。

試してみる

接続したら、エージェントに次のように頼んでみてください。

• 「X と LinkedIn に投稿して。v2 をリリースしたばかりだけど、X の投稿は短めにして。」
• 「cron をやめた理由について、5 件の投稿からなるスレッドを下書きして、明日の午前 9 時に予約して。」
• 「直近の Bluesky の投稿の反応はどうだった？」
• 「これを下書きとして保存して。文面は明日決める。」
• 「X アカウントを接続して。」

Kiro パワー

このリポジトリのルートは、Agent Plugins 形式の Kiro パワーでもあります。plugin.json でその名前と有効化に使うキーワードを指定し、mcp.json でホスト型サーバー https://chirpie.ai/mcp を指定しています。ツールを初めて実行するときにブラウザーで Chirpie にサインインするため、API キーを貼り付ける必要はありません。

リンク

• ドキュメント：https://chirpie.ai/docs/mcp?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• API リファレンス：https://chirpie.ai/docs?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• ダッシュボード：https://chirpie.ai/dashboard?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• プライバシーポリシー：https://chirpie.ai/privacy?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• 利用規約：https://chirpie.ai/terms?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• サポート：https://chirpie.ai/support?utm_source=npm&utm_medium=readme&utm_campaign=mcp または [email protected]

MIT © Fireflo LLC

---

このリポジトリは、Chirpie モノレポ内の packages/mcp を自動的に保守するソースミラーです。ここで作成されたプルリクエストはマージできません。