WEIR
API キーを取得
言語English中文
テーマ

X MCP サーバー公式版の使い方：Claude Code 連携と料金

X 公式の MCP サーバー（api.x.com/mcp）を確認。開発者アプリが要る理由、Claude Code への追加コマンド、1 ポスト $0.005 の料金、書き込める範囲まで。


公開 · 更新 · 約 7 分で読めます · Read in English · 阅读中文版

カバー画像：公式 MCP に必要なもの

X 公式の MCP サーバーは api.x.com/mcp にあり、自分の開発者アプリを通して AI ツールから X API を呼べます。

Claude Code や Cursor から X（旧 Twitter）のデータを使いたい人向けに、設定、料金、書き込める範囲を X 自身のページで確かめました。

私たちは別の MCP サーバー Weir を運営しているので、その前提で読んでください。

X のドキュメントにある、Cursor 用の設定です。

{
  "mcpServers": {
    "xapi": {
      "command": "npx",
      "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
      "env": {
        "CLIENT_ID": "YOUR_X_APP_CLIENT_ID",
        "CLIENT_SECRET": "YOUR_X_APP_CLIENT_SECRET"
      }
    }
  }
}

X 公式の MCP サーバーとは？

X は 2 つの MCP サーバーをホストしています。API 用と、ドキュメント用です。

話題になっているのは API 用です。X は 2026 年 6 月 30 日に、開発者フォーラムと @XDevelopers で公開を発表しました。https://api.x.com/mcp で Streamable HTTP を話し、名前は xmcp です。

もう 1 つの https://docs.x.com/mcp は、X の開発者ドキュメントを検索するだけです。

X のドキュメントが挙げる、API 用サーバーでできることです。

分野 モデルができること 種類
ポスト 取得、いいね・リポスト・引用したユーザー 読み取り
検索 全期間のポスト、ユーザー、ニュース 読み取り
ユーザー アカウント、タイムライン、メンション 読み取り
ブックマーク 一覧、追加、削除、フォルダ管理 書き込み
ニュースとトレンド 記事、地域ごとのトレンド 読み取り
記事（Articles） 下書きの作成と公開 書き込み

投稿は一覧にありません。公開当日の TechCrunch によると、X はこの MCP が「Write API のエンドポイントに対応していない」と認めました。投稿、返信、いいね、フォローはできないと考えてください。

10 月 26 日に、Weir 経由で @XDevelopers の「MCP」を含むポストを検索しました。いちばん反応が多かったのは公開の発表です。

→ search_x {"fromUsers": ["XDevelopers"], "query": "MCP", "sort": "top", "limit": 3}
← 3 posts · 4 credits
  2026-06-30 · 10,443 likes
  "Announcing the hosted X MCP. ... to the X API without any setup!"

「設定なし」は宣伝文句で、ドキュメントの手順はもう少し長くなります。

X の MCP サーバーを設定する手順

どの方法も、自分の X 開発者アプリから始まります。

X のドキュメントは「X の OAuth には自分の開発者アプリが必要」と明記しています。動的クライアント登録がないので、URL だけではログインできません。小さなローカルブリッジ xurl がアプリのキーを持ち、代わりにログインします。

  1. X アプリを作るDeveloper Console で OAuth 2.0 を有効にします。
  2. コールバックを登録http://localhost:8080/callback をアプリに追加します。
  3. クライアント ID とシークレットをコピー設定の env に入れます。
  4. ブリッジを起動npx が xurl を動かし、初回はブラウザでログインします。

アプリとキーの作り方は X API キーの取得方法 にまとめました。

X が設定例を載せているのは、Cursor、Claude Desktop、VS Code などです。初回のログインが終わるよう、起動のタイムアウトは 300 秒以上にします。

ブラウザのないサーバーでは、先に xurl auth oauth2 --headless でログインします。client-not-enrolled で失敗したら、アプリを Pay-per-use と Production に移します。

Claude Code で X の MCP と連携するには？

X のドキュメントに Claude Code の名前はありませんが、どの MCP クライアントでもブリッジ経由で使えるとしています。上の Cursor 用の設定を Claude Code のコマンドに直すと、次のとおりです。私たちはこの組み合わせを試していません。

claude mcp add -e CLIENT_ID=$X_CLIENT_ID -e CLIENT_SECRET=$X_CLIENT_SECRET \
  --transport stdio xapi -- npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

Claude Code の起動タイムアウトは環境変数 MCP_TIMEOUT で、ミリ秒で指定します。300 秒なら MCP_TIMEOUT=300000 claude です。

読むだけなら、ブリッジを使わない方法もあります。アプリの Bearer Token を Authorization ヘッダーで送ります。

claude mcp add --transport http xapi https://api.x.com/mcp \
  --header "Authorization: Bearer $X_BEARER_TOKEN"

