【2026年】X（Twitter）公式MCP完全ガイド！AIエージェントで検索・投稿・トレンド取得を自動化する方法

---

「XのデータをAIエージェントから直接操作できたら…」

X（旧Twitter）が2026年、公式のMCP（Model Context Protocol）サーバーをリリースしました。これにより、Grok Build / Cursor / Claude Desktop / VS Code などのAIツールから、XのAPIを直接呼び出せるようになりました。

この記事では：

• MCPとは何か（超初心者向け解説）
• Xが提供する2つのMCPサーバーの違い
• セットアップ手順（2つのルート）
• 各AIツールでの設定方法
• 実践的な使い方とプロンプト例

を、できるだけわかりやすく解説します。

公式ドキュメント: X公式MCPドキュメント

---

まず：MCPって何？3行でわかる

MCP（Model Context Protocol）は、AIエージェントと外部サービスをつなぐ標準プロトコルです。

イメージで言うと：

• USB-C = どんなデバイスでも同じケーブルで接続できる（標準化）
• MCP = どんなAIツールでも同じ方法で外部サービスと接続できる（標準化）

今までは「Cursor用のX連携プラグイン」「Claude用のX連携プラグイン」を別々に用意する必要がありましたが、MCP対応すれば1つの設定で全てのAIツールから使えます。

---

X MCPの概要：2つのサーバー

Xは公式で2つのMCPサーバーを無料公開しています。

X MCP がメインの実用的なサーバーで、Docs MCP は開発中のAPIリファレンス確認用です。両方を同時に繋ぐこともできます。

---

X MCPでできること

X MCPをAIツールに接続すると、以下の操作が可能になります。

---

セットアップ手順

X MCPを使うには2つのルートがあります。

ルートA：カンタン設定（ReadOnly・認証不要の簡易版）

X APIのApp-only Bearer Tokenを使う方法。読み取り専用で、ユーザーコンテキストなし。

所要時間: 5分

1. X Developer Portal にアクセス
2. アプリを作成 → 「Keys and tokens」から Bearer Token をコピー
3. AIツールのMCP設定に以下を追加するだけ：

{
  "mcpServers": {
    "xapi": {
      "url": "https://api.x.com/mcp",
      "headers": {
        "Authorization": "Bearer あなたのBearerToken"
      }
    }
  }
}

制限: 読み取り専用。自分のアカウントとしての操作は不可。

ルートB：フル設定（xurl OAuthブリッジ）

xurlブリッジを使うと、OAuth 2.0で自分のアカウントとして操作できます。書き込み（ブックマーク・記事作成 etc.）も可能。

所要時間: 10分

Step 1: X APIアプリを作成

1. X Developer Portal でアプリ作成
2. OAuth 2.0を有効化
3. リダイレクトURIに http://localhost:8080/callback を登録
4. Client ID と Client Secret をメモ

Step 2: xurlのインストール（お好みで）

# Homebrew（推奨）
brew install --cask xdevplatform/tap/xurl

# npmでも可
npm install -g @xdevplatform/xurl

# 直接インストールスクリプト
curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash

Step 3: AIツールに設定する

xurlはインストールしなくても、npx経由で使えます。 各AIツールのMCP設定に以下を追加するだけでOK。

---

各AIツールでの設定方法

1. Grok Build

~/.grok/config.toml に追加：

[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 = "あなたのClient ID"
CLIENT_SECRET = "あなたのClient Secret"

2. Cursor

~/.cursor/mcp.json（全プロジェクト共通）または .cursor/mcp.json（プロジェクト単位）に追加：

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

設定後、Cursor → Settings → MCP で xapi が緑色のドットで表示されれば成功。

3. Claude Desktop

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

Claude Desktopを再起動すると、🔌メニューにXのツールが表示されます。

4. VS Code（GitHub Copilot Agent mode）

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

5. Docs MCPも同時に使う

ドキュメント検索も同時に使いたい場合、両方のサーバーを設定します。

Grok Buildの場合:

[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 = "あなたのClient ID"
CLIENT_SECRET = "あなたのClient Secret"

[mcp_servers."x-docs"]
url = "https://docs.x.com/mcp"
enabled = true

Cursor / Claudeの場合:

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

---

実践的な使い方：プロンプト例

X MCPを接続したAIエージェントには、以下のような指示が自然に通ります。

検索・分析系

「直近1週間で「AIエージェント」に関するトレンド投稿を検索して、よく使われているハッシュタグを分析して」

「@usernameの最近のポストを取得して、エンゲージメント率が高い投稿の特徴を分析して」

「日本のトレンドトピックを取得して、テクノロジー関連のものをリストアップして」

運用・管理系

「この記事の内容をX（Twitter）に投稿して。ハッシュタグは #AI #OpenClaw をつけて」

「今週投稿したポストのインプレッション数を調べて、一番反応が良かった投稿を特定して」

開発・調査系

「X APIのPOST作成エンドポイントについて、ドキュメントを検索して必要なパラメータを教えて」

「XのAPIを使って、特定のユーザーのタイムラインを取得するコードをPythonで書いて」

---

注意点とベストプラクティス

認証情報の管理

• CLIENT_ID / CLIENT_SECRET は設定ファイルに直接書かない。環境変数から参照するのがベスト
• ~/.xurl にキャッシュされるトークンも同様に機密情報として扱う

レート制限

• 書き込み系（ブックマーク追加、記事公開など）はレート制限が厳しめ
• 429エラーが返ってきたら、バックオフ（少し待ってから再試行） する

初回ログインについて

• 初回はブラウザが開いてXのOAuth認証が必要
• startup_timeout_sec は 300 以上に設定すること（これが短いとタイムアウトする）
• ヘッドレスサーバーの場合は、事前に xurl auth oauth2 --headless で認証しておく

トラブルシューティング

---

まとめ：X MCPでAI×SNS運用を次のレベルへ

Xが公式MCPサーバーを公開したことで、AIエージェントとXの連携が劇的に簡単になりました。

• 設定は1回 → すべてのMCP対応AIツールで使える
• 読み取り専用なら5分で完了（Bearer Tokenだけ）
• フルアクセスでも10分（xurl OAuthブリッジ）
• Grok / Cursor / Claude / VS Code など主要ツールに対応

「Xのトレンドを分析してレポートを自動作成」「新着記事を自動ツイート」「競合アカウントの監視」など、これまでは個別にスクリプトを書く必要があった作業が、AIに自然言語で指示するだけで完了します。

今すぐ始める:

Bear Tokenを取得してAIツールの設定に貼り付けるだけ。

# ReadOnlyならこれだけでOK（Groq/Cursor/Claude）
# 設定ファイルに以下を追加:
{
  "url": "https://api.x.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_BEARER_TOKEN"
  }
}

• 公式ドキュメント: X公式MCPドキュメント
• xurl（OAuthブリッジ）: GitHub - xdevplatform/xurl

---

合わせて読みたい

• 【2026年】Claude Fable 5で金融資産を守る！AIエージェントによる資産管理・監視・最適化の実践ガイド
• 【2026年】Cloudflare Monetization Gateway完全ガイド！Webページ・API・MCPツールに「1回の課金」をかける方法
• 【2026年】A Fable of Codexes完全ガイド — Claudeが指揮するAIワーカー軍団の作り方
• 【2026年】GPT-Live完全ガイド！OpenAIのフルデュプレックス音声AIがChatGPTを根本から変える
• 【2026年】component.galleryを使ってAIのUI生成指示を劇的に上手くする方法！コンポーネント用語図鑑の活用法