AIアシスタントは、自分ではXを見られません。ClaudeやChatGPTに、あるアカウントが今朝何を投稿したかを聞いても、推測で答えるか、アクセスできないと言うだけです。MCPサーバーはこれを解決します。「ユーザーのツイートを取得する」「ツイートを検索する」といったツールをアシスタントに渡し、質問にリアルタイムのデータが必要なときにアシスタントがそれを呼び出します。

このガイドでは、当社が運用するTwittrAPIのホスト型Twitter MCPサーバー（英語）を通じて、アシスタントを公開Xデータにつなぎます。インストールもX開発者アカウントも不要です。どのMCPクライアントでも考え方は同じで、URLを貼り付ける場所が違うだけです。

使えるもの

サーバーには公開データ用のツールが30個あります。

分野ツール
プロフィールget_user_by_username、get_user_by_id、users_by_ids、username_to_id、get_user_about_batch
ツイートget_tweet、tweets_by_ids、get_tweet_replies、get_tweet_thread、get_user_tweets、get_user_tweets_and_replies、get_user_media、search_tweets
反応get_tweet_quotes、get_tweet_retweets
つながりget_followers、get_following、get_verified_followers、get_user_affiliates、get_friendships_batch
リストとコミュニティget_list_details、get_list_members、get_list_tweets、get_community、get_community_about、get_community_tweets、search_communities
トレンドとスペースget_trends、get_trend_locations、get_space

Xのセッションがあれば、自分のアカウントで投稿、いいね、フォロー、DMの送信もできます。これについては別のガイドがあります。ClaudeとChatGPTからXに投稿するをご覧ください。

結果はデフォルトでコンパクトなシンプル形式（英語）で返されます。本文が短くなるので、アシスタントのコンテキストに収まります。

ステップ1：APIキーまたはアカウントを用意する

/startでアカウントを作成します。新規アカウントには、7日間使える$0.50のテストクレジットが付きます。多くのアプリはOAuthでサインインするため、キーを目にすることはありません。Cursorやスクリプトではキーをヘッダーで送るので、環境変数に入れておきます。

export TWITTRAPI_API_KEY="your-key"

ステップ2：アプリにサーバーを追加する

アドレスは常に同じで、末尾は/mcpでなければなりません。

https://mcp.twittrapi.com/mcp

Claude.aiとClaude Desktop。 Settings > Connectorsを開き、Add custom connectorを選びます。名前をTwittrAPIにしてURLを貼り付け、Connectをクリックします。ログインしてAllow accessをクリックします。

ChatGPT。 Settings > Apps & Connectors > Advanced settingsでDeveloper modeをオンにし、Createを選びます。URLを入力し、認証にOAuthを選びます。

Claude Code。

claude mcp add --transport http twittrapi https://mcp.twittrapi.com/mcp \
  --header "Authorization: Bearer $TWITTRAPI_API_KEY"

Cursor。 ~/.cursor/mcp.jsonに次を追加します。

{
  "mcpServers": {
    "twittrapi": {
      "url": "https://mcp.twittrapi.com/mcp",
      "headers": { "X-API-KEY": "${env:TWITTRAPI_API_KEY}" }
    }
  }
}

VS Code（Copilotのエージェントモード）。 "type": "http"と同じURLを書いた.vscode/mcp.jsonを追加します。サーバーの起動時に、VS Codeがサインインを求めます。このファイルとほかのクライアントの手順は、ホスト型MCPのページ（英語）にあります。

ステップ3：リアルタイムのデータが必要な質問をする

新しいチャットを始め、Xでしか答えられないことを聞いてみましょう。アシスタントが自分でツールを選び、多くのアプリでは実行前に呼び出しの内容を表示します。

  • 「@nasaが直近24時間に投稿したことを、3つの箇条書きでまとめて。」
  • 「直近2日間で、うちの製品名に言及していて、いいねが20以上あるツイートを検索して。トピックごとに分けて。」
  • 「@openai、@AnthropicAI、@GoogleDeepMindのフォロワー数とプロフィール文を比べて。」
  • 「今ドイツでトレンドになっているトピックは？」

