AI総合研究所

SHARE

X(twiiter)にポストFacebookに投稿はてなブックマークに登録URLをコピー

X MCPとは?X公式MCPサーバーの機能・料金・xurlブリッジでのClaude Code連携を解説

この記事のポイント

  • X開発者プラットフォーム公式MCPの主役はホスト型 api.x.com/mcp + Docs MCP(docs.x.com/mcp)。xurl bridgeをローカルに置いてClaude DesktopをXに繋ぐのが最短経路
  • 別実装として self-hosted版 xdevplatform/xmcp(FastMCP・Python)があり、READMEのallowlist一覧は119件・OpenAPIの operationId は約165件で挙動を細かく制御したい用途向け
  • 構成要素ごとに条件が異なる。xurl bridge は MIT、self-hosted版 xdevplatform/xmcp は LICENSE 未明示、hosted版はX API利用規約・課金(Owned Reads $0.001/件・POST $0.015/件・URL付POST $0.20/件のpay-per-usage)に従う
  • コミュニティ製のMindMadeLab/x-mcp・mbelinky/x-mcp-server・guzus/grok-mcp・armatrix/twitter-mcp は読み取り特化・OAuth柔軟性などで補完的に使える
  • 同名の「basementstudio/xmcp」はTypeScript製のMCPフレームワーク(別物)。混同しないこと
坂本 将磨

監修者プロフィール

坂本 将磨

XでフォローフォローするMicrosoftMVP

Microsoft MVP・AIパートナー。LinkX Japan株式会社 代表取締役。東京工業大学大学院にて自然言語処理・金融工学を研究。NHK放送技術研究所でAI・ブロックチェーンの研究開発に従事し、国際学会・ジャーナルでの発表多数。経営情報学会 優秀賞受賞。シンガポールでWeb3企業を創業後、現在は企業向けAI導入・DX推進を支援。

X MCPは、X開発者プラットフォームが公式に提供するMCP(Model Context Protocol)サーバーで、X APIをClaude Desktop・Claude Code・Cursor・Windsurf等のMCPクライアントから自然言語で呼び出せる仕組みです。
主役はX側でホストされる api.x.com/mcp と、開発者ドキュメント検索用の docs.x.com/mcp で、ローカルにはxurl bridgeだけを置いてOAuth 2.0認証を処理します。

本記事では、ホスト型X MCPの全体像、xurlブリッジ経由のClaude Code/Desktop連携手順、X API側のツール群と提供機能、別実装として公開されているself-hosted版 xdevplatform/xmcp(FastMCP・Python)の位置づけ、2026年4月のX API料金改定を踏まえた運用コスト、コミュニティ製MCPとの違いと注意点までを、2026年6月時点の最新情報で体系的に解説します。

X MCPとは?X公式が提供するMCPサーバー

X MCPは、X開発者プラットフォームが公式に提供するMCP(Model Context Protocol)サーバーの総称で、X APIをClaude Desktop・Claude Code・Cursor・WindsurfなどのMCPクライアントから自然言語で呼び出すための公式接続点です。

X MCPが他のX/Twitter連携ツールと一線を画すのは、X側がホストするリモートエンドポイントを公式に提供している点です。コミュニティ製MCPサーバーやスクレイピングベースの連携ツールとは異なり、認証・レート制限・スキーマ管理を公式が担うため、SLAと監査可能性の面で企業導入に耐えるベースラインを持ちます。

この位置づけは、Claude DesktopやClaude Codeを軸にX上の情報収集・投稿・分析エージェントを内製したい開発者にとって、実装工数と保守負担を大きく下げる意味があります。「最新の投稿を検索して」「Articlesの下書きを作成して」といった自然言語指示が、そのまま公式X APIの呼び出しに変換される設計です。

X MCPとは X公式が提供するMCPサーバー

AI Agent Hub1


ホスト型X MCPとself-hosted版の使い分け

X MCPには、X側でホストされるホスト型(api.x.com/mcp + Docs MCP + xurl bridge)と、GitHubで別途公開されているself-hosted版(xdevplatform/xmcp、FastMCP・Python)の2系統があります。