X はこれを「ユーザーコンテキストなし」の読み取り専用としていて、あなたとして操作はできません。

X の MCP は無料？料金は？

無料ではありません。つなぐのは無料ですが、ツールの呼び出しはすべて従量課金の X API 呼び出しです。

サーバーはあなたのアプリで X API を呼びます。料金ページの、エージェントがよく使う単価です。

X API の単価（2026 年 10 月）
ポストの読み取り$0.005
ブックマークの追加$0.005
ユーザーの読み取り$0.010
トレンドの取得$0.010

調べ物で 1,000 ポストを読めば $5 です。月 300 万ポストを超えると、Enterprise を案内されます。

毎月の無料枠はありません。最初の購入後に $20、最初の自動チャージに $50 までの同額が付くだけです。全料金は X API の料金 にあります。

セルフホストの xmcp との違いは？

ホスト版の前から、X は GitHub で xmcp を公開しています。自分で動かす Python のサーバーです。

X の OpenAPI 仕様をツールにするので、ホスト版にない createPosts、likePost、followUser、DM のツールも含みます。

料金はホスト版と同じ X API の単価です。最後のコードの更新は 2026 年 4 月でした。

xmcp.dev とは別物です。 basement.studio の、MCP サーバーを作るための TypeScript フレームワークで、X とは関係ありません。

X 公式 MCP か、読み取り専用のホスト型か

エージェントが書き込むか、X アプリを運用したいかで選びます。私たちは読み取り専用の https://api.weirapp.io/mcp を運営しています。

X のホスト型 MCP は公式の方法です。

長所

  • X 自身のサーバーで、X の規約の下で使える
  • 自分のアカウントでブックマークと記事を操作できる
  • ニュース検索と地域ごとのトレンド

注意点

  • 自分の開発者アプリと、ログイン用のローカルブリッジが必要
  • 1 ポスト $0.005 で、毎月の無料枠はない
  • X だけ

Weir の MCP は OAuth でログインし、X の開発者アプリは要りません。

長所

  • URL 1 つで、インストール不要。claude.ai や chatgpt.com でも使える
  • 同じ接続で Reddit のツールも使える
  • 毎月 5,000 クレジットが無料で、カード不要

注意点

  • 読み取り専用で、ブックマーク、記事、投稿はできない
  • X の公認ではない第三者なので、使える範囲が変わることがある

Claude Code なら 1 行で追加でき、/mcp で Weir を選ぶとブラウザでログインします。

claude mcp add --transport http weir https://api.weirapp.io/mcp

Weir は 1 回 1 クレジットに、ポスト 1 件ごとに 1 クレジットです。X は 1 ページに約 20 件返すので、1,000 ポストは約 50 回、1,050 クレジットです。

MCP で 1,000 ポストを読む費用
X の MCP$5.00
Weir、$5 パック約 $0.21

用途別の選び方です。

  • 投稿、いいね、DM：どちらのホスト型もできません。X のセルフホスト版 xmcp にはツールがあります。
  • チャットアプリでの調べ物：読み取り専用のほうが安く、すぐ始められます。X MCP サーバーのページ（英語）を見てください。
  • Reddit と X をまとめて：Reddit と X の MCP ガイド（英語）に実際のセッションがあります。

Weir が向かないケース

  • エージェントが X に書き込む：Weir に書き込みのツールはありません。
  • X の規約や X との契約が必要：Weir は X と提携していません。
  • 自分のアカウントを読む：X の Owned Reads は 1 件 $0.001 で、ブックマークは X にしか見えません。

よくある質問

X 公式の MCP サーバーは無料ですか？

つなぐのは無料ですが、呼び出しは有料です。2026 年 10 月時点で、ツールの呼び出しは従量課金の X API リクエストで、ポストの読み取りは 1 件 $0.005 です。docs.x.com/mcp のドキュメント用 MCP には、アプリは要りません。

X の MCP に API キーは必要ですか？

必要です。どちらの方法も、自分の開発者アプリから始まります。読み取り専用ならアプリの Bearer Token、xurl のログインならクライアント ID とシークレットを使います。動的クライアント登録がないので、アプリなしでは使えません。

Claude Code で X の MCP は使えますか？

X によると、xurl ブリッジならどの MCP クライアントでも動きます。ただし Claude Code の設定例はなく、この記事のコマンドは私たちが書き直したもので、未検証です。

X の MCP でポストを投稿できますか？

できません。ホスト版に投稿のツールはなく、X は TechCrunch に Write API には対応しないと伝えています。書き込めるのはブックマークと記事です。セルフホスト版の xmcp には createPosts があります。

参考資料

英語の資料です。X のドキュメントと料金、GitHub、Claude Code のドキュメントは 2026 年 10 月 26 日に、ほかは 10 月 21 日に確認しました。

あわせて読みたい