X MCPとは？公式サーバーの設定とX APIの料金・書き込みの範囲

X MCPとはX APIとドキュメント用の公式サーバー

X MCPとは、Xが運営するホスト型のMCPサーバーで、X APIのエンドポイントをAIツールから呼び出すためのものです。 エンドポイントとは、APIを呼び出すための接続先のことで、X MCPは、ポスト検索・ユーザー参照・ブックマーク・トレンド・ニュース・Articlesなどの機能を呼び出します。

MCP（Model Context Protocol）は、AIツールが外部サービスの機能を共通の手順で呼べるようにする規格です。対応するAIツールなら、ClaudeでもGrokでも同じサーバーに接続できます。

Xが公式に提供するMCPサーバーは2つあります。X APIを呼ぶX MCPと、開発者ドキュメントを調べるDocs MCPです。どちらもXが運営するホスト型で、同時に接続することもできます。

Xの公式MCPサーバー2つ

名前	URL	役割
X MCP	api.x.com/mcp	X APIのエンドポイントを呼ぶ
Docs MCP	docs.x.com/mcp	X APIのドキュメントを検索して読む

X MCPはStreamable HTTPのMCPサーバーで、プロトコルのバージョンは2025-06-18です。OAuthで接続する場合はクライアントを直接URLに接続せず、xurl mcpという橋渡しを挟みます。

対応するクライアントは、Grok Build・Cursor・Claude・VS Codeなどです。公開日はXがまだ公表していません。

Docs MCPのツールは、search_xとget_page_xの2つです。search_xは、ドキュメント全体から関連情報・コード例・APIリファレンス・ガイドを探します。get_page_xは、パスを指定してページの全文を取ります。

X MCPのツールは検索・ブックマーク・ニュースなど6分野

X MCPのツールは、Posts・Search・Users・Bookmarks・News & Trends・Articlesの6分野です。 xurl mcpを使ってOAuth 2.0でログインすると、モデルは本人のアカウント権限で動作します。

X MCPのツール6分野

分野	できること
Posts	ポストの取得と、いいね・リポスト・引用したユーザーの一覧取得
Search	全アーカイブのポスト検索・ユーザー検索・ニュース検索
Users	ログイン中ユーザーの取得・idやハンドルでの参照・ポストとタイムラインとメンションの読み取り
Bookmarks	ブックマークの一覧・追加・削除とフォルダの管理
News & Trends	ニュース記事の取得と、場所（WOEID）ごとのトレンド取得
Articles	Articlesの下書き作成と公開

X MCPのツールが属する6分野の中心は読み取りです。投稿を検索して話題を集める作業なら、読み取りのSearchとNews & Trendsのツールを使うことができます。書き込みが必要なのはブックマークの追加・削除とArticlesの2つで、範囲はこのあとの書き込みツール一覧で整理します。

書き込みツールの一覧はブックマークとArticlesの2種

X MCPの6分野で書き込みを伴うのは、ブックマークとArticlesの2種です。ただし、書き込みとユーザー文脈が必要なツールには、橋渡し経由のOAuth 2.0が必要になります。ユーザー文脈とは、ツールがユーザー本人のアカウントとして動作することを指します。

読み取りと書き込みの境界

ツール	種類	必要な認証
ポストの取得・検索・ニュース・トレンド	読み取り	Bearerトークン、または橋渡し（OAuth 2.0）
ブックマークの追加・削除とフォルダの管理	書き込み	橋渡し（OAuth 2.0）
Articlesの下書き作成と公開	書き込み	橋渡し（OAuth 2.0）

ご自身のブックマークをAIに整理させる場合を考えます。追加・削除とフォルダの管理は書き込みなので、Bearerトークンだけでは進められません。xurl mcpを使ってOAuth 2.0でログインした状態が必要です。

投稿の作成は公式の一覧に掲載されていない

投稿の作成は公式の能力表に掲載されていません。また、公式ページには投稿の可否を書いた文もありません。

書き込みとしてXが能力表に掲載しているのは、ブックマークの追加・削除とフォルダの管理、Articlesの下書き作成と公開です。投稿の自動化が目的なら、X MCPでポストを作成できるとは考えずに導入を判断します。ホスト型のX MCPでは、読み取りとブックマークだけで目的に合うかを先に確認するといいでしょう。