公式ドキュメントが主に案内しているのはホスト型で、self-hosted版は「自分のマシンでX APIを直接叩く参照実装」として位置づけられます。両者は接続方式・認証フロー・対象ユーザーが異なるため、最初にどちらを使うかの判断が導入の起点になります。

ホスト型X MCPとself-hosted版の使い分け

ホスト型(api.x.com/mcp + Docs MCP + xurl bridge)

X公式docsが案内する主役の構成です。X側で稼働している api.x.com/mcp と docs.x.com/mcp に、ローカルからは xurl bridge 経由で接続します。

特徴は以下のとおりです。

  • 構造
    @xdevplatform/xurl をnpxで起動するNode.jsブリッジ。stdio JSON-RPCで Claude Desktop と通信し、内部でOAuth 2.0認証を処理して api.x.com/mcp へ転送する。

  • エンドポイント
    api.x.com/mcp(X API操作の本体)と docs.x.com/mcp(ドキュメント検索)の2つを同じ設定で有効化できる。

  • 認証
    OAuth 2.0ユーザーコンテキストが推奨で、書き込み操作には必須。初回ブラウザログインでトークンを取得し、ブリッジが自動的にキャッシュ・リフレッシュする。読み取り中心ならアプリ専用Bearerトークンも利用可能。

  • サーバー本体の運用
    X側でホストされるため、自分でサーバーをアップデートする必要がない。


サーバー側がX管理下にあるため、X API側の新機能(News endpoints・Articles 等)に追従しやすいのがホスト型の最大の利点です(具体的な対応状況は公式docsで確認)。Community Notes 関連のエンドポイントは self-hosted版のallowlistには含まれますが、ホスト型公式docsの主要機能一覧では現時点で未掲出のため、利用前に最新ドキュメントを確認するのが安全です。

ホスト型X MCPの構造

self-hosted版(xdevplatform/xmcp・FastMCP・Python)

xdevplatform/xmcp リポジトリで公開されている参照実装です。Python 3.9以上のローカルサーバーとして起動し、自分のマシン上でX APIを叩きます。

特徴は以下のとおりです。

  • 構造
    FastMCPフレームワーク上で動作。起動時にX API v2のOpenAPI仕様を取得し、各operationを1対1でMCPツールに変換する。

  • ツール数
    公式READMEのallowlist一覧には119件のツール名が掲載されている(Stream・Webhook系を除く)。同時に取得したX API公開OpenAPIの operationId は約165件で、ALLOWLIST設定や OpenAPI 側の更新時期によって実際の登録数は変動する。

  • 認証
    OAuth1クライアント署名を中心に、必要に応じてBearerトークンを併用する設計。READMEの必須環境変数は X_OAUTH_CONSUMER_KEY / X_OAUTH_CONSUMER_SECRET / X_BEARER_TOKEN で、起動時のブラウザフローでOAuth1トークンを取得しメモリ上に保持する。

  • 接続先
    デフォルトでローカルの 127.0.0.1:8000/mcp にバインド。MCPクライアントからはこのエンドポイントを参照する。


self-hosted型なので、自分のAPIキーで完全に挙動を制御でき、X_API_TOOL_ALLOWLIST / X_API_TOOL_DENYLIST / X_API_TOOL_TAGS の環境変数で公開ツールを絞り込めるのが強みです。

self-hosted版X MCPの構造

どちらを選ぶか——用途別の判断軸

両者は同じ「公式X MCP」の枠ですが、適性が異なります。以下の表で、選定の判断軸を整理しました。

判断軸 ホスト型(api.x.com/mcp) self-hosted版(xdevplatform/xmcp)
推奨ユーザー 最短経路でClaude DesktopをXに繋ぎたい運用ユーザー 自前で挙動を制御したい開発者・PoC段階のチーム
認証実装 OAuth 2.0が前提(xurl bridgeが裏で処理) OAuth1クライアント署名 + Bearerトークン併用
ホスト リモート(X側)+ローカルNode.jsブリッジ self-hosted(ローカル)|要Python環境
ツール制御 ブリッジ側で公開ツールが固定 X_API_TOOL_ALLOWLIST 等で細かく絞れる
機能追従 X側運用のため追従しやすい 自分でリポジトリをpullして追従が必要


