Grokから外のサービスにつなぐ（その3）：Grok Bot、Grok Build、docsのMCPサーバーを、入手・設定・承認・渡るデータ・外し方まで公式の記述の範囲で

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はGrokを入れていますが、使い心地はこの記事には書いていません。手順は、公式の手順を順に並べたものです。例の指示文は「この記事の例」で、公式の例ではありません。公式のページは要約の形で取得しているため、権限の名前、コードと設定の例は、記号や改行が崩れていないか、必ず公式ページの原文と照らしてください。インストールのコマンドは、インターネット上のスクリプトを実行する形なので、実行する前に原文を見て写し、中身を確かめてください。

先に結論

• Grok Botは別の製品。 1つの共有コンピューターで動き、すべてのBotから同じファイルとログインが見える、と公式が書いています。
• Grok Buildは、他のツールの設定を読む向きが書かれている。 Claude Codeの指示ファイル、スキル、MCPの設定を読む、と公式の複数のページが書いています。Claude Code側がGrokを読む手順は、読んだページにありません。
• docsのMCPサーバーは、公開のドキュメントを引くためのもの。 渡るのは、検索語とページの名前です。
• MCPや外のサービスをつなぐと、外から文章が入る。 防御の考え方は、第8本のcookbookの節にあります。

前提：用語をそろえる

• Grok Bot。 名前を付けたAIの「Bot」が、クラウド上のコンピューターで作業する、別の製品です。
• MCP。 AIと外のサービスをつなぐ共通の決まり。
• Grok Build。 ターミナルで動くコーディングエージェント。
• TUI、ヘッドレス、ACP。 TUIは文字の全画面の操作画面、ヘッドレスは画面なしで1回だけ実行する形、ACP（Agent Client Protocol）は他のアプリがGrok Buildを動かすための決まりです。
• 環境変数 XAI_API_KEY、APIキー。 第8本で説明しています。

組み合わせの地図（公式に記述があるものだけ）

Grok Bot をつなぐ（grok.comとは別の製品）

入手とサインイン（docs.x.ai/grok-bot/get-started）

1. 資格：個人の有料のCursorのプラン、Cursor Teams、Cursorのアカウントに連携した個人のSuperGrok、SuperGrok Plus、SuperGrok Heavy、またはセルフサーブのGrok Businessの席のいずれか、と書かれています。
2. デスクトップアプリを x.ai/bot から入れます。macOSは、Apple siliconかIntelを選び、アプリケーションにドラッグして開きます。Windowsは、x64かArm64を選び、インストーラーを実行します。Linuxは、x64かArm64と、.deb、.rpm、AppImageを選びます。更新は自動で、「Settings → Updates → Check for Updates」でも確認できます。モバイルにも対応、と書かれています。
3. ウェルカム画面で「Sign in」を押し、ブラウザで完了します。SuperGrokを使う場合は、促されたときに連携します。モバイルは「Link Grok Account」、そのあと「Finished Linking? Refresh My Status」。デスクトップは「Settings → Usage & Billing → Get Access with Grok」です。
4. 初回に、紹介を終えると、バックグラウンドでセットアップが走り、「Grok Bot」という名前のBotができます。
5. 条件：データの保存が必要で、Legacy Privacy Modeのアカウントは、対応するCursorのデータ設定に切り替える必要があります。

最初のBotと、最初の依頼

• 最初のメッセージで、Botに1つの主な仕事を与えます。公式は、依頼に、成果物、情報源、制約、納品物、確認の時点を含める、と書いています。
• Botの名前の変更：チャット上部のBotの名前をクリック。Botを足す：「New → Create new Bot」。チームのBot：コマンドパレットの「Create new Team Bot」。
• 入力は、文字か音声（デスクトップは Cmd/Ctrl+D で音声入力、モバイルは「Start dictation」、会話は「Start voice chat」）。

この記事の例（公式の「出力、情報源、制約」の要素に合わせた組み立て）：

添付の売上表を読んで、月ごとの合計を表にしてください。表のファイルは新しく作り、元のファイルは変更しないでください。作業が終わったら、結果を見せて、私が確認するまで、ほかの操作はしないでください。

アプリ（プラグイン）をつなぐ

1. サイドバーの「Connect apps」を開く、またはチャットの中の「Connect」のカードを選びます。
2. アプリを探すか、検索します。
3. 「Add」を選びます。
4. 求められたら、ブラウザでサービスのログインを済ませます。