ご自身のマシンで動作させるxmcpの許可リストには、投稿の作成（createPosts）があります。ホスト型とは別のサーバーなので、違いはこのあとの「ホスト型サーバーとローカル版xmcpの違いは？」で整理します。

認証はOAuth 2.0とBearerトークンの2通り

X MCPに接続する際の認証は、OAuth 2.0のPKCEを使うxurl mcpと、読み取り専用のBearerトークンという2通りです。OAuth 2.0とは、本人が許可したうえでアプリが本人のアカウントとして動作する認証のことで、PKCEは、そのログインを安全に行う手順を指します。

Bearerトークンは、アプリに付く固定の鍵です。このトークンは読み取りだけに使います。どちらの経路でも、ご自身のX開発者アプリが前提になります。

Xの認証には動的クライアント登録が無く、api.x.com/mcpはMCPのOAuth自動検出にも対応していません。したがってOAuthを使うときは、クライアントをURLに直接接続できません。

ローカルの橋渡し（xurl mcp）をご自身のマシン上で動作させ、ログインとトークンの更新を任せます。以下ではXの呼び方にそろえて、橋渡しをブリッジとも書きます。

OAuth 2.0とBearerトークンの違い

経路	必要なもの	できること
xurl mcp（OAuth 2.0・PKCE）	開発者アプリ・CLIENT_ID・CLIENT_SECRET・Node.js	読み取り・書き込み・ユーザー文脈のツール。トークンは自動更新
Bearer直結	開発者アプリのApp-only Bearerトークン	読み取りのみ。トークンの自動更新は無い

つまり、書き込みやユーザー文脈が必要かどうかが、経路を選ぶ基準です。 ブックマークの追加やArticlesの下書きまでAIで行うなら、xurl mcpを使います。検索やトレンドを読み取るだけなら、クライアントがカスタムヘッダーに対応していれば、Bearerトークンで直接接続できます。

PKCEのログインはxurlブリッジ経由で行う

xurlの橋渡しは、アプリの識別・1回きりのログイン・トークンの更新を処理します。 npxで動作するので、別のインストールは必要ありません。

キャッシュにトークンが無い初回だけ、ブラウザが開いてOAuth 2.0のログインを求められます。以後のトークンは~/.xurlに保存され、401エラー後の強制更新を含めて自動で更新されます。

ブラウザの無いマシンでは、先にxurl auth oauth2 --headlessを実行してください。表示される認証URLに、ブラウザのある別のPCやスマートフォンからアクセスし、リダイレクト後のURLかコードを元のマシンへ貼り戻す流れです。

コマンドを実行する前に、CLIENT_IDとCLIENT_SECRETを同じシェルでexportしておきます。クライアント設定のenvブロックは橋渡しにしか効かず、手で動作させるxurlには効かないためです。

ログインで認可されるのは、ブラウザを開いた時点でログインしているXアカウントです。アプリを所有するアカウントとは限りません。別のアカウントで使うなら、先にブラウザでそのアカウントへ切り替えます。

Bearerトークンの直結は読み取り専用でクライアント次第

Bearerトークンの直結は読み取りだけの接続で、動作するかどうかはクライアントに左右されます。一方で、橋渡しもブラウザログインも必要ありません。

X Developer Portalでアプリを作り、アプリの「Keys and tokens」ページからApp-onlyのBearerトークンをコピーします。このトークンをMCPクライアントのAuthorizationヘッダーに指定すると、XのMCPサーバー（https://api.x.com/mcp）につながります。

ユーザー文脈が無いので、ユーザー本人のアカウントとしては動作できません。トークンの自動更新も無いので、差し替えるときはご自身で貼り直します。カスタムヘッダー付きのリモートMCPに対応するクライアントで動作するので、使うクライアントが対応しているかを先に調べておくといいでしょう。

VS Codeの場合は、.vscode/mcp.jsonのtypeをhttpにします。Xは完全な機能には橋渡しを勧めています。

X MCPの導入方法はxurlの準備とクライアントへの接続

X MCPの導入は、xurl mcpの準備とMCP対応クライアントへの接続という2段階で構成されています。Claudeなどのクライアントがxurl mcpに接続し、xurl mcpがapi.x.com/mcpに接続します。また、設定値はどのクライアントでも共通で、クライアントごとに異なるのは設定ファイルの場所と書き方だけです。

完全な経路（xurl mcp）の準備は、次の5つです。1つ目から3つ目は、X Developer Portalでの作業になります。