ざっくり言えば「最短セットアップ重視ならホスト型、カスタム性・ツール制御重視ならself-hosted版」という整理になります。

本記事では、まずホスト型のセットアップを軸に進めたうえで、後段でself-hosted版の使いどころを補足する流れで解説します。

ホスト型とself-hosted版の判断軸


X MCPが提供する機能とツール群

X MCPが扱える領域は、X API v2の主要リソースを軸に100件超規模で構成されます。投稿管理・検索・ユーザー情報・リスト操作・ダイレクトメッセージ・トレンド情報・メディア管理・ブックマーク・Articlesといった、X API v2の主要カテゴリを広くカバーする構成です(Streaming/Webhook系は除外)。

ここでは、ツールカテゴリの全体像と、意図的に除外されている機能領域、そして安全運用に欠かせない権限制御について整理します。

X MCPが提供する機能とツール群

ツールカテゴリの全体像

X MCPが公開するツールは、X API v2のリソース単位で大きく以下のカテゴリに分けられます。

  • Posts(投稿)
    ツイートの作成・取得・削除、Summoned repliesによる返信、投票(Polls)の操作など、投稿ライフサイクル全般を扱うエンドポイント群。なお Follow / Like / Quote-Post 系は実装上ツール名が存在しても、2026年4月のX API改定で self-serve tiers から削除対象になっているため、現行プランで実行できるかは契約条件に依存する。

  • Search(検索)
    直近のポスト検索、フル/フィルタ検索、SERPに合わせたクエリ演算子(min_likes / min_replies / min_reposts 等)の指定。

  • Users(ユーザー)
    プロフィール取得、フォロワー一覧、フォロー対象一覧、ミュート・ブロック関連の操作。

  • Bookmarks(ブックマーク)
    自分のブックマーク追加・削除・一覧。

  • News & Trends(ニュース・トレンド)
    2025年11月に発表されたNews endpoints経由のトレンドニュース検索、地域別トレンド取得。

  • Articles(長文記事)
    X APIで公開されている長文記事の下書き作成・公開などのエンドポイント(articleCreateDraft / articlePublish 系)。

  • Lists / DMs / Media
    リストの作成・メンバー管理、ダイレクトメッセージ送信、メディアアップロード。


これらをMCPクライアントの目から見ると、getPosts / createPost / searchPostsRecent / addListsMember / unrepostPost といった命名でツールが並ぶ形になります。AIエージェントはこの一覧を自動discoveryで取得し、ユーザー指示から適切なツールを選んで呼び出します。

self-hosted版(xdevplatform/xmcp)のREADMEに掲載されているallowlist一覧は119件で、これが現時点でドキュメント化されている公式ツール数の最も信頼できる目安です。X API公開OpenAPIの operationId は約165件あるため、登録ツール数は OpenAPI の追従状況とALLOWLIST設定で増減します。

X MCPツールカテゴリの全体像

除外されている機能——StreamingとWebhook

公式READMEでは、StreamingとWebhookに関するエンドポイントは明示的に除外されています。これはMCPがリクエスト/レスポンス型の同期プロトコルであり、長時間接続を維持するStreamやサーバーからのコールバックを前提とするWebhookと相性が悪いためです。

具体的には、tweets/search/stream や account_activity/webhooks 系のエンドポイントは登録対象外になります。

リアルタイム追跡をX MCP経由で実装したい場合は、MCPサーバーとは別にWebhook受信用のサーバーを立てる構成が必要です。MCPサーバーは「AIが必要なときに引き出す」用途に絞られると理解しておくのが安全です。

X MCPで除外される機能

ALLOWLIST / DENYLISTで安全に絞り込む

公開ツールがすべて有効な状態は、運用上ハイリスクです。なかには deletePosts / unfollowUser / removeListsMember のような破壊的操作も含まれており、AIエージェントが意図せず呼び出した場合の影響は無視できません。

self-hosted版は環境変数 X_API_TOOL_ALLOWLIST / X_API_TOOL_DENYLIST / X_API_TOOL_TAGS でツールを選別できる仕組みを備えています。本番運用では最小権限の原則で必要なツールのみ許可する形が推奨されます。

例えば「検索とポスト取得のみ許可」「投稿は許可するが削除系は禁止」といった制御がリスト指定で実現できます。

