X公式MCPサーバーでClaude CodeからXを自動運用する方法

MCP（Model Context Protocol）を使えば、Claude Codeにさまざまな外部サービスを接続できます。この記事では、X（旧Twitter）の公式MCPサーバー「xmcp」を使って、Claude CodeからXへの投稿を自動化する方法を紹介します。

実はこのサイト「Automata Room」でも、記事公開の告知投稿にこの仕組みを活用しています。Pythonスクリプトを1行も書かずに、Claude Codeに「この記事をXで告知して」と言うだけで投稿が完了します。

xmcpとは ― X公式のMCPサーバー

xmcpは、X Developer Platformが公式にリリースしたMCPサーバーです。2026年2月のX API Pay-Per-Useモデル導入と同時に公開されました。

GitHubのxdevplatform組織アカウント配下で公開されており、X APIのOpenAPI仕様から150以上のツールを自動生成してMCPとして提供します。つまり、Claude Codeから「投稿して」「検索して」「トレンドを見て」と言うだけで、X APIのほぼ全機能が使えます。

セットアップ手順 ― 4ステップで完了

xmcpのセットアップは、クローン・環境変数設定・起動・Claude Code接続の4ステップです。

• API Key（Consumer Key）と API Secret（Consumer Secret）を取得
• Bearer Tokenを生成（Keys and Tokensセクション）
• App Permissionsを「Read and Write」に設定
• Callback URLにhttp://127.0.0.1:8976/oauth/callbackを登録

既存のX APIキーとの対応表はこちらです。

既存の変数名	xmcpでの変数名	状態
X_API_KEY	X_OAUTH_CONSUMER_KEY	同じ値
X_API_SECRET	X_OAUTH_CONSUMER_SECRET	同じ値
X_ACCESS_TOKEN	（不要）	ブラウザ認証で自動取得
X_ACCESS_TOKEN_SECRET	（不要）	ブラウザ認証で自動取得
（なし）	X_BEARER_TOKEN	新規生成

# クローン
git clone https://github.com/xdevplatform/xmcp.git
cd xmcp

# 仮想環境構築
python -m venv .venv

# 有効化（Windows）
.venv\Scripts\activate

# パッケージインストール
pip install -r requirements.txt

# .env を作成
cp env.example .env

.envを編集して、以下の3つの値を設定します。

# 必須の3つ
X_OAUTH_CONSUMER_KEY=（あなたのAPI Key）
X_OAUTH_CONSUMER_SECRET=（あなたのAPI Secret）
X_BEARER_TOKEN=（生成したBearer Token）

# ツールを投稿に必要なものだけに制限（推奨）
X_API_TOOL_ALLOWLIST=createPosts,getUsersMe,searchPostsRecent,initializeMediaUpload,appendMediaUpload,finalizeMediaUpload,createMediaMetadata

# サーバー起動
python server.py

# → ブラウザが開いてXの認証画面が表示される
# → 「Authorize app」をクリック
# → ターミナルに「MCP endpoint: http://127.0.0.1:8000/mcp」と表示されれば成功

# Claude Code に xmcp を追加
claude mcp add --transport http xmcp http://127.0.0.1:8000/mcp

# 確認
claude mcp list
# → xmcp が表示されればOK

最初の投稿をしてみる

セットアップが完了したら、さっそくClaude Codeから投稿してみましょう。

接続テスト

まずは自分のアカウント情報を取得して、接続を確認します。

# Claude Codeで入力
> 接続しているXアカウントの情報を教えて

# Claude Codeが getUsersMe ツールを呼び出し、アカウント情報を表示
# → ユーザー名、表示名、フォロワー数などが返ってくる

テスト投稿

# Claude Codeで入力
> Xに「テスト投稿です。Claude Codeから自動投稿しています。」と投稿して

# Claude Codeが createPosts ツールを呼び出し
# → 投稿が完了し、投稿URLが返ってくる

投稿前のチェック

実用的な投稿では、重複チェックも自然言語で指示できます。

# Claude Codeで入力
> 直近の自分の投稿を確認して、同じ内容がなければ
> 「新記事を公開しました！ 配色理論×AI画像生成の完全ガイドです。」
> と投稿してください。ハッシュタグは #AIイラスト #配色 で。

# Claude Codeの動作:
# 1. searchPostsRecent で直近の投稿を確認
# 2. 重複がないことを確認
# 3. createPosts で投稿
# 4. 投稿URLを報告

自動投稿ワークフローを作る

手動で「投稿して」と打つだけでも便利ですが、定期的な投稿を完全に自動化することもできます。ここでは2つのパターンを紹介します。

パターン1: 記事公開時の告知投稿

ブログ記事を公開したら、その告知をXに自動投稿するフローです。