• OAuth 2.0を有効にしたX開発者アプリを作る
• リダイレクトURIのhttp://localhost:8080/callbackをアプリに登録する
• CLIENT_IDとCLIENT_SECRETを控える
• Node.jsを入れておく（npxで橋渡しを動作させるため）
• xurlを入れる（Xが勧める準備。橋渡し自体はnpxで動作する）

どのクライアントでも、設定値は次のとおりです。JSONでもTOMLでも、同じ4つの設定を書きます。

• command: npx
• args: -y・@xdevplatform/xurl・mcp・https://api.x.com/mcp
• env: CLIENT_IDとCLIENT_SECRET
• 起動タイムアウト: 300秒以上

初回のブラウザログインを待つ間に、クライアントが接続を切らないよう、タイムアウトは長めに設定します。300秒より短いと、起動時にタイムアウトすることがあります。

X APIアプリの設定でリダイレクトURIを登録

X APIアプリの設定では、Developer Portalでアプリを作り、リダイレクトURIを登録します。X APIの使い方としては、ここまでが最初の準備です。

1. アプリを作り、OAuth 2.0を有効にする
2. リダイレクトURIにhttp://localhost:8080/callbackを登録する
3. CLIENT_IDとCLIENT_SECRETをコピーして控える

リダイレクトURIは、ログインが終わったあとにXがブラウザを戻す先のアドレスです。このURIをアプリに登録していないと、初回のブラウザログインが完了しません。別のURIを使うなら、環境変数のREDIRECT_URIにそのURIを設定して、同じURIをアプリへ登録します。

xurlのインストールには、Homebrew・npm・GitHubのinstall.shの3通りがあります。橋渡し自体はnpxで動作するため、xurlの導入は必須ではありません。

Claude Desktopの設定JSONにxurlを書く

Claude Desktopでは、設定ファイルのclaude_desktop_config.jsonにmcpServersを書いて、xurlを呼び出します。また、macOSでの保存場所は~/Library/Application Support/Claude/、Windowsでは%APPDATA%\Claude\です。

{
  "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"
      }
    }
  }
}

書いたらClaude Desktopを再起動します。Xのツールはツールメニューに出ます。初回の利用ではブラウザが開くので、ログインしてください。

CursorとGrokは接続先をJSONかTOMLで書く

Cursorはmcp.jsonに、Grok Buildはconfig.tomlに、同じ値で接続先を書きます。 Cursorの形式は、上のClaude Desktopと同じmcpServersです。全プロジェクトで使うなら~/.cursor/mcp.jsonに、そのプロジェクトだけなら.cursor/mcp.jsonに置きます。

Cursorの設定画面でMCPを開き、xapiに緑色の丸印とツール一覧が出れば成功です。初回の利用で橋渡しが起動して、ブラウザが開きます。Grok Buildは、~/.grok/config.tomlのmcp_servers.xapiに書きます。

[mcp_servers.xapi]
command = "npx"
args = ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"]
enabled = true
startup_timeout_sec = 300

[mcp_servers.xapi.env]
CLIENT_ID = "YOUR_X_APP_CLIENT_ID"
CLIENT_SECRET = "YOUR_X_APP_CLIENT_SECRET"

1コマンドで追加するなら、grok mcp addを使います。接続状態を調べるにはgrok mcp doctor xapiを使い、ブラウザが開くのはツールの初回呼び出しかdoctorの実行時です。

VS Code（GitHub Copilotのエージェントモード）は、.vscode/mcp.jsonにserversを書きます。typeはxurl経由ならstdio、Bearer直結ならhttpです。

接続エラーはタイムアウトとURIの設定を調べる

接続エラーは、起動タイムアウト・リダイレクトURI・認証の失効・client-not-enrolledの4つから順に調べます。 Xのトラブルシュート表には8つの症状があり、このうち4つは次のとおりです。

接続エラーの症状と対処

症状	原因と対処
起動時にタイムアウトする	橋渡しがブラウザのログインを待っている。startup_timeout_secを300以上にする
ブラウザでリダイレクトのエラーが出る	http://localhost:8080/callbackをアプリに登録していないか、REDIRECT_URIが一致していない。登録するか、REDIRECT_URIをそろえる
401やtoken refresh failedが出る	アプリ資格情報の誤りか、リフレッシュトークンの失効。ログインをやり直す
ログイン後にclient-not-enrolledが出る	アプリが適切なパッケージと環境に登録されていない。ポータルでPay-per-useとProductionに移す

