Twitter MCPサーバー：3種類と1行セットアップ

#Twitter MCPサーバーの役割

Twitter MCPサーバーは、AIエージェントに「投稿を検索する」「フォロワーを一覧にする」といったXのツールを渡す小さなプログラムです。ClaudeやCursor、Codex、VS Codeが外部のツールを呼び出すのに使うオープンな標準、Model Context Protocol（新しいタブで開きます）を通じて動作します。

指示は普通の言葉で出します。エージェントがツールを選んで引数を埋め、呼び出します。サーバーはその呼び出しをXデータへのリクエストに変換してJSONを返し、エージェントはそれをもとに答えます。リクエストを自分で書く必要はありません。エージェントは複数の呼び出しを連鎖させて、1つの仕事を終えられます。たとえば検索のあとに、見つけた各投稿者のプロフィールを調べる、といった具合です。

プロトコルは無料でオープンで、ほとんどのサーバーのコードもそうです。サーバーのコストと、サーバーがあなたのXアカウントに何をできるかを決めるのは、その背後の接続です。どの認証情報を持ち、誰が読み取りごとに課金するか、ということです。この接続によってTwitter MCPサーバーは3種類に分かれ、ツールの一覧よりもこちらのほうが多くを決めます。

#Twitter MCPサーバーの3種類

Twitter MCPサーバーは、3つの接続方式のいずれかでXに到達します。あなた自身のX開発者アプリ、ログイン済みのXアカウント、データAPIキーです。接続方式によって、セットアップの内容、読み取りのコスト、エージェントがあなたのアカウントに対してできることが決まります。

Xアカウントをまったく関与させないのはデータキー方式だけで、公式料金のごく一部で投稿を読み取れます。

• データAPIキー方式（Sorsa APIのsorsa-mcp）

  セットアップ

  Sorsa APIキー1つ

  1,000投稿の読み取り

  IDで$0.014から、検索で$0.07から

  エージェントは投稿できるか

  できない（設計上、読み取り専用）

  あなたのXアカウント

  接続されない

• あなたのX開発者アプリ方式（公式X MCP、公式X API上のオープンソースサーバー）

  セットアップ

  OAuth付きのXアプリ、そのキー、プリペイドのクレジット

  1,000投稿の読み取り

  $5.00（1投稿あたり$0.005）

  エージェントは投稿できるか

  サーバーとアプリの書き込み権限による

  あなたのXアカウント

  アプリがあなたの代わりに動作する

• あなたのXログイン方式（あなたとしてサインインするサーバー）

  セットアップ

  Xのユーザー名とパスワード、またはセッションCookie

  1,000投稿の読み取り

  ベンダー次第

  エージェントは投稿できるか

  できる（あなたとして）

  あなたのXアカウント

  ボットでログインされるため、フラグが立つ可能性あり

Xを読み取るエージェントの選択は、6つの質問で決まります。最初の呼び出しの前に何をセットアップするか、読み取りのコスト、エージェントが投稿できるか、Xアカウントが関わるか、応答の速さ、そしてツールがエージェントのコンテキストをどれだけ使うかです。表で前の4つが決まります。以下の公式X MCPの説明と、その後のセットアップのセクションで、残りを種類ごとに答えます。

#公式X MCP：必要なものと課金

公式X MCPには、あなた自身のX開発者アプリが必要で、すべての呼び出しが公式X APIの従量課金の料金で課金されます。Xは2026年6月30日に、api.x.com/mcpでホスト型サーバーを公開しました（Xの発表（新しいタブで開きます））。動作するセットアップに必要なものは、MCPのドキュメント（新しいタブで開きます）に挙げられています。

• Developer ConsoleのXアプリ（OAuth 2.0、リダイレクトURIはhttp://localhost:8080/callback）
• アプリのクライアントIDとシークレットをエージェントの設定に入れ、npxで動くローカルブリッジのxurlが読み取る
• ブラウザでの1回限りのサインイン。クライアントの起動タイムアウトを300秒以上に引き上げる
• アプリをXのPay-per-useパッケージに移行する。しないとログインがclient-not-enrolledで終わる

