X MCPとは？AIからXを操作できる公式MCPサーバーの設定方法と注意点

Q: Client Secretはどこに貼ればいいですか？

MCP設定ファイルのenvに入れる形が多いですが、公開リポジトリや記事、チャットには貼らないでください。

Q: AIに投稿まで任せても大丈夫ですか？

最初から投稿権限まで渡すのはおすすめしません。検索、要約、下書き作成から始め、人間確認を挟むことが重要です。

Q: X MCPは何に使うのが実用的ですか？

トレンド調査、投稿分析、過去投稿の棚卸し、記事用リサーチ、API仕様確認などに使いやすいです。

Xが公式にMCPサーバーを用意したことで、MCP対応AIからX APIやX APIドキュメントへつなぎやすくなりました。この記事では、X MCPの概要、設定方法、使いどころ、注意点を整理します。

なお、X API操作は認証や権限が絡みます。この記事ではClient IDやClient Secretを例示しますが、実際の値を記事やチャットに貼り付けないよう注意してください。

総統の結論

総統

X MCPは、AIからXを検索・投稿・分析しやすくする強力な仕組みだ。だが、権限を渡すということは、暴走した時の被害も大きい。エゴサ程度で泣く余に、投稿権限まで渡すのは危険なのだ！

この記事でわかること

X MCPとは何か
api.x.com/mcp と docs.x.com/mcp の違い
Developer Portalで準備すること
Cursor、Claude Desktop、VS Codeでの設定例
X MCPでできること
AIにXアカウント権限を渡す時の注意点

戦闘員、XをMCPで操作してしまう

戦闘員

アカネ先生、X MCPつないでみたっす。AIに『今日のAI関連投稿を調べて要約して』って頼めるの、かなり便利っすね。

総統

戦闘員！何をこそこそXなど見ておる！余の偉大な広報活動をサボっているのではないか！

戦闘員

いや、サボってないっす。XのMCPサーバーをAIにつないで、投稿検索とかドキュメント確認をしてるっす。

総統

なに、AIがXを操作できるだと？戦闘員、今すぐ余にもやり方を教えよ。もちろん設定作業は全部そなたがやるのだ！

アカネ先生

総統、聞き方がもうAPI制限超えてますわぁ。権限渡す系の設定は、勢いでやるもんちゃうで。

X MCPとは？

X MCPは、MCP対応AIツールからXのAPIやドキュメントへ接続しやすくするための公式MCPサーバーです。MCPはModel Context Protocolの略で、AIアプリと外部ツールやデータをつなぐための共通規格です。

今回のポイントは、XがHosted MCPサーバーを用意したことで、Cursor、Claude Desktop、VS CodeなどのMCP対応ツールから、X API操作やX APIドキュメント参照を扱いやすくなったことです。

https://api.x.com/mcp：X API操作用のMCPサーバー。ユーザー認証が必要です。
https://docs.x.com/mcp：X APIドキュメント参照用のMCPサーバー。AIが仕様確認に使いやすい入口です。

公式ドキュメントはこちらです。
X Docs MCP

まず必要なもの

X APIを操作する場合は、X Developer Portalでアプリを作成し、OAuth 2.0の設定を行う必要があります。投稿や検索など、どこまでAIに任せるかは権限設計にも関わるので、最初は最小権限で試すのが無難です。

X Developer Portalへのアクセス
OAuth 2.0を有効にしたアプリ
Client IDとClient Secret
Node.js
MCP対応AIツール

アカネ先生

Client Secretは名前の通り秘密やで。記事、チャット、スクショ、GitHubに貼ったらあかん。総統の黒歴史より厳重に扱わなあかんで。

Developer Portalでの準備

まず X Developer Console にログインし、アプリを作成します。OAuth 2.0を有効にして、Redirect URIにローカルのコールバックURLを追加します。

App Name: My MCP App
OAuth 2.0: Enabled
Redirect URIs:
  - http://localhost:8080/callback
Client ID:     xxxxxxxxxxxxxxxxxxxx
Client Secret: yyyyyyyyyyyyyyyyyyyy

初回認証時にブラウザが開き、Xログインと許可画面を通る流れになります。ヘッドレス環境やタイムアウトが起きる環境では、事前認証やタイムアウト延長が必要になる場合があります。

共通コマンド：xurl経由でMCP接続する

X API操作用サーバーへつなぐ時は、X公式の認証付きCLIである @xdevplatform/xurl を使う構成が案内されています。npm上でも Auth-enabled curl-like CLI for the X API と説明されています。

npx -y @xdevplatform/xurl mcp https://api.x.com/mcp

Docs側はURL指定で使える構成が多いです。AIにX API仕様を確認させたい場合は、https://docs.x.com/mcp もあわせて設定しておくと便利です。

Cursorでの設定例

Cursorでは、ユーザー設定またはプロジェクト単位のMCP設定に追加します。設定ファイルの場所は環境によって変わるため、CursorのMCP設定画面やドキュメントも確認してください。

{
  "mcpServers": {
    "xapi": {
      "command": "npx",
      "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
      "env": {
        "CLIENT_ID": "あなたのClient ID",
        "CLIENT_SECRET": "あなたのClient Secret"
      },
      "startupTimeout": 300
    },
    "x-docs": {
      "url": "https://docs.x.com/mcp"
    }
  }
}

Claude Desktopでの設定例

Claude Desktopでは、設定JSONへMCPサーバーを追加します。Windowsなら %APPDATA%\Claude\claude_desktop_config.json、macOSなら ~/Library/Application Support/Claude/claude_desktop_config.json が代表的です。

{
  "mcpServers": {
    "xapi": {
      "command": "npx",
      "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
      "env": {
        "CLIENT_ID": "あなたのClient ID",
        "CLIENT_SECRET": "あなたのClient Secret"
      }
    },
    "x-docs": {
      "url": "https://docs.x.com/mcp"
    }
  }
}

VS Codeでの設定例

VS CodeでMCPを使う場合は、ワークスペース内の .vscode/mcp.json に設定する構成が使われます。

{
  "servers": {
    "xapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@xdevplatform/xurl", "mcp", "https://api.x.com/mcp"],
      "env": {
        "CLIENT_ID": "あなたのClient ID",
        "CLIENT_SECRET": "あなたのClient Secret"
      }
    }
  }
}