Zennで公開された技術調査でも、本番デプロイ前に X_API_TOOL_ALLOWLIST を必ず設定すべきと指摘されています。self-hosted版を導入する場合の最初のチェックリストに入れておくべき設定です。ホスト型ではツール集合がX側で固定されており、利用者側からの絞り込みはClaude Desktop/Code 側の承認制御に依存します。

ALLOWLISTとDENYLISTで安全に絞り込む


X MCPのセットアップ手順——xurlブリッジでClaude Code/Desktopに繋ぐ

ここでは公式の推奨経路であるホスト型 + xurl bridgeを使って、Claude Code または Claude Desktop から api.x.com/mcp に接続するまでの手順を整理します。

大きな流れは「X Developer Portalでアプリ作成 → xurl bridge をMCPクライアントに登録 → 初回ブラウザ認証 → 動作確認」の4ステップです。

X MCPのセットアップ手順

X Developer Portalでアプリを作成

最初にX Developer Portalでアプリを作成し、OAuth 2.0認証情報を取得します。

  • 取得するのは Client IDClient Secret
  • Settings画面でOAuth 2.0を有効化し、リダイレクトURL(コールバック)を http://localhost:8080/callback で登録する(xurl bridge公式デフォルト)
  • API利用は有料プラン契約が必要。2026年4月から従量課金(pay-per-usage)に切り替わっており、クレジットを購入して使った分だけ支払う構造に変わっている

開発者ポータルでのアプリ作成が完了したら、Client ID と Client Secret を控えておきます。

X Developer Portalでアプリを作成

Claude Code・Claude Desktopにxurl bridgeを登録

xurl bridgeはMCPクライアントから直接 npx で呼び出す構成です。Claude Desktopの場合は claude_desktop_config.json を編集します。

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

これでX MCP本体(api.x.com/mcp)とDocs MCPの両方が同時に有効化されます。

Claude Codeから使う場合は、プロジェクトディレクトリで以下を実行します。

claude mcp add --transport http x-docs https://docs.x.com/mcp
claude mcp add --transport stdio xapi -e CLIENT_ID=YOUR_CLIENT_ID -e CLIENT_SECRET=YOUR_CLIENT_SECRET -- npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

--transport オプションの指定が必要な点に注意してください。stdio接続を使う xurl bridge は --transport stdio、URLを直接参照する Docs MCP は --transport http で登録します。

CLIENT_ID と CLIENT_SECRET は環境変数として渡す必要があります。事前に xurl auth apps add でローカルにアプリを登録済みなら -e オプションは省略可能ですが、最初のセットアップでは付けておくのが安全です。

Claude DesktopにX MCPを登録

初回ブラウザ認証

設定後、最初にX MCPツールを呼び出すと、ブラウザが自動的に開いてX側の認証画面に遷移します。

xurl bridge は http://localhost:8080/callback でリダイレクトを受け取り、取得したOAuth 2.0トークンをローカルにキャッシュします。以降のセッションでは自動的にリフレッシュトークンで更新されるため、再度ブラウザを開く必要はありません。

書き込み操作(投稿・Summoned reply・Articles公開等)はOAuth 2.0ユーザーコンテキストが必須で、読み取り中心ならアプリ専用Bearerトークンでも対応可能です(Like / Follow / Quote-Post は現行X APIのself-serve制限により、認証が通っても契約上実行できない場合があります)。

X MCP初回ブラウザ認証

動作確認とself-hosted版の起動

claude mcp list を実行して xapi と x-docs が表示されれば接続成功です。Claude Codeのチャットで「最新の自分の投稿を3件取得して」のように指示すると、MCPツールが呼び出されます。

self-hosted版(xdevplatform/xmcp)を試したい場合は、リポジトリをcloneして以下のように起動します。

git clone https://github.com/xdevplatform/xmcp.git
cd xmcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp env.example .env
# .env に X_OAUTH_CONSUMER_KEY / X_OAUTH_CONSUMER_SECRET / X_BEARER_TOKEN と X_API_TOOL_ALLOWLIST 等を記入
python server.py

