跳到主要内容

连接 Grok Build

浏览器登录（OAuth）​

对于自动 OAuth 注册，添加服务器 URL 时不要设置 oauth 覆盖项，然后通过 /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 的授权码流程，并请求 MCP 授权。Grok 还会请求 offline_access，以在登录后续期令牌；这是此客户端的可选作用域。账户必须具有平台访问权限。

嵌套 OAuth 设置采用驼峰命名（clientId、callbackPort）。仅提供服务器 URL 时，支持的客户端会使用自己的确切回调 URI 自动进行动态注册。参阅 MCP OAuth 设置。

个人访问令牌​

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

从 Reconstruct 平台账户设置复制 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 版本通过 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 技能。

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

参阅官方 Grok Build MCP 指南。接下来，试试提示词示例。