5. チャットで、@ でアプリを依頼に添付し、/ で保存済みのスキルを呼びます。

6. 接続したアプリは、アカウント全体で、すべてのBotから使えます。

7. OAuthのトークンは、Cursorのコネクタのバックエンドが持ち、Botはトークンを受け取らずにツールを呼ぶ、と書かれています。
8. パスワード、パスキー、2段階認証のコードが要る場面は、自分で「Take over」して入力し、「I'm done」を押してから、Botに続けるよう伝えます。「I'm done」の表記は approvals のページにあり、computer-and-apps のページは「Botは認証情報を入力せず、パスワードも見ない」と書いています（「Take over」と「Take control」の表記が、ページによって違います）。
9. チームの方針でブロックされたアプリは、「Disabled by team admin」と出ます。
10. このページにMCPの記述は見つからず、アプリの外し方も書かれていません（サイドバーの「Connect apps」か、Cursorのヘルプを見る、と案内されています）。

Xから呼び出す（@bot。docs.x.ai/grok-bot/tag-on-x）

条件（公式）：Xのアカウントを連携したGrokのアカウント、同じGrokのアカウントでのGrok Botの利用資格、自分のBotが1つ以上（共有されたBotは、タグ付きの依頼を受けられない）、タグ付けが使える地域に基づくXのアカウント。

1. grok.comで、「Settings → Account」を開き、Xのアカウントの欄の「Connect」を選びます。
2. Grok Botの利用資格を整えます。
3. 自分のBotを作ります。
4. Xで、投稿か返信に @bot と、依頼を書きます。

5. @botの返信を確認し、Grok Botのアプリで、作業の進み具合と結果を見ます。

6. 作業と結果は、Grok Botのアプリの中のBotの会話に残り、Xには短い確認の返信だけが付く、と書かれています。

7. 初回、タグ付きの依頼が自動で作業を始め、Grok Botの使用量を使うことが、Xから通知されます。
8. 取り込まれる内容：自分の投稿、返信先の投稿、それらが引用する投稿（静止画を含む）。任意の「X for Grok Bot」プラグインを入れると、投稿の検索、タイムラインの読み取り、メンションの確認、トレンドとブックマークが使えます。
9. 返信が来ない理由（公式）：地域が対象外、すでに@botを含むスレッドで自分ではタグ付けしていない、投稿が@grokもタグ付けしている、投稿・返信先・引用の投稿に動画かGIFがある、内部のモデレーションを通らない、Grok Botが連携されていないか週の使用量を使い切った。
10. 地域：オーストラリア、イギリス、EU、アイスランド、リヒテンシュタイン、ノルウェーのXアカウントは、まだ対象外、と書かれています。Xが記録している国で決まり、居場所やVPNは関係しない、とあります。日本は、読んだページに対象外としては挙がっていませんが、対象と明記もされていません。公式で確認できていない点です。

承認と取り消し（docs.x.ai/grok-bot/approvals-security-and-privacy）

• 承認。 提案された操作のカードで、対象、範囲、値を確かめてから、「Allow once」「Always allow」「Deny」を選びます。承認は、提案された操作だけに効きます。
• Auto Review。 「Settings → General → Auto-review」で設定します。「Ask first」のルールは常に止め、「Allow automatically」のルールは、自動のレビューが止める理由を見つけなければ進める、両方に当てはまると「Ask first」が勝つ、とあります。モデルによる判断なので、最小の権限と明示的な承認の代わりにはならない、とも書かれています。
• 時間切れ。 バックグラウンドの作業の承認は、約10分で「Expired」になり、操作は実行されません。
• Botの保持と削除（資料同士の併記）。 Xのヘルプ（About Grok）は、Botのデータは削除しない限りBotのアカウントがある間は保持される、Botの削除はGrok Botの設定で行う、学習への利用はプライバシー設定で止められる、と書いています。approvalsのページは「Backend retention and account deletion follow the applicable Cursor terms」と書き、保持の期間は書いていません。どちらかに決めつけず、両方を読んでください。
• 自分のコンピューターでの実行。 「Settings → Computer → Your computer」の「Execution on this computer」で、「Ask every time」（既定）、「Always allow」、「Never allow」を選びます。
• 共有のコンピューター。 1つのコンピューターがユーザーのアカウントに割り当てられ、すべてのBotが、そのファイル、ブラウザのセッション、コマンドラインの認証情報に触れます。別々のBotは、セキュリティの境界ではない、と書かれています。
• 取り消しと削除の手順（公式）： ①関連するルーチンを止めるか削除する、②共有コンピューターのサイトからサインアウトする、③コネクタをアンインストールして、元のサービスで許可を取り消す、④機微なファイルを /workspace から消す、⑤Botを隠すか削除する、⑥必要ならアカウント設定からCursorのアカウントを削除する。Botを削除しても、共有コンピューターのファイルとブラウザのセッションは消えない、とあります。