起動後は MCP_HOST / MCP_PORT 環境変数で指定したエンドポイント(デフォルト 127.0.0.1:8000/mcp)で待ち受け状態になります。Claude Code から呼ぶなら以下のように登録します。

claude mcp add --transport http x-api http://127.0.0.1:8000/mcp

X MCPの動作確認とself-hosted版の起動

AI研修

詰まりやすいポイント——スキーマサイズとレート制限

self-hosted版の初回起動でよくハマるのが、ツール定義スキーマがClaude Desktopに表示されない問題です。

npaka氏の試用レポートでは、server.py が返すツール定義のスキーマが大きすぎて、Claude Desktop側でツールリストが空になる事象が報告されています。FastMCPに渡す前にOpenAPIスキーマを圧縮する対応で解決した、と記録されています。

もう一つ注意したいのがレート制限です。self-hosted版は内部で再試行を行わない設計のため、X APIのレートリミットに当たった場合の指数バックオフは、MCPクライアント側または上位アプリケーション側で実装する必要があります。

「数回連続でツールを呼ぶとエラーになる」場合は、まずX APIのレート制限を疑うのが定石です。

X MCPで詰まりやすいポイント


X MCP運用にかかるコスト——2026年4月のX API料金改定後

X MCPの構成要素ごとに費用は分かれます。xurl bridge はMITライセンスで公開self-hosted版 xdevplatform/xmcp はGitHub公開だがLICENSE未明示hosted の api.x.com/mcp はX側ホストのサービスで、X API利用規約・課金に従う形です。いずれもツール経由でX APIを呼び出すたびに、X側で従量課金が発生します。

特に2026年4月20日施行のX API料金改定で課金体系が大きく変わっており、X MCPを業務利用する前にコスト見積もりを把握しておく必要があります。

X MCP運用にかかるコスト

2026年4月改定後の主要単価

以下の表で、2026年4月20日以降の主要な単価を整理しました。

操作カテゴリ 単価 補足
Owned Reads(自分の投稿・タイムライン読み取り) $0.001 / 件 1,000件で$1。最も安い読み取り
通常POST(テキストのみのツイート) $0.015 / 件 4月以前の$0.01から値上げ
URL付きPOST $0.20 / 件 リンク付き投稿は約13倍高い
Summoned replies(メンションを受けた返信) $0.01 / 件 据え置き
Follow / Like / Quote-Post セルフサーブから廃止 4月20日改定でself-serveティアから削除


この体系で見えてくるのは、読み取りは安く、URLを含む投稿は明確に高いという構造です。

エージェントで情報収集を回す用途(検索・読み取り中心)であれば、月数千件呼び出してもAPI費用は数ドル単位に収まります。一方で、URLを含む投稿を自動化するbot系の用途は、件数が増えると$0.20/件が効いてきます。

2026年4月改定後のX API主要単価

X MCPでの想定運用コスト

実際にX MCPを動かす場合のコストは、用途で大きく変わります。以下は2026年4月以降の単価から逆算した目安です。

  • 個人開発・PoC利用(読み取り中心)
    検索や Owned Reads 中心であれば、数千件規模の検証でも数ドル単位に収まる。日本語コミュニティの試用レポートでも、最低クレジット購入から検証を始めた例が報告されている(npakaブログ)。

  • 業務エージェントでの情報収集(読み取りメイン・月1万件想定)
    月$10〜$30程度。Owned Readsを中心に組み立てる前提。

  • SNS運用自動化(URL付きPOSTを月100件含む)
    URL付きPOSTで20、通常POSTで数、読み取りで数$。月$30〜$50の規模。

  • 大規模クロール・大量投稿
    月数百〜数千$規模。X Developer Platformの現行プランは消費ベース課金(No fixed monthly costs)を掲げており、Enterprise契約・利用上限・サポート条件は最新の価格表で確認する必要がある。


従量課金構造のため、初期コミットを最小化して使った分だけ払う形が可能です。

業務でX MCPを評価する場合は、まず読み取り中心のPoCで月$10前後のレンジに収めて、本格運用に進む際に書き込みコストを上乗せして見積もり直すのが現実的な進め方です。

X MCPでの想定運用コスト

ソフトウェア側のライセンス整理

