本文へ移動

Tech Notes技術ノート / 詳細

一覧へ戻る
業務自動化

Xへの投稿をMCPで自動化したい。公式MCPの全24ツールを試した結論

Xの公式MCPに投稿ツールは無い ― 投稿は xurl で X の API を直に叩く

福岡で AI による業務改善や自動化、Web 制作などに取り組んでいる Trellis です。
インプットの自動化はずいぶん進んだのに、アウトプット、つまり X(旧 Twitter)への発信だけは毎回手で打っている。そんなちぐはぐさ、ありませんか。

私は情報収集まわりはかなり自動化してきました。でも X への投稿は、結局その都度ブラウザを開いて書いて出す、の繰り返しです。この投稿という行為そのものを Claude Code から自動で流せたら、と前から思っていました。

そこに 2026 年 6 月末、X が公式の MCP サーバーを出しました。「これで投稿を自動化できる」と期待して繋いだのですが、結論から言うと、狙っていた投稿の自動化はこの MCP ではできませんでした。ただ、全24ツールを実際に叩いてみると、できること・できないこと・課金しないと届かないことの線引きがはっきりしたので、そこを共有します。

期待して繋いだら、投稿ツールが無かった

X は 2026 年 6 月 30 日に公式 MCP サーバーを公開しました。@xdevplatform/xurl という CLI が、Claude Code の標準入出力と X の API(https://api.x.com/mcp)の間をリレーします。

期待して繋いで、まず投稿系のツールを探しました。無いんです。投稿の作成・削除に当たるツールは、現時点の公式 MCP サーバーに搭載されていません。 用意されているのは、閲覧・分析・ブックマーク管理まわりの24ツール。「MCP でツイートを自動投稿する」は、少なくとも今は叶いませんでした。

MCP サーバーが返す全ツール(tools/list の結果)を並べると、こうなります。ちょうど24個。create_ で始まるのはブックマーク系だけで、ツイートを作る・消すツールはどこにもありません。

テキスト
# X 公式 MCP が返す全24ツール(name / description)

# ユーザー情報
get_users_me                      Get Users Me
get_users_by_id                   Get Users by ID
get_users_by_username             Get Users by Username
get_users_by_usernames            Get Users by Usernames
search_users                      Search Users

# 投稿・タイムライン(すべて読み取り)
get_users_posts                   Get Users Posts
get_users_timeline                Get Users Timeline
get_users_mentions                Get Users Mentions
get_posts_by_id                   Get Posts by ID
get_posts_by_ids                  Get Posts by IDs
get_posts_counts_recent           Get Posts Counts Recent

# エンゲージメント
get_posts_liking_users            Get Posts Liking Users
get_posts_reposted_by             Get Posts Reposted by
get_posts_quoted_posts            Get Posts Quoted Posts

# 検索・トレンド・ニュース
search_posts_all                  Search Posts All
get_trends_by_woeid               Get Trends by Woeid
search_news                       Search News
get_news                          Get News

# ブックマーク
get_users_bookmarks               Get Users Bookmarks
create_users_bookmark             Create Users Bookmark
delete_users_bookmark             Delete Bookmark
get_users_bookmark_folders        Get Users Bookmark Folders
create_users_bookmark_folder      Create Bookmark Folder
get_users_bookmarks_by_folder_id  Get Users Bookmarks by Folder ID

投稿を取得・分析する read 系のツールは、description の末尾に Each returned post includes a url deeplinking to it on x.com(各結果に x.com へのリンクが付く)が添えられます。

がっかりして終わるのももったいないので、繋いだついでに全24ツールを叩いて「では何ができるのか」を確かめました。そして最後に、本命の投稿自動化を MCP の外でどう実現するかまで書きます。

繋ぐ:OAuth 2.0 でつまずく1点

ツールを試すにも、まず接続です。ここで1か所だけ確実に詰まるポイントがあるので先に潰しておきます。

Client ID が見つからない(OAuth 1.0a と 2.0 の混同)

xurl は OAuth 2.0 の PKCE フローで認証します。必要なのは Client ID と Client Secret の2つです。

ところが X Developer Portal でアプリを作ると、最初に出てくるのは Consumer Key・API Key Secret・Bearer Token の3点セットでした。これは OAuth 1.0a 用の認証情報で、xurl が使う OAuth 2.0 とは別物です。「Client ID がどこにも無い」で、ここで一度手が止まりました。

正解は、Developer Portal の User Authentication Settings を設定すること。これを保存して初めて OAuth 2.0 の Client ID / Secret が発行されます。設定を触る前は存在すらしないのが引っかかりどころでした。順序が直感に反しているので、同じところで詰まる人はきっといます。実際の画面で順に追っていきます。

1. Developer Console でアプリを作る

X Developer Console の左メニュー「アプリ」を開き、右上の作成ボタンをクリックします。

Developer Console の「アプリ」画面。右上の作成ボタンから新規アプリを作る

アプリケーション名を入力し、Environment(ここでは Production)を選んで「新しいクライアントアプリケーションを作成」をクリックします。

アプリ作成ダイアログ。名前と Environment を決めて作成する

2. 最初に出る鍵は「OAuth 1.0a」だと知っておく

作成直後、コンシューマーキー・Secret Key・ベアラートークンが表示されます。「これを xurl に使うのかな」と思いがちですが、これは OAuth 1.0a の認証情報で、xurl には使いません。 一度きりの表示なので、保存だけして×で閉じて構いません。

作成直後に出る OAuth 1.0a の3点セット。xurl では使わない

3. 「ユーザー認証設定」をセットアップする

アプリの「Keys & Tokens」タブを開き、一番下の「ユーザー認証設定」にある「セットアップ」をクリックします。ここが OAuth 2.0 の入口です。

Keys & Tokens タブ下部の「ユーザー認証設定」→「セットアップ」

4. 認証設定フォームを埋める(必須項目に注意)

必須項目を設定します。ポイントは3つです。

  • アプリの権限:閲覧だけなら「読む」で十分ですが、xurl から投稿もしたいなら「読み取りと書き込み」を選びます(この権限を後から変えたら、OAuth ログインをやり直してトークンを取り直します)。
  • アプリの種類:「ウェブアプリ、自動化アプリまたはボット(機密クライアント)」を選ぶと OAuth 2.0 が有効になります。
  • アプリ情報(必須):
    • コールバックURI / リダイレクトURL → http://localhost:8080/callback(後で xurl auth apps add に渡す値と完全一致させます)
    • ウェブサイトURL → 自分が持つ有効な公開URL(localhost は不可。認証の動作には影響しないメタ情報なので、Zenn やブログの URL でよい)

入力したら「変更を保存する」をクリックします。

認証設定フォーム。権限・アプリの種類・コールバックURI・ウェブサイトURL を設定して保存

5. OAuth 2.0 の Client ID / Secret を受け取る

保存すると、ようやく OAuth 2.0 のクライアントID・クライアントシークレットが表示されます。これが xurl に渡す値です。こちらも一度きりの表示なので、必ずコピーして安全な場所に保存します。

保存後に表示される OAuth 2.0 のクライアントID / クライアントシークレット。これが xurl に渡す値

最初に迷った「Client ID がどこにも無い」は、これで解決です。Client ID は User Authentication Settings を保存して初めて生まれる、という順序でした。

認証を通して .mcp.json に登録する

取得した認証情報でアプリを登録し、OAuth ログインを済ませます。

コード
# アプリ登録(Client ID / Secret は環境変数から。ソースにはコミットしない)
xurl auth apps add prd-mcp \
  --client-id "$CLIENT_ID" \
  --client-secret "$CLIENT_SECRET" \
  --redirect-uri "http://localhost:8080/callback"

# OAuth ログイン(ブラウザで「許可」→ localhost:8080/callback に戻る)
xurl auth oauth2 <あなたのハンドル> --app prd-mcp

# 疎通確認
xurl auth status
xurl whoami --app prd-mcp

認証が通れば、素の Claude Code なら登録はこれだけです。

コード
// .mcp.json(接続制限のない環境)
{
  "mcpServers": {
    "x-api": {
      "command": "xurl",
      "args": ["mcp", "https://api.x.com/mcp", "--app", "prd-mcp"]
    }
  }
}

投稿はできない。では、何ができるのか(全24ツール)

繋がったので、全24ツールを実際に叩いて確かめました。カテゴリごとに、機能・必要ティア(目安)・実測(クレジット枯渇時)を並べます。

実測列の記号は次の意味です。

  • ✅:クレジット無しでも動作
  • ❌ 402:クレジット切れ(credits depleted)。クレジットまたは上位プランが必要
  • ❌ 403:認証タイプ不一致
  • ❌ 503:サービス停止中
  • ⚠️:応答は返るが空・要追試

ユーザー情報(5ツール)

ツールできること必要ティア実測
get_users_me認証ユーザー自身のプロフィール取得Free✅
get_users_by_idユーザー ID でプロフィール取得Basic❌ 402
get_users_by_username@handle でプロフィール取得Basic❌ 402
get_users_by_usernames複数 @handle で一括取得Basic❌ 402
search_users名前・プロフィール文で検索Basic❌ 402

Free で唯一通った get_users_me の実際のやりとりはこうです。MCP ツールが内部で叩くのと同じエンドポイントを、xurl で直接叩いた例です。

コード
xurl "/2/users/me?user.fields=created_at,description,public_metrics" --app prd-mcp
コード
{
  "data": {
    "id": "0000000000000000000",
    "name": "(表示名)",
    "username": "akaringo_ai",
    "created_at": "2023-01-25T00:09:05.000Z",
    "description": "(自己紹介)",
    "public_metrics": {
      "followers_count": 0,
      "following_count": 0,
      "tweet_count": 0,
      "listed_count": 0,
      "like_count": 0
    }
  }
}

id とフォロワー数などの数値はマスクしています。user.fields を付けないと id・name・username の3つだけが返ります。

投稿・タイムライン(6ツール)

ツールできること必要ティア実測
get_users_posts指定ユーザーの投稿一覧Basic❌ 402
get_users_timelineフォロー中のホームタイムラインBasic❌ 402
get_users_mentions自分へのメンション一覧Basic❌ 402
get_posts_by_id投稿 ID でツイート取得Basic❌ 402
get_posts_by_ids複数投稿 ID で一括取得Basic❌ 402
get_posts_counts_recent直近7日のツイート数推移Pro❌ 402

「投稿・タイムライン」カテゴリにあるのは、あくまで読み取りのツールです。ここに投稿を作るツールがある、と期待しがちですが、ありません。

エンゲージメント(3ツール)

ツールできること必要ティア実測
get_posts_liking_usersいいねしたユーザー一覧Basic⚠️ 200(0件)
get_posts_reposted_byリポストしたユーザー一覧Basic❌ 402
get_posts_quoted_posts引用した投稿一覧Basic❌ 402

検索・トレンド・ニュース(4ツール)

ツールできること必要ティア実測
search_posts_all全期間のツイート全文検索Pro❌ 403
get_trends_by_woeid地域別トレンドランキングBasic❌ 402
search_newsニュース記事のキーワード検索Basic❌ 402
get_newsニュース記事を ID で取得不明❌ 503

search_posts_all だけは実測が 403 です。他の23ツールと認証タイプが違うためで、後述の「仕様のはまりどころ」で扱います。

ブックマーク(6ツール)

ツールできること必要ティア実測
get_users_bookmarks自分のブックマーク一覧Basic❌ 402
create_users_bookmarkブックマークに追加Basic❌ 402
delete_users_bookmarkブックマーク削除Basic❌ 402
get_users_bookmark_foldersフォルダ一覧取得Free?⚠️ 200(フォルダ0)
create_users_bookmark_folderフォルダ作成Basic(要 Project 登録)❌ enrollment
get_users_bookmarks_by_folder_idフォルダ別ブックマーク取得Basic❌ 402

書き込み系はこのブックマーク周辺だけで、しかも大半が Basic 以上。投稿(ツイート)の書き込みは、24ツールのどこにも入っていません。

料金:読み取りは高い。でも投稿は1件2円ほど

X API は 2026 年 2 月に従量課金(Pay Per Use・クレジット制)が既定になり、無料枠は廃止されました(旧 Basic / Pro のサブスクは新規受付終了、既存も従量へ移行中)。私のアカウントもこれで、クレジットが尽きていたので get_users_me 以外はほぼ 402 credits depleted でした。主な単価はこうです(公式ドキュメント基準・執筆時点)。

操作単価(従量課金)
投稿(通常のテキスト・メディア)$0.015 / 件(約2円)
投稿(リンクを含む)$0.20 / 件(約30円)
投稿の読み取り$0.005 / 件
ユーザー情報の読み取り$0.010 / 件

ここで効いてくる非対称が2つあります。ひとつは、投稿はむしろ激安だということ。1件 $0.015、日本円で2円ほどで、クレジットを数ドル入れれば数百〜数千回投稿できる計算です(今回の 402 は、単に残高がゼロだっただけ)。もうひとつは、リンクを含む投稿だけ $0.20 と13倍に跳ねること。記事の URL を添えて宣伝したい、という使い方はコストが変わるので頭の隅に置いておくとよいです。なお読み取りは月200万件まで、全期間検索(search_posts_all)は Enterprise(月 $42,000〜)が必要。「大量に読む」は高く、「たまに投稿する」はほぼ無料、という構図です。

もうひとつ大事なのは、このクレジットは X Developer Portal 側の財布だということ。同じ「X」でも、Grok(xAI)の API(api.x.ai、課金は console.x.ai)とはまったく別勘定です。Grok 側にいくらクレジットを足しても、xurl(api.x.com)の 402 は 1 円も解消しません。

本命の投稿自動化は、MCP の外にあった

投稿ツールが無い、で諦める必要はありません。xurl はもともと X API を直に叩ける CLI です。MCP のツールとして露出していないだけで、投稿エンドポイントそのものは叩けます。

コード
xurl -X POST /2/tweets -d '{"text":"投稿内容"}' --app prd-mcp

まず Claude Code から叩いてみたら、返ってきたのは成功ではなくこれでした。

コード
{
  "title": "Payment Required",
  "detail": "credits depleted",
  "status": 402,
  "type": "https://api.x.com/2/problems/credits-depleted"
}

ここで一度手が止まります。ただ、大事なのは 403(権限が無い)ではなく 402(クレジット切れ)だったこと。書き込みの経路自体は通っていて、止めているのは権限ではなく残高でした。X API は従量課金なので、クレジットがゼロだと投稿も弾かれます(前章のとおり、これは X Developer Portal 側の財布。Grok の xAI クレジットとは別勘定です)。

そこで X Developer Portal 側にクレジットを数ドル入れて、同じコマンドをもう一度。今度は投稿の data.id が返ってきました。Claude Code の会話から、実際に X へ投稿できたわけです。1件あたり約2円。前章の「投稿はむしろ激安」が、そのまま効いてきます。

試しに、公開済みの別記事の告知を1本流してみました。文面は文体ルールで整えて、投稿は xurl。実際にタイムラインへ出たのがこれです。

Claude Code から xurl で投稿した実際のツイート。記事カード付きでタイムラインに表示されている

MCP の「ツール一覧」には投稿ツールが出てこないので、私は投稿の手順を専用の手順ファイル(スキル)にまとめて、「X へ投稿するときはこのコマンド」を固定化しました。口頭で毎回説明する指示は消えますが、ファイルに書いたルールは会話のたびに読まれるので、「これを X に出しといて」で自然に呼べるようになります。

つまり、やりたかったことは「MCP でやる」と「MCP の外の CLI でやる」に分けると成立しました。閲覧・分析は MCP のツールで、投稿は xurl の直叩きで。公式 MCP に投稿ツールが無い、という一見の行き止まりは、隣の道が開いていただけでした。

仕様のはまりどころ

認証は2種類ある(User Context と App-Only)

X の API には2つの認証タイプがあります。ツールごとにどちらを要求するかが決まっていて、ここを取り違えると 403 になります。

  • User Context(OAuth 2.0 PKCE):「あなた(ユーザー)として」操作する認証。xurl の auth oauth2 で通すのはこちら。全24ツール中23ツールがこの方式です。
  • App-Only(Bearer Token):「アプリとして」読み取る認証。search_posts_all だけがこれを要求します。

先ほど search_posts_all だけ 403 だったのは、xurl が User Context で認証しているのに対し、このツールだけ App-Only を求めるためでした。ティアの問題(402)ではなく、認証タイプの不一致(403)です。同じ「使えない」でも原因がまったく違うので、エラーコードで切り分けます。

エラーコードの読み方

実測で返ってきたエラーは、そのまま切り分けの手がかりになります。

  • 402:credits depleted。ティア不足。上位プランなら使える見込み。
  • 403:認証タイプ不一致。App-Only が必要なツールを User Context で叩いたケース。
  • 503:サービス停止中。エンドポイント未公開か一時障害。
  • client-not-enrolled:OAuth アプリが Developer Portal の Project に紐付いていない状態。create_users_bookmark_folder はこれが返り、書き込み系の一部は Project 登録が別途要るとわかりました。

たとえば Free で get_users_by_username 相当を叩くと、402 はこんな形で返ってきます。

コード
{
  "title": "Payment Required",
  "detail": "credits depleted",
  "status": 402,
  "type": "https://api.x.com/2/problems/credits-depleted"
}

FAQ

Q. 結局、MCP で X に投稿できますか?
いいえ。投稿の作成・削除ツールは現時点の公式 MCP に非搭載です。投稿したいときは、MCP を経由せず xurl で POST /2/tweets を直に叩きます。閲覧・分析・ブックマーク管理までが MCP ツールの範囲です。

Q. 無料(Free)ティアで実質何ができますか?
get_users_me(自分のプロフィール取得)くらいです。他の読み取り系はほぼ Basic 以上で、Free だと 402 が返ります。まず自分のアカウント情報を取るところから、と割り切るのが現実的です。

Q. search_posts_all だけ 403 になります。
このツールだけ App-Only(Bearer Token)認証を要求するためです。xurl の User Context 認証では通りません。ティアではなく認証タイプの問題なので、Pro にしても xurl 経由のままでは 403 のままです。

おわりに

本命の「X への投稿を Claude Code から自動化する」は、公式 MCP のツールとしては叶いませんでした。でも xurl の直叩きで、投稿という行為自体は Claude Code の会話から出せるようになりました。「MCP でやる」と「MCP の外の CLI でやる」を分けて考えたら、やりたかったことの半分は今日から動きます。

残り半分、たとえば「何を・いつ投稿するか」の判断まで委ねる自動化は、また別の設計が要ります。あなたなら、投稿の自動化はどこまで AI に任せますか。


関連記事

許可リストにない stdio の MCP を、supergateway で Claude Code に繋ぐTrellis記事を読むスマホで開く

  • Smart Connections MCP を supergateway 経由で動かした話(近日公開予定)

Trellis のこと

Trellis は、福岡でホームページの制作と、AI による業務の自動化に取り組んでいます。
記事は Zenn と、Trellis のサイトのブログの両方に載せています。

Trellis|福岡市のホームページ制作・AI業務自動化福岡市東区を拠点に、Web制作とAI・業務自動化に取り組んでいます。伝わる機会を増やし、日々の手間を減らして、事業の余白をつくります。福岡市近郊での対面相談、全国からのオンライン相談に対応しています。Trellisページを開くスマホで開く

← 技術ノート一覧へ戻る

Webや業務のこと、
まずはご相談ください。

ホームページ制作・改善から、AI活用や業務効率化まで。今のお悩みや、実現したいことを伺いながら、一緒に整理します。

相談してみる