Saltar al contenido principal

Conectar Grok Build

Inicio de sesión en el navegador (OAuth)​

Para el registro OAuth automático, añade la URL del servidor sin sobrescribir oauth e inicia sesión mediante /mcps. Grok registra su devolución de llamada y gestiona el retorno del navegador.

Como alternativa con cliente prerregistrado, añade esta configuración a ~/.grok/config.toml:

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

En Grok Build, abre /mcps, pulsa r para recargar la configuración, selecciona reconstruct y pulsa i para iniciar sesión. La devolución de llamada es http://127.0.0.1:58234/callback. Mantén disponible el puerto 58234. No se requiere secreto de cliente. Grok inicia el receptor local de devolución de llamada y completa automáticamente la conexión tras iniciar sesión en el navegador. Este cliente público usa código de autorización con PKCE S256 y solicita consentimiento MCP. Grok también solicita offline_access para renovar tokens después del inicio de sesión; es un ámbito opcional de este cliente. Se requiere una cuenta con acceso a la plataforma.

Los ajustes OAuth anidados utilizan camelCase (clientId, callbackPort). Con solo una URL de servidor, los clientes compatibles usan registro dinámico automático con su URI de devolución de llamada exacto. Consulta la configuración OAuth de MCP.

Token de acceso personal​

Utiliza esta alternativa cuando no esté disponible el inicio de sesión en el navegador. No añadas una cabecera Authorization a la entrada OAuth anterior.

Copia tu token de acceso MCP de la configuración de cuenta de Reconstruct Platform. Consulta los requisitos en Token de acceso personal. Define CR_RECONSTRUCT_MCP_TOKEN en el entorno que inicia Grok Build.

Añade esto a tu archivo de usuario ~/.grok/config.toml. Si ya contiene otros servidores MCP, conserva sus entradas y añade solo la sección reconstruct:

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

Grok Build expande ${CR_RECONSTRUCT_MCP_TOKEN} desde el entorno al cargar la configuración. No incluyas un token literal en archivos del proyecto.

Inicia Grok Build con grok. Si ya está ejecutándose, abre /mcps y pulsa r para actualizar después de editar la configuración.

Comprueba el registro y la conectividad:

grok mcp doctor reconstruct

Pide a Grok Build que llame a list_products con las herramientas de reconstruct para confirmar el acceso.

Instrucciones de habilidades​

Los recursos MCP y las herramientas MCP son capacidades distintas. Algunas versiones de Grok Build exponen herramientas de captura al agente mediante search_tool y use_tool sin exponer resources/read. Llamar a resources/list como herramienta no carga una habilidad.

Si tu cliente no permite recursos, pide a Grok que llame a list_skills y después a get_skill con el URI del recurso del catálogo (skill://reconstruct/ seguido de la ruta devuelta). Así obtiene las mismas instrucciones empaquetadas mediante herramientas MCP normales; no hace falta una instalación independiente. Las plantillas auxiliares también se leen mediante get_skill.

Para servidores antiguos sin estas herramientas de habilidades, instala las habilidades por separado o lee las instrucciones del sitio público antes de empezar. Para una reconstrucción, usa reconstruct-inspect, reconstruct-build y reconstruct-verify desde https://reconstruct.dev/.well-known/agent-skills/<skill-name>/SKILL.md. El catálogo de descubrimiento público es https://reconstruct.dev/.well-known/agent-skills/index.json. Los datos de captura siguen procediendo de la conexión MCP autenticada. Consulta las opciones de instalación en Habilidades de Reconstruct.

Para reconstruir, el flujo actual prefiere get_interface_scene cuando lo anuncia el servidor conectado. Exporta el mismo contrato de escena neutral para adaptadores de plataforma, con hechos medidos, declarados o inferidos y pruebas ausentes explícitas. DOM/CSS son diagnósticos web opcionales. Carga la referencia Build publicada mediante get_skill; no equipares una exportación correcta con fidelidad verificada en escritorio, móvil, interacción o animación. Los servidores antiguos usan las herramientas de pruebas heredadas que anuncien y deben indicar las carencias resultantes.

Consulta la guía oficial de MCP de Grok Build. Después, prueba los ejemplos de instrucciones.