# 连接 Grok Build {/* #connect-grok-build */}

## 浏览器登录（OAuth） {/* #browser-sign-in-oauth */}

对于自动 OAuth 注册，添加服务器 URL 时不要设置 `oauth` 覆盖项，然后通过 `/mcps` 登录。Grok 会注册自己的回调并处理浏览器返回。

如需使用预先注册的客户端，在 `~/.grok/config.toml` 中添加以下配置：

```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 的授权码流程，并请求 MCP 授权。Grok 还会请求 `offline_access`，以在登录后续期令牌；这是此客户端的可选作用域。账户必须具有平台访问权限。

嵌套 OAuth 设置采用驼峰命名（`clientId`、`callbackPort`）。仅提供服务器 URL 时，支持的客户端会使用自己的确切回调 URI 自动进行动态注册。参阅 [MCP OAuth 设置](/docs/zh/connect-ai-agents#oauth-browser-sign-in)。

## 个人访问令牌 {/* #personal-access-token */}

浏览器登录不可用时，请使用此替代方式。不要在上述 OAuth 条目中添加 Authorization 请求头。

从 [Reconstruct 平台账户设置](https://reconstruct.dev/platform/)复制 MCP 访问令牌。连接要求请参阅[个人访问令牌](/docs/zh/connect-ai-agents#personal-access-token)。在启动 Grok Build 的环境中设置 `CR_RECONSTRUCT_MCP_TOKEN`。

在用户文件 `~/.grok/config.toml` 中添加以下内容。如果文件已有其他 MCP 服务器，请保留其条目，仅添加 `reconstruct` 部分：

```toml
[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` 刷新。

检查注册状态和连接：

```sh
grok mcp doctor reconstruct
```

请 Grok Build 使用 `reconstruct` 工具调用 `list_products`，确认访问权限。

## 技能说明 {/* #skill-instructions */}

MCP 资源和 MCP 工具是不同能力。某些 Grok Build 版本通过 `search_tool` 和 `use_tool` 向代理提供采集工具，但不提供 `resources/read`。将 `resources/list` 作为工具调用不会加载技能。

如果客户端无法使用资源，请 Grok 调用 `list_skills`，再使用目录资源 URI（`skill://reconstruct/` 加返回的路径）调用 `get_skill`。这样可以通过普通 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 技能](/docs/zh/skills)。

重建时，如果已连接的服务器声明支持 `get_interface_scene`，当前工作流程优先使用它。它为平台适配器导出相同的中立场景契约，包含测量、声明、推断事实，并明确指出缺失的证据。DOM/CSS 是可选的 Web 诊断信息。通过 `get_skill` 加载已发布的 Build 参考资料；导出成功不等于已验证桌面、移动端、交互或动画的还原度。旧服务器使用其声明的旧版证据工具，并必须说明由此产生的缺口。

参阅官方 [Grok Build MCP 指南](https://docs.x.ai/build/features/mcp-servers)。接下来，试试[提示词示例](/docs/zh/prompt-examples)。