費用構造を整理すると、X MCPの構成要素ごとにライセンスと課金が異なります。

  • xurl bridge: GitHub上で公開され、MITライセンス。自由に利用・改変・再配布が可能。
  • self-hosted版 xdevplatform/xmcp: GitHub公開だがLICENSEファイルが配置されていない。本番運用前に法務確認を行うか、X Developer Platform経由でライセンス条件を確認するのが安全。
  • hosted の api.x.com/mcp: X側でホストされるサービスのため、X API利用規約・課金体系に従う。ソフトウェアライセンス課金はなく、X API側の従量課金のみが発生する。


「X MCPは無料」と一括りにせず、構成要素ごとの条件を社内で確認したうえで採用判断を行うのが安全です。

X MCPソフトウェア側のライセンス整理


コミュニティ製MCPサーバーとの違いと使い分け

X/Twitter向けMCPサーバーは、公式X MCP以外にも複数のコミュニティ実装が存在します。X MCPに乗り換えるか、既存のコミュニティMCPを使い続けるかは、用途と運用要件で判断が分かれます。

ここでは主要なコミュニティ製MCPと公式X MCPを比較し、実務での選び方を整理します。

コミュニティ製MCPサーバーとの違いと使い分け

主要コミュニティMCPの比較

以下の表で、代表的なX/Twitter MCPサーバーの位置づけを整理しました。

MCPサーバー 開発元 認証 カバー範囲 特徴
公式X MCP(ホスト型 + self-hosted) xdevplatform OAuth 2.0 / OAuth1 / Bearer X API v2の主要領域100件超 api.x.com/mcp + xurl bridge / self-hosted版もあり
MindMadeLab/x-mcp(PyPI: x-mcp-server) コミュニティ Bearer / OAuth1 21ツール(投稿・検索 ほか) uvxで簡単起動・コアCRUD特化(Like/Follow/Quote系は現行X API契約・self-serve制限に依存)
mbelinky/x-mcp-server コミュニティ OAuth 1.0a + 2.0 投稿(メディア込み)・読み取り OAuth2対応・レート制限機能
guzus/grok-mcp 等のGrok MCP系 コミュニティ xAI APIキー X検索(Live Search経由) X API課金不要・読み取り専用(xAI API側の利用条件・料金は別途)
armatrix/twitter-mcp コミュニティ twitterapi.io + 公式API 読み取り(コスト最適化) ハイブリッドAPI構成


この比較から分かるのは、公式X MCPは網羅性とX API追従で勝るが、コミュニティMCPは特定用途に最適化されているという構造です。コミュニティ実装は「投稿だけ」「検索だけ」のように機能を絞り、その代わり起動の手軽さや認証の柔軟性を高めているケースが多くあります。

主要コミュニティMCPの比較

公式版とコミュニティ版の判断軸

選び方の軸は大きく3つに分かれます。

  • 網羅性が必要なら公式X MCP(ホスト型)
    X API v2の主要カテゴリを広くカバーしたい、エージェントから自由にエンドポイントを叩かせたい場合は公式X MCP一択。ホスト型ならX側運用のため News endpoints・Articles 等の追従が比較的早い(具体的な対応時期は最新ドキュメントを確認)。

  • 読み取りだけならGrok MCP系
    X API側の有料契約をしたくない、Xのリアルタイム検索だけしたい場合はGrok MCP系(guzus/grok-mcp 等)が現実解。xAI Live Search API経由なのでX API課金は発生しない。ただし xAI API側の利用条件・料金は別途発生し得るため、xAIのコンソールで枠を確認しておくこと。投稿などの書き込み操作はサポート対象外(読み取り専用)。

  • コアCRUDだけならMindMadeLab/x-mcp
    ポスト作成・検索・自分のタイムライン取得など、X APIで現行self-serve契約内に収まる主要操作だけで足りる用途なら、PyPIで公開されているMindMadeLab/x-mcp(x-mcp-server)のように uvx 一発で起動するシンプル実装が運用負担が少ない(Like / Follow / Quote-Post 系は契約条件に依存する点に注意)。


AI総研の支援現場で見る感触では、業務エージェントへの本格組み込みでは公式X MCPがファーストチョイスになりやすく、個人の検証や軽量bot用途ではコミュニティMCPで十分というケースが多いです。