連携H：Grok Build（ターミナルのコーディングエージェント）

入手とサインイン（docs.x.ai/build/overview、公式のコマンド）

curl -fsSL https://x.ai/cli/install.sh | bash

irm https://x.ai/cli/install.ps1 | iex

• 上は、macOS・Linux用、下はWindowsのPowerShell用として、公式が載せています。どちらも、ネット上のスクリプトを取り込んで実行する形です。実行する前に、原文のコマンドを確かめてください。
• プロジェクトのフォルダで grok を実行します。初回は、ブラウザが開いて認証します。ブラウザがない環境では、APIキーを使う、と書かれています。

export XAI_API_KEY="xai-..."
grok

• grok login（--device-auth は、画面のない環境や遠隔でのデバイスコードの認証）、grok logout（保存した認証情報を消す）があります（CLI Reference）。
• 必要なプランや料金は、docs overviewに書かれていません。x.ai/buildは「Available to try for Free」と書き、「Try now」のリンクはSuperGrokのページに向いています。何がどこまで無料かは、読んだページからは分かりません。

使い方の入口

• プロンプトの中で @path/to/file と書くと、ファイルを参照します。
• スクリプトやCIでは、--no-auto-update で更新の確認を止められます（Headless & Scripting）。
• ヘッドレスのセッションは、--session-id、--resume、--continue を付けると ~/.grok/sessions に保存されます。

許可（permissions）

公式のPermissionsのページが書くことです。

• 既定は「Ask」で、許可されていない操作は確認します。「Auto」は、危険でないと分類器が判断したツールを自動で許可します。「Always-approve」は、確認を省きます。Shift+Tab で切り替わります。
• 「Always-approve」でも、deny のルールとフックは効きます。
• ルールの例（公式のページから）：

[permission]
rules = [
  { action = "allow", tool = "bash", pattern = "git *" },
  { action = "allow", tool = "read" },
  { action = "deny",  tool = "bash", pattern = "rm -rf *" },
]

• deny は常に allow に勝ちます。ツールの種類に MCPTool が挙がっています。
• 公式ページ同士の違い：Permissionsのページは、ask というルールの種類は定義していない、と読める書き方です。Settings Referenceのページは、allow、deny、ask を使い、評価の順は「deny、ask、allow」と書いています。設定を書く前に、両方のページの原文を見てください。

MCPサーバーをつなぐ（docs.x.ai/build/features/mcp-servers）

公式のコマンドです。

# ローカルのstdioサーバー（-- のあとがサーバーのコマンド）
grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# リモートのHTTPサーバー（OAuthは自動で処理される）
grok mcp add --transport http linear https://mcp.linear.app/mcp

# 静的な認証ヘッダー付き（--header は繰り返せる）
grok mcp add --transport http api https://mcp.example.com/mcp --header "Authorization: Bearer ${API_TOKEN}"

• 確認：grok mcp list、削除：grok mcp remove <name>、診断：grok mcp doctor [name]（list と doctor は --json が使えます）。
• 設定ファイル ~/.grok/config.toml では、[mcp_servers.<name>] に書きます。stdioは command、args、env。リモートは url、headers。${VAR} は読み込み時に展開されるので、秘密の値を環境変数に置けます。起動の待ち時間 startup_timeout_sec（既定30）、ツールの待ち時間 tool_timeout_sec（既定6000）もあります。公式のページの例は、filesystem と linear の2つのブロックです（全文は公式ページで確認）。
• OAuthのサーバーは、初回にブラウザの認証が走り、トークンは ~/.grok/mcp_credentials.json に保存される、と書かれています。
• 範囲：ユーザーの ~/.grok/config.toml に直接書くこともできます（既定の範囲を明記した文は、読んだページに見つかりませんでした。--scope project の説明から、ユーザーの設定が既定と読めます）。--scope project を付けると、いまのフォルダの .grok/config.toml に書きます。同じ名前なら、プロジェクト側がユーザー側を置き換えます。
• TUIの /mcps で、MCPのタブが開き、Space（切り替え）、r（再読み込み）、i（OAuth認証）、a（追加）、x（削除）が使えます。
• ツールは <server>__<tool> の名前で出ます。
• うまくいかないとき：grok mcp doctor、stdioの標準エラーは ~/.grok/logs/mcp/<server>.stderr.log、npx の初回起動が遅いときは startup_timeout_sec を上げる、と書かれています。
• 承認の扱い（MCPのツールを使うときの確認）は、このMCPのページには書かれておらず、Permissionsのページに MCPTool の項目があるだけです。

