この記事は、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リファレンスもあわせて確認してください。