公式版とコミュニティ版の判断軸

実務での選び方——SIerポジションのケース別推奨

具体的なユースケース別の推奨は以下のとおりです。

  • B2Bで顧客のSNS運用をエージェント化したい
    公式X MCPの self-hosted版 + X_API_TOOL_ALLOWLISTで運用ツールを絞る構成。OpenAPI追従と最小権限原則の両立が要件と噛み合う。

  • 社内ナレッジワーカーのデスクトップで「Xから情報収集」を補助したい
    ホスト型(xurl bridge)で最短セットアップ。インストール工数を最小化し、Claude Desktopで完結させる。

  • PoCで「Xでトレンド検索 → 要約 → Slackへ通知」を試したい
    Grok MCP系で読み取りだけ実装。X API契約を後回しにできるので、エージェント設計の検証を先行できる。

  • 既にMindMadeLab/x-mcp や mbelinky/x-mcp-server で本番運用中
    公式X MCPに乗り換える必要は急がない。OpenAPI差分が顕在化したタイミング(新エンドポイントを使いたくなったとき)で検討する。


「公式が出たから即乗り換え」ではなく、要件と既存運用を照らし合わせて判断するのが現実的です。

X MCPの実務での選び方


X MCP導入時の注意点と落とし穴

最後に、X MCPを本番運用する前に押さえておきたい注意点を整理します。ホスト型はX側で運用されるためインフラ依存が少ない反面、self-hosted版(xdevplatform/xmcp)には「実プロダクト」と「参照実装」の中間として割り切りが必要な箇所がいくつかあります。

X MCP導入時の注意点と落とし穴

同名のTypeScript製フレームワークとの混同に注意

検索で最も混乱が起きやすいのが、**同名の別プロジェクト「basementstudio/xmcp」**の存在です。こちらはMCPサーバーを作るためのTypeScript製フレームワーク(xmcp.dev)で、X APIとは無関係です。

両者の違いは以下のとおりです。

プロジェクト 提供元 用途 言語
xdevplatform/xmcp X開発者プラットフォーム X APIを叩くMCPサーバー本体 Python
basementstudio/xmcp basement.studio MCPサーバーを作るためのフレームワーク TypeScript


名前が完全に同じため、Google検索や記事タイトルだけで混同しやすい構造になっています。本記事で扱っているのは前者(X API用)です。

導入時にGitHubリポジトリのオーナーが xdevplatform であることを必ず確認してください。

同名のTypeScript製フレームワークとの混同

self-hosted版のライセンス未明示

xdevplatform/xmcp リポジトリには、本記事執筆時点でLICENSEファイルが配置されていません。GitHub Orgそのもの(xdevplatform = @XDevelopers)は2014年から運用されているXの公式アカウント由来ですが、リポジトリ単位ではOSSライセンスが明示されていない状態です。

self-hosted版を本番運用する前のチェックポイントは以下になります。

  • 社内法務に確認を取り、ライセンス明示がない状態で利用可能かを判定する
  • 不安があれば、X Developer Platformのサポート経路でライセンス条件を直接確認する
  • リポジトリをforkして自社管理下に置くなら、forkした時点でのスナップショットを記録しておく


ホスト型を使う場合はX側の利用規約に従う形になるため、ライセンスファイル単体の不在は実務上の問題になりません。self-hosted版を採用する場合のみ、この判断が必要です。

self-hosted版X MCPのライセンス未明示

破壊的ツールと最小権限の原則

X MCPには deletePosts / removeListsMember / unfollowUser / unrepostPost といった破壊的操作も含まれます。AIエージェントが意図しない指示でこれらを呼び出すと、復元できない結果に直結します。

最小権限原則を守るための実務的な対応は以下になります。

  • self-hosted版なら X_API_TOOL_ALLOWLIST で必要なツールだけを明示的に許可する
  • 開発・本番でアプリ(Client ID / Client Secret)を分けて、本番では破壊的ツールが使えるトークンを別管理にする
  • Claude Code/Desktop側で、ツール呼び出し前のユーザー承認を有効化する


X MCPの自由度の高さは、運用設計を間違えるとそのままリスクに転じます。「初回起動時にすべて許可しない」が出発点です。