時間のかかる作業では、最初に上限を伝えてください。たとえば「最新の40ツイートだけ見て、それ以上は不要」です。そうすれば、必要な分が揃った時点でページ送りを止めます。

ステップ4：費用に気を付ける

ツールの呼び出し1回は、残高から課金されるAPI呼び出し1回で、料金は通常どおりです。Standardでは1,000回あたり$0.10、利用量が多ければさらに安くなります。検索1ページで約20件のツイートが返るので、5回の呼び出しが発生する質問でも費用は1セント未満です。注意すべきなのは1回の質問ではなく、大きなアカウントを理由もなくページ送りし続けるアシスタントです。

費用を抑えるコツは2つです。

  • 件数を指定します。「最新の50ツイート」「フォロワーの最初の2ページ」など。
  • 無人で動くエージェントには、専用の予算を持つエージェントキー（英語）を別に作成します。こうすれば、許可した額以上は使えません。

また、サーバーはキーごとに同時に処理するリクエストを8件までに制限しています。402エラーは残高を使い切ったことを意味します。どちらの場合も、アシスタントにはわかりやすいメッセージとして表示されます。

ステップ5：使い終わったら接続を解除する

接続中のアプリは、ダッシュボードのConnected appsに最終利用時刻とともに表示されます。Disconnectをクリックすると、1分以内にそのアプリのアクセスが終了します。APIキーを再生成すると、すべてのアプリの接続が解除されます。

スクリプトのほうが向いている場合

MCPサーバーは、質問や単発の調査に向いています。1時間ごとに実行するような処理は、コードからAPIを呼び出してください。毎回同じ結果になり、モデルも介在しません。Pythonでアカウントのツイートを取得する（英語）と開発者アカウントなしでTwitter/Xを検索する（英語）をご覧ください。新しい投稿の通知を受け取りたいなら、アシスタントに確認させるのではなく、アカウント監視（英語）を使ってください。

クライアントがstdioにしか対応していない場合は、npmパッケージで同じツールをローカルで実行できます。

npx -y twittrapi-mcp

よくある問題

  • 「404 Not found」または「Couldn't determine how this server signs in」：URLに/mcpがありません。コネクタを削除し、完全なアドレスでもう一度追加してください。
  • アプリが認証されていないと表示する：接続が解除されたか、キーが再生成されています。コネクタを削除して、もう一度接続してください。
  • アシスタントがツールを呼ばずに記憶から答える：「TwittrAPIのツールを使って」と伝えるか、アカウントと期間を指定してください。チャットでコネクタをオンにする必要があるアプリもあります。

よくある質問

MCPサーバーとは何ですか？

MCP（Model Context Protocol）は、AIアプリが外部のツールを呼び出せるようにするオープンな標準です。MCPサーバーはそのツールを提供します。ここでのツールは、公開Xデータを読み取るものです。

Twitter MCPサーバーにX開発者アカウントは必要ですか？

いいえ。このサーバーは、独自のアカウントとキーを持つサードパーティのサービスです。Xとは提携していません。

アシスタントからツイートを投稿できますか？

できます。自分のアカウントで、サーバーにXのセッション（ログイン済みブラウザのCookieとプロキシ）を渡した場合です。投稿のたびにアプリが確認を求めます。設定はClaudeとChatGPTからXに投稿するをご覧ください。

MCPの呼び出しはいくらですか？

ツールの呼び出し1回はAPI呼び出し1回で、Standardでは1,000回あたり$0.10、利用量が多ければさらに安くなります。残高はダッシュボードで確認できます。アシスタントがそれ以上を使うことはできません。

どのアプリで使えますか？

Claude.ai、Claude Desktop、ChatGPT、Claude Code、Cursor、VS Code、そしてStreamable HTTPに対応したあらゆるクライアントです。

出典

TwittrAPIはX Corp.とは提携していません。読み取るのは公開データのみです。