Xのトラブルシュート表にはほかに次の4症状も掲載されています。「接続エラーの症状と対処」にある4つと異なる症状が出たときは、次の4つを確認します。

• ブラウザが開かない（ディスプレイの無い環境）
• ブラウザに「Something went wrong」と出る
• npxが古いバージョンを取得する
• ツールの出力が空になるか文字化けする

ブラウザが開かないときは、先にxurl auth oauth2 --headlessを実行してください。文字化けを避けるには、クライアントを--verboseで実行しないようにします。標準出力をJSON-RPC専用に保つ必要があるためです。

X APIの料金は従量課金でブックマークは0.005ドル

X MCP専用の料金表は、公式MCPページにありません。 MCPが呼ぶのはX APIのエンドポイントなので、参考になるのはX APIの単価です。ただし、X MCPの呼び出しがその単価で課金されるかどうかについて、公式MCPページと公式料金ページはどちらも触れていません。

従量課金のX APIには契約も最低利用額も縛りも無く、いつでも始めていつでもやめられます。クレジットを先にDeveloper Consoleで購入し、リクエストのたびに差し引かれます。

単価はエンドポイントごとに違い、現在の額はDeveloper Consoleが正です。従量課金のプランで読むことができるポストは、1請求サイクルあたり300万件までで、300万件を超える場合はEnterpriseプランになります。

取得は返却1件ごと・書き込みは1リクエストごとに課金

X APIの取得は返却1件ごとに、書き込みは1リクエストごとに課金されます。X APIの主な単価は次のとおりです。

X APIの主な読み取り単価（返却1件あたり・2026年10月時点）

対象	単価
Posts	0.005ドル（約0.79円）
User	0.010ドル（約1.58円）
Following / Followers	0.010ドル（約1.58円）
Like / Mute / Block	0.001ドル（約0.158円）
ご自身のデータ（Owned Reads）	0.001ドル（約0.158円）

X APIの主な書き込み単価（1リクエストあたり・2026年10月時点）

対象	単価
Bookmark	0.005ドル（約0.79円）
Post: Create	0.015ドル（約2.37円）
Post: Create（URL付き）	0.200ドル（約31.6円）
DM Interaction: Create	0.015ドル（約2.37円）
List: Create	0.010ドル（約1.58円）

認証したユーザーがアプリの所有者本人で、そのデータを所有者のアプリが読む場合は、Owned Readsとして1件0.001ドル（約0.158円）です。また、UTC基準で区切った24時間の中なら、同じリソースを何度取得しても課金は1回分です。単価は変わることがあるため、実際の額はDeveloper Consoleで確認します。

支出の上限と残高の補充に関わる設定は2つです。支出上限は請求サイクルごとに設定でき、上限に達すると次のサイクルまでAPIリクエストが止まります。自動チャージは残高がしきい値を下回ると設定した額を補充する仕組みで、実行の上限は5分に1回となっています。残高がゼロか負の間は動作しません。

X APIの無料クレジットはカード登録で20ドル分

X APIの無料クレジットは、初めてカードを保存すると20ドル（約3,160円）分が付与されます。従量課金のアカウントが無料クレジットを得る方法は2つあり、もう1つは初回の自動チャージに連動して最大50ドル（約7,899円）です。つまり、両方を受け取ると合計70ドル（約1万1,059円）になります。

固定の使用量が毎月付く無料枠ではなく、使い切るか期限が来ると終わるクレジットです。20ドル（約3,160円）を得るには、次の4つをすべて満たす必要があります。

• そのカードがアカウントで最初のカードで、唯一の支払い方法である
• 過去に成功した支払いが無い
• クレジットカードかデビットカードである（プリペイドカードは対象外）
• そのカードが過去にクレジットを得ていない

自動チャージに連動する分は初回の自動チャージと同額で、5ドル（約790円）なら5ドル（約790円）が付与され、100ドル（約1万5,798円）でも上限の50ドル（約7,899円）です。付与は、最初の自動チャージが実際に成功したときに行われます。

クレジットは付与から3か月で失効し、購入したクレジットより先に使われます。現金価値は無く、引き出し・返金・移転はできません。Xは2026年10月時点でこの仕組みを順次展開中としているため、ご自身のアカウントで有効かは、Developer ConsoleのBillingにあるCreditsで確認します。無料クレジットで試すことを見込むなら、付与を確認してから接続するといいでしょう。