X MCPの破壊的ツールと最小権限の原則

self-hosted版の再試行なし・コミット停止

self-hosted版は内部で再試行を行わない設計です。X APIのレート制限・一時的なネットワーク障害に当たった場合の再試行・指数バックオフは、上位アプリケーション側で実装する必要があります。

加えて、公式リポジトリの最新コミットは2026年4月9日で、約3か月間メンテナンス更新が止まっています。X API v2 側に新エンドポイントが追加されても、自動的に追従するわけではない点に注意が必要です。

長期運用前提なら、ホスト型(api.x.com/mcp)に寄せるか、self-hosted版をforkして自社で更新する運用設計を組んでおくのが現実的です。

self-hosted版X MCPの再試行なしとコミット停止

メルマガ登録


X MCPをAIエージェント業務に組み込みたい方へ

X MCPのような公式MCPサーバーは、AIエージェントを業務に組み込むための「接続点」として価値を発揮します。一方で、エージェント運用の本丸はどのツールをどう繋ぐかではなく、業務プロセスそのものの再設計にあります。

AI総研のAI業務自動化ガイドでは、MCPを含む各種ツールをエージェントから呼び出す設計、PoCから全社展開までの進め方、部門別ユースケース、運用上の統制・セキュリティのチェックポイントを220ページにわたって整理しています。

X MCPを「試したことがある」段階から「業務に定着している」段階に進める設計に取り組む際の出発点として、ご活用ください。

X MCPのような公式MCPを業務エージェントに組み込む

AI業務自動化ガイド

AI業務自動化ガイド(220ページ)

X MCPやGitHub MCP、Azure MCPのような公式MCPサーバーは、AIエージェントを業務に組み込むための新しい接続点です。AI業務自動化ガイドでは、MCPを含む各種ツールをエージェントから呼び出す設計、PoCから全社展開までの進め方、部門別ユースケースを整理しています。


まとめ

X MCPは、X開発者プラットフォームが公式に提供するMCPサーバーです。主役はX側でホストされる api.x.com/mcp と docs.x.com/mcp で、ローカルにはxurl bridgeだけを置けば Claude Code・Claude Desktop・Cursor・WindsurfからX APIを自然言語で呼び出せます。

別実装としてGitHubで公開されている self-hosted版(xdevplatform/xmcp・FastMCP・Python)は、自分でツールを細かく制御したいケースや学習用途で参照価値があり、READMEのallowlist一覧は119件・X API公開OpenAPIの operationId は約165件です。

X API側は2026年4月から従量課金に切り替わり、Owned Reads $0.001/件・通常POST $0.015/件・URL付POST $0.20/件の単価で、読み取り中心のPoCなら月数ドル単位から検証できます。

コミュニティ製のMindMadeLab/x-mcp・mbelinky/x-mcp-server・guzus/grok-mcp・armatrix/twitter-mcp と比較すると、公式X MCPはX API追従と網羅性で勝るものの、self-hosted版にはライセンス未明示・コミット停止・再試行なしといった割り切りが必要です。同名のbasementstudio/xmcpはTypeScript製MCPフレームワークで別物のため、混同に注意してください。

業務エージェントへの本格組み込みなら公式X MCP(ホスト型 or self-hosted版 + ALLOWLIST)、読み取りだけならGrok MCP、コアCRUDで足りるならMindMadeLab/x-mcp、というケース別の使い分けが現実的です。X MCPを起点に、AIエージェントとX APIをつなぐ運用設計を整えていく価値のあるツールと言えます。

監修者
坂本 将磨

坂本 将磨

Microsoft MVP・AIパートナー。LinkX Japan株式会社 代表取締役。東京工業大学大学院にて自然言語処理・金融工学を研究。NHK放送技術研究所でAI・ブロックチェーンの研究開発に従事し、国際学会・ジャーナルでの発表多数。経営情報学会 優秀賞受賞。シンガポールでWeb3企業を創業後、現在は企業向けAI導入・DX推進を支援。

関連記事

AI導入の最初の窓口

お悩み・課題に合わせて活用方法をご案内いたします
お気軽にお問合せください

AI総合研究所 Bottom banner

ご相談
お問い合わせは
こちら!