店舗ビジネスの成長をAIで加速

Claude CodeとGrok Botの連携手順|BDKでMCP登録する方法と実務での使い方【2026年版】

この記事は、Claude Code から Grok Bot を呼び出して連携させる手順です。「Grok Bot が内部で Claude のモデルを使う」という話とは別のものです。

手順は、Cursor の BDK(Bot Development Kit、npm パッケージ @cursor/bdk)の 0.2.27 で動作確認した手順です。2026年11月19日時点の npm の最新版は 0.6.0 ですが、0.6.0 で同じ手順が動くかは確かめていません。0.6.0 で変わった点は、わかった範囲を後半の「0.6.0 で変わった点」にまとめています。

きっかけ

X で「Claude Code に Cursor 公式プラグインを一発で入れて、Grok Bot と Cursor を連携」という投稿を見かけました。普段 Claude Code と Grok Bot の両方を使っているので、つながるなら便利です。そこで、実際にどうすれば入るのかを調べました。

公式プラグインを探した結果

結論から言うと、2026年10月の調査では、Cursor 公式の「Claude Code 用の Grok Bot 連携プラグイン」は見つかりませんでした。

  • Cursor 公式ドキュメントを全ページ検索しました。Claude Code に関係する記述は、Claude Code の書式(CLAUDE.md、hooks、プラグイン)を Cursor 側が取り込むという話だけでした。
  • 公式リポジトリ cursor/plugins には Claude Code 用のマーケットプレイス定義があります。ただ、調査時点で入っていたのは origin-apps(Cursor Origin API 用のスキル)の1つだけでした。
  • Origin MCP については、調査時点(2026年10月)の公式の説明では「現在は Cursor と Grok Bot 専用」とされていました。その後の対応状況は確認できていません。

少なくとも調査した時点では、「一発で入る公式プラグイン」で Claude Code から Grok Bot を呼ぶ道は確認できませんでした。

実際につながった経路:BDK を中継にする(0.2.27 で動作確認した手順)

代わりに使えたのが、Cursor の BDK です。記事を最初に書いた2026年10月16日は v0.2.25 で試しました。その後 0.2.27 に上げ、今は手元の Mac で bdk serve(0.2.27)を中継として動かして、Claude Code から Grok Bot に依頼を送っています。Node は 22.13 以上が必要です。

流れとしては、手元の Mac で BDK をローカルサーバーとして立て、その MCP エンドポイントを Claude Code に登録します。

1. インストール(0.2.27 を指定)

npm install -g @cursor/bdk@0.2.27

版を付けずに入れると、2026年11月19日時点では 0.6.0 が入ります。0.6.0 ではこの記事の手順を確かめていないので、同じ手順で進めるなら版を指定してください。

2. ログイン

bdk login

ブラウザが開くので、Cursor アカウントでサインインします。

3. プロジェクト作成

bdk init ./grokbot --template grokbot-agents --var "agents=<Bot名>"

<Bot名> には呼びたい Grok Bot の名前を入れます。

4. ローカルで起動

bdk serve --mode single --host 127.0.0.1 --port <ポート>

127.0.0.1 を指定しているので、自分の Mac の中からしか接続できません。

5. Claude Code に MCP として登録

claude mcp add --transport http --scope local grokbot http://127.0.0.1:<ポート>/v1/mcp

これで、Claude Code から Grok Bot に質問を送って返答を受け取れました。2026年10月の最初の接続テスト(v0.2.25)では、往復は約7秒で、返答は「接続OK、AI KURAZONOです。」でした。claude mcp add の書き方は、Claude Code の公式ドキュメント(MCP を使用して Claude Code をツールに接続する)にあります。

ハマりどころ:呼び出す場所で挙動が変わる

いちばん時間を取られたのはここです。

  • /v1/mcp/tools で grokbot__ask を直接呼ぶと、Missing AgentSDK session binding. で失敗します。
  • /v1/mcp の call_tool を使って toolName=grokbot__ask を指定すると、間に AI のターンを挟まずに Grok Bot へ直接届きます。
  • /v1/mcp の ask ツールを使った場合は、中継エージェントのモデルのターンが1回走ってから届きます。

決まった文面をそのまま届けたいなら、call_tool 経由がよさそうです。

実務での使い方:自社サイトのSEO分析を Claude Code と Grok Bot で分担する

ライフフェスタでは、この BDK の経路(Mac 上の bdk serve 0.2.27 → Grok Bot)を、自社サイト lifefesta.jp のSEO分析に使っています。Claude Code が依頼を書き、Grok Bot がデータを集めてレポートを返し、Claude Code が数字を確かめる、という分担です。ここに出す数字は、すべて lifefesta.jp 自身のものです。