Claude Codeなど、ほかのツールの設定を読む

公式の複数のページが書くことを並べます。

• 指示ファイル。 Grok Buildは、AGENTS.md、Agents.md、AGENT.md、CLAUDE.md、Claude.md、CLAUDE.local.md、.grok/rules/ の *.md を読みます。.claude/rules/ と .cursor/rules/ も互換のために読みます。.gitignore で除外されたファイルは飛ばします。このAGENTS.mdのページに「変換は要らない」という文言は確認できていません（skills-pluginsのページは、Claude Codeの設定を読むのに「No extra setup is needed」と書いています）。読んだファイルは、grok inspect で、パスとおおよそのトークン数を確認できます。
• スキル、プラグイン、MCP、エージェント、フック。 Claude Codeのマーケットプレイス、プラグイン、スキル、MCP、エージェント、フック、指示ファイルを、.grok/ と並べて読む、設定は要らない、とskills-pluginsのページにあります。
• MCPの設定ファイル。 ~/.claude.json、.cursor/mcp.json、プロジェクトの .mcp.json も読みます。順位は config.toml より下です。止めるには、[compat.claude] mcps = false か [compat.cursor] mcps = false です。grok inspect で、読み込んだサーバーと出どころが見えます。
• 取り込みの切り替え。 Settings Referenceのページは、[compat.claude] と [compat.cursor] の skills、rules、agents、mcps、hooks が既定で true で、ユーザーの設定に書く（プロジェクトの .grok/config.toml には書かない）と書いています。ページのTOMLの例は、取得した要約の側で組まれたもので、公式の写しではないため、この記事では載せません。キー名だけ書きます。
• セッションの取り込み。 grok import [targets...] は、Claude Codeのセッションを取り込みます（CLI Reference）。TUIの /import-claude は、Claudeの設定の取り込みの画面を開きます。
• 別名の引数。 --allowedTools、--disallowedTools、--append-system-prompt、--system-prompt、--dangerously-skip-permissions が、Claude Code互換の別名として挙げられています。

これは、公式が書く「Grok Buildが他のツールの設定を読む」向きです。Claude Code側がGrokを読む手順は、読んだページにありません。

他社のモデルを追加する（公式のoverviewの例）

~/.grok/config.toml（Windowsは %USERPROFILE%\.grok\config.toml）に、次の形で書く、と書かれています。

[model.my-model]
model = "model-id"
base_url = "https://api.example.com/v1"
name = "Display Name"
env_key = "API_KEY"

[models]
default = "my-model"

• 使い方：grok -p "Hello" -m my-model。TUIでは /model <name>。
• Settings Referenceのページには、鍵を env_key（環境変数の名前）で渡す形と、api_key を直接書く形の両方が出てきます。この記事の案として、鍵は環境変数に置きます。
• 別の提供元のモデルのつなぎ方（どのAPIの形式が使えるか）は、読んだページで一部しか確認できていません。

そのほか（公式が書くが、この記事では手順まで読んでいないもの）

• フック、スキルの作り方、サンドボックス、サブエージェント、ワークツリー、エンタープライズの設定。grok inspect と /hooks、/skills、/plugins、/marketplace、/mcps が、拡張の入口です。
• TUIのコマンド：/plan、/goal、/loop、/usage、/privacy など。一覧は、docsの「Modes and Commands」にあります。

連携I：docsのMCPサーバーを、他のAIツールに渡す

docs.x.aiは、docsそのものを、MCPサーバーとして公開しています（docs.x.ai/developers/docs-mcp）。

• エンドポイント：https://docs.x.ai/api/mcp
• 方式：Streamable HTTP（状態を持たない）
• ツール：list_doc_pages（ページの一覧）、get_doc_page（slug でページを取る。例 developers/quickstart）、search_docs（query と、任意の max_results）。完全な一覧は書かれていません。

Grok Build