もっと簡単なルートは、同じアプリのアプリ専用ベアラートークンを送る方法で、Xはこれを読み取り専用と位置づけています。どちらでも、まず開発者アカウントが必要です。必要な手順のすべては、開発者アカウント不要のTwitter APIのガイドで解説しています。

このサーバーのツールは、いいねしたユーザー、リポストしたユーザー、引用したユーザー付きで投稿を読み取り、全アーカイブ検索を行い、ユーザー、タイムライン、メンション、ニュース、トレンドを調べます。書き込みはブックマークと記事です。Xのドキュメントに、投稿を作成するツールは載っていません。読み取りはすべて公式X APIの料金（新しいタブで開きます）で課金されます。投稿1件$0.005、ユーザー1件$0.010で、月300万件の投稿読み取りまでです。それを超えるとXはEnterprise契約を求めます。2026年11月22日からは、投稿とともに返される投稿者とメディアにも、ユーザー1件$0.010で課金されます（Xのお知らせ（新しいタブで開きます））。料金表の全体は、X APIの料金の解説にあります。

#1行でSorsa MCPサーバーをセットアップする

Xでのリサーチ、監視、リード獲得リスト、確認などを行うエージェントには、Sorsa APIのMCPサーバーを追加します。Claude CodeやCodexではコマンド1つ、CursorやVS CodeではJSONブロック1つで、キーはSORSA_API_KEYに入れ、最初の100回のツール呼び出しは無料です。

6つの質問への答えは、数字で示せます。APIキー1つ、ツイートは1,000件あたり$0.014から、書き込みツールはゼロ、Xアカウントにリスクなし、全プランで毎秒20リクエスト、40のツール定義が約5,800トークンです。投稿だけは意図的に対象外にしています。投稿するなら、書き込みを自分のアプリに留められる公式X APIと組み合わせてください。サーバーはあなたのコンピューター上で動作し、40のツールのどれであっても、プロフィール1件を返す場合でも投稿100件を返す場合でも、ツール呼び出し1回を1リクエストに変換します。

必要なのは、Node.js 18以降（node -vで確認）と、ローカルのMCPサーバーを実行できるアプリです。すべてのエージェント向けの行は、Sorsa MCPサーバーのページにまとまっています。

1. キーを取得します。 メールアドレスまたはGoogleアカウントでサインアップします。ダッシュボードにAPIキーが表示されます。最初の100リクエストはカード不要で、有効期限もありません。

2. エージェントにサーバーを追加します。 YOUR_API_KEYのところに自分のキーを入れます。Claude CodeとCodexはターミナルで1行、-s userを付けるとSorsa APIがすべてのClaude Codeプロジェクトで使えます。Cursorは、全プロジェクト共通なら~/.cursor/mcp.json、1つのプロジェクトだけなら.cursor/mcp.jsonからJSONブロックを読み込みます。VS Codeは.vscode/mcp.jsonを読み込み、キーを1回だけ尋ねるので、キーがファイルに残りません。

   claude mcp add sorsa -s user -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   codex mcp add sorsa --env SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp
   

   {
     "mcpServers": {
       "sorsa": {
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "YOUR_API_KEY" }
       }
     }
   }
   

   {
     "inputs": [{ "type": "promptString", "id": "sorsa-key",
       "description": "Sorsa API key", "password": true }],
     "servers": {
       "sorsa": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "sorsa-mcp"],
         "env": { "SORSA_API_KEY": "${input:sorsa-key}" }
       }
     }
   }
   

3. 動作を確認します。 エージェントに「Sorsa APIのリクエストはあと何回残っている？」と尋ねます。エージェントがget_key_usage_infoを呼び出し、これはGET /key-usage-info（新しいタブで開きます）を読み取って、リクエスト数には数えられません。答えに数字が返れば、エージェント、サーバー、キーがつながっています。Claude Codeでは、claude mcp get sorsaでも「Connected」（接続済み）と表示されるはずです。