ホスト型サーバーとローカル版xmcpの違いは？

ホスト型のX MCPではXが運営するapi.x.com/mcpにxurl mcpで接続し、xmcpではご自身のマシンでPythonのサーバーを実行します。 違いは、サーバーが動作する場所とツール範囲の決め方にあります。

ホスト型X MCPとxmcpの違い

比較の観点	ホスト型	xmcp
実行する場所	Xが運営するapi.x.com/mcp	ご自身のマシンで動作するPythonサーバー
必要なもの	開発者アプリ・Node.js・xurl mcp	Python 3.9以上・開発者アプリ
認証の持ち方	橋渡しがOAuth 2.0のトークンを保管	.envにキーとトークンを書く
使うツールの選択	能力表の6分野（ツールを選ぶ設定はXが公表していない）	許可リストで読み込むツールを選ぶことができる
書き込み系ツール	ブックマークとArticles	許可リストにcreatePostsなどがある

xmcpは、GitHubのxdevplatform/xmcpで公開されているX API用のローカルMCPサーバーです。MCPのエンドポイントは、デフォルトでhttp://127.0.0.1:8000/mcpになります。リモートのクライアントに使わせたいときは、ngrokなどのトンネルでローカルのサーバーを公開します。

.envに書くのは、X_OAUTH_CONSUMER_KEY・X_OAUTH_CONSUMER_SECRET・X_BEARER_TOKENの3つです。許可リストはX_API_TOOL_ALLOWLISTで指定し、起動時に適用されるので、変更したら再起動します。

ホスト型X MCPも、serverInfoの名前はxmcpです。同じ名前が別々の2つを指すので、混同しないよう注意します。選ぶ基準は、Xが運営するサーバーに任せるかご自身のマシンで動作させて書き込み系を含むツールを限定するかです。

トークンを専用アプリと最小スコープで守りレート制限に備える

Xの運用指針は4つあり、トークンの管理と書き込みのレート制限を最初に調べます。 書き込みを伴うX MCPでは、トークンの管理とレート制限を先に押さえておくといいでしょう。

1. トークンは秘密情報として管理する。 ~/.xurlとアクセストークンを、チャット・ログ・共有の設定に貼りません。生の秘密情報はコミットせず、環境変数を参照する設定ファイル（プロジェクトごとの.mcp.jsonや.grok/config.toml）を使います。
2. MCP専用のアプリを用意して使う。 MCP専用のアプリには必要なスコープだけを設定します。他用途のアプリと共用すると、トークンが流出したときの影響範囲が拡大します。
3. 書き込みのレート制限に前もって備える。 書き込みは読み取りより厳しい制限にカウントされ、429エラーが時々出ます。その場合は少し待ってから再試行します。
4. 橋渡しの通信範囲を前もって知っておく。 橋渡しの処理はローカルで動作します。Bearerトークンとして暗号化通信（TLS）でapi.x.comへ送信される場合を除き、資格情報はご自身のマシンから出ません。

レート制限の数字は、ブックマークの取得がユーザー単位で15分に180回です。追加と削除は、どちらもユーザー単位で15分に50回になります。429が出たら、制限の期間が終わってリセットされるまで待ってください。

レート制限と課金は別なので、上限の内側でも費用は出ます。逆に費用が発生しなくても、上限に達することがあります。

まず開発者アプリとBearerで読み取りを試す

X MCPはXが運営するホスト型のMCPサーバーで、X APIをAIツールから呼び出します。 もう1つのDocs MCPは、開発者ドキュメントの検索用です。接続にはご自身のX開発者アプリが必要で、経路はxurl mcpのOAuth 2.0（書き込みあり）かBearer直結（読み取りのみ）の2つです。

書き込みの対象には、ブックマークとArticlesがあります。通常のポスト作成は公式の一覧に掲載されていません。料金はX MCP専用の表が無く、参考になるのはX APIの従量課金です。

MCP全体の動向と仕様の更新点は、それぞれ別の記事にあります（関連記事：MCPロードマップ2026【長時間タスクとエージェント認証が重点】、MCP仕様2026-07-28版の最新アップデート、ステートレス化の要点）。最初の一歩は、開発者アプリを作ってBearerトークンで読み取りを試すことです。 書き込みが必要になった段階で、xurl mcpに切り替えます。