grok mcp add --transport http xai-docs https://docs.x.ai/api/mcp

または、~/.grok/config.toml に次を書きます。

[mcp_servers.xai-docs]
url = "https://docs.x.ai/api/mcp"

確認は、grok mcp doctor xai-docs。

Cursor、Zed、Windsurf、OpenCode

• Cursor：「Settings → MCP」で、種類を url（Streamable HTTP）、URLを https://docs.x.ai/api/mcp にして追加します。
• Windsurf：「Settings → MCP」で、同じURLの新しいサーバーを追加します。
• Zed：agent: open settings から「Model Context Protocol (MCP) Servers」を開き、"xai-docs": { "url": "https://docs.x.ai/api/mcp" } の形で追加します。
• OpenCode：設定の mcp の下に、"type": "remote"、"url": "https://docs.x.ai/api/mcp"、"enabled": true を書きます。
• そのほかのStreamable HTTPのクライアントは、エンドポイントのURLに向けます。

公式のページには、Claude CodeやClaude Desktopへの設定の手順は書かれていません。それらのツール側のMCPの追加の手順は、各ツールの公式の資料を見てください（この記事では読んでいません）。

渡るデータは、ドキュメントの検索語と、ページのスラッグです。ドキュメントは公開ページです。

渡るデータ・外し方の早見表

うまくいかないときの確認点

気をつけること

• この記事は、使って確かめた記録ではありません。 運営者はGrokを入れていますが、使い心地はこの記事には書いていません。コードと設定は、実行前に公式ページの原文と照らしてください。
• 要約を経由した取得。 コードの記号や改行が崩れている可能性があります。この記事では、崩れが疑われるものは、全文を載せず、要点だけを書きました。Settings ReferenceのTOMLの例は、取得の側が組んだものだったので、載せていません。
• Grok Botは共有コンピューターで動く。 別々のBotは、セキュリティの境界ではない、と公式が書いています。取り消しの手順は、「承認と取り消し」の節の6つです。
• Cursorの規約。 Grok Botの利用は、Cursorのプライバシーポリシーにも従う、とXのヘルプに書かれています。
• 日本での@botの対応。 対象外の地域に日本は挙がっていませんが、対象と明記もされていません。公式で確認できていない点です。
• MCPは、外から文章を持ち込む道。 公式のcookbookが挙げる4つの考え方（データとして扱う、道具を絞る、実行前に確かめる、人が確認する）を、第8本で読んでください。
• 公式の資料同士の違い。 許可のルール（ask の扱い）、env_key の書き方などは、ページによって書き方が違います。
• 読んでいないページ。 Grok Buildのフック、サンドボックス、サブエージェント、エンタープライズ、ACPの詳細な設定、Grok Botのチーム・企業向けのページは読んでいません。
• 評価はしていません。 どの連携がよいかの順位づけは、この記事では書いていません。
• 僕らの見立て（事実ではありません）。 Grok BotやGrok Buildに外のサービスを足すときは、足す前に「承認」と「取り消し」の節を先に読み、元のサービスの許可の画面で外せることを確かめておくと、あとで困りにくいと思います。

出典

• Grok Bot: Get Started（docs.x.ai、確認日 2026-10-25）
• Tag @bot on X（docs.x.ai、確認日 2026-10-25）
• Grok Bot: Use the computer and apps（docs.x.ai、確認日 2026-10-25）
• Grok Bot: Approvals, security, and privacy（docs.x.ai、確認日 2026-10-25）
• About Grok（X Help Center、確認日 2026-10-25）
• Grok Build overview（docs.x.ai、確認日 2026-10-25）
• Grok Build: Modes and Commands（docs.x.ai、確認日 2026-10-25）
• Grok Build: Headless & Scripting（docs.x.ai、確認日 2026-10-25）
• Grok Build: CLI Reference（docs.x.ai、確認日 2026-10-25）
• Grok Build: MCP Servers（docs.x.ai、確認日 2026-10-25）
• Grok Build: Skills, Plugins & Marketplaces（docs.x.ai、確認日 2026-10-25）
• Grok Build: AGENTS.md（docs.x.ai、確認日 2026-10-25）
• Grok Build: Permissions（docs.x.ai、確認日 2026-10-25）
• Grok Build: Settings Reference（docs.x.ai、確認日 2026-10-25）
• Docs MCP（docs.x.ai、確認日 2026-10-25）
• Grok Build（x.ai、確認日 2026-10-25）