4. 実際の質問をしてみます。 「今週のMCPサーバーに関する投稿のうち、いいねが多い50件を探して、テーマ別にまとめて」と頼んでみてください。エージェントはこれを、次のようなsearch_tweetsの呼び出しに変換し、各回答が返すnext_cursorを付けて3〜4回繰り返し（1回の呼び出しで約20投稿）、結果から要約を書きます。

   {
     "name": "search_tweets",
     "arguments": {
       "query": "\"mcp server\" min_faves:20 since:2026-10-26",
       "order": "popular"
     }
   }
   

知っておきたいこと

Claude Codeでは、サーバー名を-eの前に置きます。claude mcp add --env SORSA_API_KEY=... sorsa -- npx -y sorsa-mcpのような行は、「Invalid environment variable format: sorsa」（環境変数の形式が不正：sorsa）というエラーで失敗します。--envは複数の値を取るため、サーバー名をもう1つの値として読んでしまうからです。

--より後ろはすべてサーバーのコマンドに属するので、末尾に置いた-eはサーバーに届かず、キーがないまま起動で止まります。3つの形式をすべてClaude Code 2.1.314で実行しましたが、接続できたのは上の行だけです。

#ほかのMCPアプリ向けの行

ローカルのMCPサーバーを実行できるアプリなら、どれでもsorsa-mcpを同じ3つの設定で起動できます。コマンドはnpx、引数は-y sorsa-mcp、キーは環境変数のSORSA_API_KEYです。Grok BuildとOpenClawはターミナルから追加し、Hermes Agentは設定ファイルから読み込みます。

grok mcp add sorsa -e SORSA_API_KEY=YOUR_API_KEY -- npx -y sorsa-mcp

openclaw mcp add sorsa --command npx --arg -y --arg sorsa-mcp \
  --env SORSA_API_KEY=YOUR_API_KEY

mcp_servers:
  sorsa:
    command: "npx"
    args: ["-y", "sorsa-mcp"]
    env:
      SORSA_API_KEY: "YOUR_API_KEY"

設定の入れ場所と、接続を確認する方法は次のとおりです。

• Claude Desktop： Cursorのブロックを、「Settings」、「Developer」、「Edit Config」で開くファイルに貼り付け、アプリを完全に終了してから再起動します。ツールは「+」の下に表示されます。
• Gemini CLI： Cursorのブロックを~/.gemini/settings.jsonに貼り付け、/mcpで確認します。
• Grok Build： grok mcp doctor sorsaで確認します。
• OpenClaw： openclaw mcp doctor sorsa --probeで確認します。
• Hermes Agent： ブロックを~/.hermes/config.yamlに追加し、セッションで/reload-mcpを実行します。

ブラウザ上のClaude.ai、ChatGPT、grok.comはURLでしかサーバーを追加できないため、あなたのコンピューター上でサーバーを起動できません。同じキーでClaude DesktopかClaude Codeを使ってください。サーバーを活用するためのプロンプト集は、AIで開発にあります。

#エージェントが読み取れるもの：40のツール

Sorsa APIのMCPサーバーには、対応するAPIエンドポイントごとに1つ、合計40のツールがあり、すべて公開されたXデータを読み取ります。エージェントはあなたの依頼からツールを名前で選ぶので、どれがどれかを知っておく必要はほとんどありません。グループごとに、1回の呼び出しで得られるものは次のとおりです。