役割の分け方

  • Claude Code:見る数字・期間・返す形を決めた依頼文を書く。返ってきた数字を、自分で取った値と突き合わせる。
  • Grok Bot:Search Console と GA4 から数字を取り、WordPress の投稿一覧と合わせて集計し、決めた形でレポートを返す。

2026年11月19日の例

  • 依頼した分析は3件です。公開記事のテーマごとの偏り、順位やクリック率が低い検索語の洗い出し、社名での検索の推移です。
  • 返す形は「1行目は BEGIN、最後の行は END」と決めました。受け取った側が、途中で切れていないかを確かめやすくするためです。推測は「仮説」、資料にない数字は「記載なし」と書き分け、取れなかった数字を0にしないことも依頼文に入れました。
  • Grok Bot が使ったデータは次のとおりです。
    • Search Console のエクスポート4種(28日、90日、社名を含む検索語の90日を2種)
    • GA4 のトラフィック獲得レポート
    • WordPress の REST API で取った公開記事の一覧(53本)
  • 結果の一部です。
    • 28日(10/19〜11/15)のクリック202のうち、106(52.5%)がこの記事でした。
    • 90日(8/18〜11/15)のクリックは352でした。
    • GA4 で AI アシスタント(ChatGPT・Gemini)から来た訪問は、28日で8セッションでした。
  • 検算:Claude Code 側で取った値と、202/352クリック、106クリック、AI アシスタント経由の8セッションが一致しました。

分担してみてわかったこと

  • 返す形を先に決めておくと、受け取った文章をそのまま次の作業に回せます。
  • 集計した側とは別の側が検算するので、数字の取り違えに気づきやすくなります。
  • 送る内容には、顧客の情報を入れていません。扱うのは自社サイトの数字だけです。

Search Console と GA4 の数字を取ってから表に残すまでの流れは、マーケティングレポートの自動化で手順にしています。

0.6.0 で変わった点(2026年11月19日に公式ドキュメントで確認)

ここは、公式ドキュメントと npm の公開情報を読んだだけの内容です。0.6.0 を入れて試してはいません。

  • npm の @cursor/bdk の最新は 0.6.0 です(2026年11月4日公開)。0.2.27 のあと、0.2.28・0.2.29・0.3.0・0.4.0・0.5.0 を経ています。必要な Node の版(22.13以上)は変わっていません。
  • ドキュメントの名前は「Agent SDK」になり、場所は cursor.com/docs/agent-sdk に移りました。ドキュメントでは、パッケージは @grok/agent-sdk で、以前は @cursor/bdk だったと説明されています。
  • コマンドの名前は agent-sdk です。CLIリファレンスには「bdk コマンドも引き続き使える」と書かれています。
  • 今のCLIリファレンスの init --template の選択肢には、この記事の手順3で使った grokbot-agents が載っていません。0.6.0 で手順3がそのまま動くかは未確認です。
  • 今のCLIリファレンスには、MCP クライアントをつなぐ mcp serve・mcp install というコマンドが載っています。Claude Code との連携にこれを使えるかは、0.6.0 では未確認です。

0.6.0 で手順を試したら、この記事を更新します。

注意点

  • Bot 名は許可リストとして扱われます。 打ち間違えると、その名前で空の Bot が新しく作られます(0.2 系で確認)。
  • 送った内容は Cursor 側に渡ります。 顧客情報などは送らないようにしています。
  • 版によって手順が変わります。 この記事の手順は 0.2.27 で確かめたものです。0.6.0 では未確認です。
  • xAI の Grok Build CLI(grok コマンド)は、Grok Bot とは別物です。 名前が似ているので混同しやすいです。

まとめ

「一発で入る公式プラグイン」は、2026年10月の調査では見つかりませんでした。それでも、BDK を中継にすれば、公式の部品だけで Claude Code から Grok Bot まではつながりました。ライフフェスタでは、この経路(bdk serve 0.2.27)で、自社サイトのSEO分析の依頼と検算を Claude Code と Grok Bot で分担しています。最新の 0.6.0 では名前やコマンドが変わっているため、0.6.0 で試すときは公式のCLIリファレンスもあわせて確認してください。

LF

Lifefesta 編集部

店舗ビジネスの成長をAIで加速するクリエイティブカンパニー、Lifefestaの編集部です。

Contact

まずは無料でご相談ください

店舗集客・AI活用・デジタルマーケティングのお悩みを、
経験豊富なチームが一緒に解決します。

無料相談はこちら
無料の集客診断を受ける