投稿ルールはプロンプトテンプレートとしてファイルに定義しておきます。これにより、毎回ルールを手で書く必要がありません。

# x-automation/prompts/article-announce.md の例

## 投稿対象の記事情報
- タイトル: {{TITLE}}
- URL: {{URL}}

## 投稿ルール
- リアの口調で書く（カジュアル、一人称「あたし」）
- 140文字以内（URL・ハッシュタグ含む）
- ハッシュタグ2-3個
- 禁止表現: 「絶対に」「今すぐ」「ヤバい」等

## 投稿例
「新しい記事書いたよ〜！ 今回は{{テーマ}}について
解説してみたの。よかったら読んでね！ {{URL}}
#AutomataRoom #AIイラスト」

パターン2: 定期ニュース投稿

毎日決まった時間にAI関連のニュースやTipsを投稿するフローです。これにはタスクスケジューラを使います。

スケジューラの設定例です。Node.jsベースのcronスケジューラや、OS標準のタスクスケジューラで定期実行します。

# タスク定義の例（scheduler用）
{
  "name": "X定期ニュース投稿",
  "prompt": "prompts/daily-news.md の内容に従って投稿してください",
  "schedule": "毎日18:00（平日のみ）"
}

スクリプトを書かない設計

従来のX自動投稿では、Pythonで認証処理・API呼び出し・エラーハンドリングをコーディングする必要がありました。xmcp方式では、その全てが不要になります。

# 従来の方式（Pythonスクリプトが必要）
import requests_oauthlib

auth = OAuth1(API_KEY, API_SECRET, ACCESS_TOKEN, ACCESS_SECRET)
response = requests.post(
    "https://api.twitter.com/2/tweets",
    json={"text": "投稿本文"},
    auth=auth
)
# エラーハンドリング、リトライ、ログ記録…全て自分で書く

# xmcp方式（スクリプト不要）
> 「この記事をXで告知して」

# Claude Codeが全てやってくれる:
# - 認証 → xmcpが処理
# - API呼び出し → MCPツールとして呼び出し
# - エラーハンドリング → Claude Codeが判断
# - 投稿文の生成 → Claude Codeが作成

注意点とコスト

API料金（Pay-Per-Use）

xmcpサーバー自体は無料のOSSですが、X APIの呼び出しに従量課金が発生します。

操作	APIエンドポイント	単価
ツイート読み取り	searchPostsRecent	$0.005 / 件
ユーザー情報取得	getUsersMe	$0.010 / 件
投稿作成	createPosts	$0.010 / 件
DM送信	createDirectMessages	$0.015 / 件

OAuth認証の制約

xmcpの最大の注意点は、サーバー再起動のたびにブラウザ認証が必要なことです。

• OAuth 1.0aトークンはメモリ内にのみ保持される
• サーバーを停止するとトークンが消える
• 完全無人運用には、xmcpサーバーの常時稼働が前提

セキュリティ

• .envファイルは絶対にgitにコミットしない（.gitignoreに追加）
• API Key / Secret / Bearer Tokenをコード内にハードコードしない
• X_API_TOOL_ALLOWLISTで必要なツールだけに制限する
• 定期的にX Developer Consoleで使用状況を確認する

応用 ― さらに便利な使い方

記事内容を要約して投稿

Claude Codeは記事のHTMLを直接読めるので、「記事の内容を読んで要約し、告知文を作成して投稿」という一連の流れも指示1つで可能です。

> blog/color-theory-ai-illustration.html を読んで、
> その内容をリアの口調で140文字以内に要約し、
> 記事URLとハッシュタグ付きでXに投稿して

トレンドに合わせた投稿

xmcpにはトレンド取得ツールもあるので、今の話題に合わせた投稿も可能です。

> 日本のXトレンドを確認して、
> AIに関連するトレンドがあれば
> リアの口調でコメントを投稿して

投稿分析

> 直近10件の自分の投稿を取得して、
> エンゲージメント（いいね数、RT数）を一覧にまとめて

まとめ

X公式MCPサーバー「xmcp」を使えば、PythonスクリプトなしでClaude CodeからXの投稿を自動化できます。

• 公式サポート: X Developer Platformが提供するOSS。150以上のAPIエンドポイントに対応
• セットアップ4ステップ: Developer Portal設定 → クローン → .env設定 → Claude Code接続
• スクリプト不要: プロンプトテンプレートが「実行可能な指示書」として機能
• 低コスト: 個人利用で月$1未満。$10バウチャー付き
• 応用自在: 投稿・検索・分析・トレンドチェックまで自然言語で操作

MCPの基本を理解している方は、ぜひxmcpで「MCPの実践」を体験してみてください。「コードを書かずにXを自動運用する」という新しい体験が待っています。