• 検索： 1回の呼び出しで約20件の投稿またはアカウント。Xの検索コマンドが使え、2006年までさかのぼれます。search_tweets、search_users、search_mentions。
• 投稿： 1回の呼び出しでIDから最大100件の投稿を、投稿者の完全なプロフィール付きで取得。get_tweet_info、get_tweet_info_bulk、get_tweet_comments、get_tweet_quotes、get_retweeters、get_article、get_trends。
• アカウント： 1回の呼び出しで最大100件のプロフィール、またはタイムラインを20投稿ずつ。get_user_info、get_user_info_batch、get_account_about、get_user_tweets。
• フォロワー： 1ページ最大200件。get_followers、get_following、get_verified_followers。
• 確認： 1回の呼び出しにつき、はいかいいえ。check_follow、check_retweet、check_quoted、check_comment、check_community_member。
• リスト、コミュニティ、スペース： メンバー、フィード、スペースの詳細。get_list_members、get_list_tweets、get_list_followers、get_community_members、get_community_tweets、search_community_tweets、get_space_info。
• ユーティリティ： IDと、残りのリクエスト数。username_to_id、id_to_username、link_to_id、get_key_usage_info。

このほかに、暗号資産アカウント向けのSorsa Scoreデータを返すツールが7つあります。エージェントが最も節約できるのはバッチ系のツールです。get_tweet_info_bulkはPOST /tweet-info-bulk（新しいタブで開きます）を、get_user_info_batchはGET /info-batch（新しいタブで開きます）を実行し、1リクエストで100件を処理します。check_followは、フォロワーリストをページ送りする代わりに、POST /check-follow（新しいタブで開きます）に1回の呼び出しで答えます。

投稿、返信、いいね、フォロー、DMの送信を行うツールはなく、投稿にいいねしたユーザー、ユーザーのいいねやブックマーク、DM、非公開アカウントを返すツールもありません。サーバーが読み取るのは公開データだけです。

#ツール呼び出し1回のコスト

Sorsa APIでは、ツール呼び出し1回が、返す内容にかかわらず1リクエスト、$0.0014からです。公式のX MCPは呼び出し内のすべての項目に課金するため、同じ20投稿の検索が、投稿1件$0.005で$0.10になります。

差は回答の大きさに応じて広がります。Sorsa APIは1リクエストの価格で最大200件を返し、各投稿の投稿者も追加料金なしで含めるからです。

• search_tweets

  返すもの

  約20投稿

  Sorsa API

  $0.0014から

  公式X APIの料金

  $0.10

  投稿者込み、11月22日から

  最大$0.30

• get_tweet_info_bulk

  返すもの

  100投稿

  Sorsa API

  $0.0014から

  公式X APIの料金

  $0.50

  投稿者込み、11月22日から

  最大$1.50

• get_user_info_batch

  返すもの

  100プロフィール

  Sorsa API

  $0.0014から

  公式X APIの料金

  $1.00

  投稿者込み、11月22日から

  $1.00

• get_followers

  返すもの

  200フォロワー

  Sorsa API

  $0.0014から

  公式X APIの料金

  $2.00

  投稿者込み、11月22日から

  $2.00

月単位の規模では、POST /search-tweets（新しいタブで開きます）の検索結果は、Sorsa APIで1,000件あたり$0.07から、公式X APIの料金では1,000投稿あたり$5.00です。IDによる検索は1回の呼び出しで100件、1,000件あたり$0.014から、GET /followers（新しいタブで開きます）によるフォロワーリストは1,000人あたり$0.007からです。エージェントの1か月分の規模を選んでください。

速度も価格と同様です。Sorsa APIは、無料アカウントを含む全プランで毎秒20リクエストに応答し、バッチ検索なら毎秒最大2,000ツイートになります。失敗した呼び出しはコストがかかりません。失敗したリクエストには課金されないからです。

#読み取り専用サーバーがエージェントに向いている理由

読み取り専用のサーバーは、投稿もフォローも、書き込みへの支払いもできません。そのため、混乱したエージェントや無限ループに入ったエージェントも、リクエストを消費するだけで、あなたの名前でXに対して行動することはありません。

