メインコンテンツまでスキップ

Grok Build を接続する

ブラウザーでサインインする（OAuth）​

自動 OAuth 登録では、oauth の上書き設定を指定せずにサーバー URL を追加し、/mcps からサインインします。Grok がコールバックを登録し、ブラウザーからの復帰を処理します。

事前登録済みクライアントを使う場合は、~/.grok/config.toml に次の設定を追加します。

[mcp_servers.reconstruct]
url = "https://reconstruct.dev/mcp"
oauth = { clientId = "reconstruct-mcp", scopes = ["openid", "aud-mcp", "offline_access"], callbackPort = 58234 }

Grok Build で /mcps を開き、r で設定を再読み込みし、reconstruct を選択して i でサインインします。コールバックは http://127.0.0.1:58234/callback です。ポート 58234 を使用可能にしておいてください。クライアントシークレットは不要です。Grok はローカルのコールバックリスナーを起動し、ブラウザーでのサインイン後に接続を自動完了します。このパブリッククライアントは PKCE S256 を使用した Authorization Code フローを使い、MCP への同意を求めます。Grok はサインイン後のトークン更新に offline_access も要求します。これはこのクライアントの任意スコープです。Platform にアクセスできるアカウントが必要です。

ネストした OAuth 設定は camelCase（clientId、callbackPort）を使います。サーバー URL だけの場合、対応するクライアントは自身の正確なコールバック URI で動的な自動登録を行います。MCP OAuth の設定を参照してください。

個人アクセストークン​

ブラウザーでサインインできない場合は、こちらを使用します。上記の OAuth エントリーに Authorization ヘッダーを追加しないでください。

Reconstruct Platform のアカウント設定から MCP アクセストークンをコピーします。接続要件は個人アクセストークンを参照してください。Grok Build を起動する環境で CR_RECONSTRUCT_MCP_TOKEN を設定します。

ユーザーの ~/.grok/config.toml に次を追加します。既にほかの MCP サーバーがある場合は、そのエントリーを残し、reconstruct セクションだけを追加します。

[mcp_servers.reconstruct]
url = "https://reconstruct.dev/mcp"
headers = { "Authorization" = "Bearer ${CR_RECONSTRUCT_MCP_TOKEN}" }

Grok Build は設定の読み込み時に、環境変数の ${CR_RECONSTRUCT_MCP_TOKEN} を展開します。トークンをプロジェクトファイルに直接記述しないでください。

grok で Grok Build を起動します。既に起動している場合は、設定の編集後に /mcps を開き、r で更新します。

登録と接続を確認します。

grok mcp doctor reconstruct

Grok Build に reconstruct のツールで list_products を呼び出すよう依頼し、アクセスを確認します。

スキルの指示​

MCP リソースと MCP ツールは別の機能です。一部の Grok Build は、resources/read を公開せず、search_tool と use_tool 経由でキャプチャーツールをエージェントに公開します。resources/list をツールとして呼び出してもスキルは読み込めません。

クライアントでリソースを利用できない場合は、Grok に list_skills、続いて get_skill をカタログのリソース URI（skill://reconstruct/ に返されたパスを続けたもの）で呼び出すよう依頼します。通常の MCP ツールで同じ同梱の指示を取得でき、別途インストールする必要はありません。補助テンプレートも get_skill で読み取れます。

これらのスキル用ツールに対応しない古いサーバーでは、作業前にスキルを別途インストールするか、公開ウェブサイトの指示を読んでください。再構築では、https://reconstruct.dev/.well-known/agent-skills/<skill-name>/SKILL.md の reconstruct-inspect、reconstruct-build、reconstruct-verify を使用します。公開検出カタログは https://reconstruct.dev/.well-known/agent-skills/index.json です。キャプチャーデータは引き続き認証済みの MCP 接続から取得します。インストール方法は Reconstruct スキルを参照してください。

再構築では、接続先サーバーが公開している場合、現在のワークフローは get_interface_scene を優先します。プラットフォームアダプター向けに同じ中立なシーン契約を出力し、測定／宣言／推定の区別と不足している根拠を明示します。DOM/CSS は任意の Web 診断です。公開されている Build リファレンスは get_skill で読み込んでください。出力の成功を、デスクトップ、モバイル、操作、アニメーションの再現性が検証済みであることと同一視しないでください。古いサーバーでは公開された従来の根拠ツールを使用し、そのために残る不足を開示する必要があります。

公式の Grok Build MCP ガイドを参照してください。続いてプロンプトの例を試してください。