• 書き込みツールはありません。 投稿、返信、いいね、フォロー、DMのツールはなく、サーバーの背後のAPIにも対応するエンドポイントがありません。post_tweetを呼ぶと、サーバーは「Tool post_tweet not found」（ツールpost_tweetが見つかりません）と答えます。
• 宛先は1つだけです。 サーバーはあなたのコンピューター上で動作し、そのコードはすべての呼び出しを、ApiKeyヘッダーにキーを付けてhttps://api.sorsa.io/v3に送ります。ソースはGitHub（新しいタブで開きます）にあり、MITライセンスです。
• Xアカウントは関与しません。 Sorsa APIは、Xのログイン情報、Cookie、アプリを一切求めません。
• 支出に上限があります。 キー1つにつき毎秒最大20リクエストで、従量課金では支出上限（デフォルトは$100）が各請求期間の上限になります。

ツールはエージェントのコンテキストにも負担をかけません。40のツール定義は約2万3,000文字、およそ5,800トークンで、Claude Codeは必要になるまで名前だけを読み込みます。結果は各投稿者のプロフィール付きの完全なJSONなので、必要なものを指定してください（「最新の50投稿」など）。Claude Codeは、ツールの結果が1万トークンを超えると警告します。

知っておきたいこと

投稿の中のテキストは、指示ではなくデータです。Xを読み取るエージェントは、AIエージェントを誘導するために書かれた投稿に出会います。読み取り専用のサーバーなら、そうした投稿によるコストはせいぜい無駄になったリクエストだけです。メールの送信やファイルの編集など、エージェントのほかのツールは、承認を必要とする設定にしておいてください。

#接続できないセットアップを直す

セットアップが失敗する原因の大半は、キーを置いた場所、Node.jsがないこと、アプリがサーバーを再読み込みしていないことです。目に見える症状に合わせて確認してください。

• Claude CodeでInvalid environment variable format: sorsa

  原因

  サーバー名が--envの直後にある

  対処

  名前を先に置く：claude mcp add sorsa -s user -e ...

• 「Failed to connect」（接続に失敗）で、サーバーの環境が空

  原因

  -eが--の後ろにあったため、npxに渡された

  対処

  -e SORSA_API_KEY=...を--の前に移す

• npx: command not found

  原因

  Node.jsがインストールされていない

  対処

  Node.js 18以降をインストールし、アプリを再起動する

• Missing SORSA_API_KEY environment variable

  原因

  設定にキーがない

  対処

  サーバーのenvにSORSA_API_KEYを追加する

• すべての呼び出しが401 invalid api keyを返す

  原因

  キーの入力ミス

  対処

  ダッシュボードから、スペースなしで貼り付け直す

• しばらくすると呼び出しが403を返す

  原因

  リクエストを使い切った

  対処

  プランをアップグレードするか、従量課金をオンにする。同じキーがそのまま使える

• サーバーは追加されたが、ツールが表示されない

  原因

  アプリが再読み込みされていない

  対処

  Claude Desktopを完全に終了する、Hermesで/reload-mcpを実行する、Cursorでsorsaをオンにする

• 最初の起動でタイムアウトする

  原因

  npxがパッケージをダウンロードしている

  対処

  もう一度起動するか、Codexでstartup_timeout_sec = 30を設定する

それでも解決しない場合は、エージェントにget_key_usage_infoを呼び出させ、生の結果を表示してもらってください。数字が返れば、キーがSorsa APIに届いています。エラーなら、何が足りないかが示されます。

#今日からエージェントにXデータを

Sorsa APIのMCPサーバーを追加すれば、エージェントは読み取り専用の40ツールでXを読み取れます。Claude CodeやCodexでは1行、ツイートは公式X APIの料金の1,000件あたり$5.00に対して$0.014から、毎秒20リクエストで、あなたのXアカウントは経路のどこにも登場しません。最初の100回のツール呼び出しは無料です。MCPを使わずに、プレーンなRESTやエージェント用スキルでXデータを呼び出すエージェントについては、AIエージェント向けTwitter APIのガイドを参照してください。

#よくある質問