Conectar un agente de IA
Reconstruct expone datos de interfaces capturadas mediante un servidor MCP. Elige tu agente para ver las instrucciones de configuración:
- Codex
- Claude
- Cursor
- Cline
- GitHub Copilot en VS Code
- Gemini CLI
- MiMo
- Muse Code
- Grok Build
- Hermes Agent
- OpenClaw
- OpenMausBot
- Otros clientes MCP
Antes de empezar
El endpoint MCP de Reconstruct es https://reconstruct.dev/mcp y utiliza Streamable HTTP. Puedes conectarte mediante inicio de sesión OAuth en el navegador o un token de acceso personal.
| Método | Funcionamiento | Cuándo utilizarlo |
|---|---|---|
| Inicio de sesión OAuth en el navegador | Tu cliente MCP abre el inicio de sesión de Reconstruct en un navegador. Inicia sesión, autoriza el acceso y vuelve al cliente. No necesitas crear ni copiar un token desde la plataforma. | Agentes interactivos y editores compatibles con OAuth. |
| Token de acceso personal | Crea un token MCP en la configuración de la plataforma y añádelo a las credenciales del cliente. | Clientes sin OAuth o entornos automatizados sin inicio de sesión en navegador. |
Ambos métodos se conectan al mismo servidor MCP y utilizan la suscripción y cuota de uso de tu cuenta de Reconstruct.
Inicio de sesión OAuth en el navegador
No necesitas emitir un token personal en la plataforma antes de conectar mediante OAuth.
- Añade
https://reconstruct.dev/mcpcomo servidor HTTP MCP remoto en tu cliente. - Selecciona OAuth o inicio de sesión en navegador. Si el cliente solicita ajustes de conexión, utiliza los valores siguientes.
- Inicia Sign in (Iniciar sesión), Connect (Conectar) o el comando de inicio de sesión MCP del cliente. La acción exacta depende del cliente.
- En el navegador, inicia sesión con tu cuenta de Reconstruct y autoriza el acceso solicitado. Si el registro no está disponible, contacta con soporte para acceder a una cuenta.
- Vuelve al cliente y actualiza sus herramientas. Pídele que llame a
list_productspara confirmar la conexión.
| Ajuste | Valor |
|---|---|
| URL del servidor | https://reconstruct.dev/mcp |
| Transporte | Streamable HTTP |
| ID de cliente OAuth | reconstruct-mcp para clientes preconfigurados; Claude Desktop se registra automáticamente |
| Ámbitos | openid aud-mcp |
| Secreto de cliente | Dejar vacío |
| Emisor OAuth | https://reconstruct.dev/sso/realms/reconstruct |
| Endpoint de autorización | https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth |
| Endpoint de token | https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token |
El cliente obtiene y guarda sus credenciales OAuth tras iniciar sesión y las utiliza para las llamadas MCP. Este método no requiere copiar un token ni definir CR_RECONSTRUCT_MCP_TOKEN. Elimina cualquier cabecera Authorization o ajuste de token bearer configurado manualmente al cambiar una conexión existente a OAuth.
Consulta los ejemplos OAuth para Codex, Claude Code, Cursor, Cline, OpenMausBot u otro cliente MCP. Utiliza los ajustes de devolución de llamada documentados para tu cliente. Si solicita iniciar sesión otra vez, repite su flujo de inicio de sesión MCP.
Compatibilidad de clientes
Los ejemplos de inicio de sesión en navegador cubren Claude, Cursor, Claude Code, Codex, Grok Build y Muse Code con sus direcciones de devolución de llamada registradas. Las guías de Gemini CLI, VS Code, MiMo Code, MiMo Desktop, Hermes Agent y OpenClaw usan tokens personales; la de VS Code también ofrece instalación con un clic y registro automático. Claude Desktop y el conector web admiten registro automático con una devolución de llamada HTTPS exacta aprobada. Otros clientes compatibles con descubrimiento OAuth y registro dinámico también pueden conectarse solo con la URL; registran y gestionan su propia devolución de llamada HTTPS exacta o de bucle local. Los ajustes de cliente público preconfigurado siguen siendo una alternativa sin DCR.
Los endpoints OAuth proceden de los metadatos de descubrimiento. Están bajo el realm de SSO, no en /authorize o /token en la raíz del sitio. Si un cliente abre un endpoint raíz, recarga su configuración de servidor y repite el inicio de sesión para actualizar el descubrimiento en caché.
Para el conector de nube de Claude, sigue la guía de Claude Desktop. Contacta con soporte con el URI de devolución de llamada exacto antes de conectar otra integración en la nube. No se debe introducir un secreto de cliente para reconstruct-mcp.
Descubrimiento de agentes e inicio de sesión por dispositivo
El descubrimiento público empieza en https://reconstruct.dev/mcp/server-card. La raíz /.well-known/api-catalog enumera documentación API pública y /.well-known/agent-skills/index.json, los flujos de Reconstruct y sus archivos instalables. Consulta Habilidades de Reconstruct para los nueve flujos, acceso mediante recursos MCP sin instalación independiente, instalación desde web o GitHub CLI, descargas manuales y paquetes específicos de cliente. La conexión remota MCP no requiere .NET SDK en el ordenador del usuario.
Las páginas y documentación publicadas aceptan Accept: text/markdown. Las páginas del espacio de trabajo siguen requiriendo acceso a la cuenta.
Los clientes que implementan autorización de dispositivo OAuth pueden leer https://reconstruct.dev/auth.md y enviar POST {"type":"anonymous"} a https://reconstruct.dev/agent/register. La respuesta contiene una autorización de dispositivo pendiente, URL y código de verificación del usuario, caducidad, intervalo de sondeo y un code_verifier PKCE privado. Muestra al usuario las instrucciones de verificación. Debe iniciar sesión y autorizar el acceso. El agente sondea después el endpoint de token del emisor mediante la concesión de código de dispositivo y el code_verifier recibido. Respeta el intervalo y las respuestas slow_down. El registro no emite por sí mismo un token ni crea una cuenta. Siguen vigentes roles, límites de suscripción y requisitos de consentimiento.
Mantén privados códigos de dispositivo, verificadores y tokens. Nunca autorices el acceso en nombre del usuario. Este flujo está disponible para clientes que lo implementan; no sustituye la configuración existente de código de autorización + PKCE de un editor.
Token de acceso personal
- Inicia sesión en Reconstruct Platform y abre Settings → API tokens (Configuración → Tokens API).
- Crea un token con el ámbito MCP (
mcp) y copia su secreto cuando aparezca. - Configura el cliente para enviar
Authorization: Bearer <token>. Si lee el token de una variable de entorno, utilizaCR_RECONSTRUCT_MCP_TOKEN. - Conecta y pide al cliente que llame a
list_products.
Guarda el token en un secreto local o almacén de credenciales del cliente. Si caduca o se revoca, crea otro en los ajustes de la plataforma y actualiza las credenciales del cliente.
Seleccionar datos capturados
Empieza con list_products, list_platforms y list_versions. Elige tipos de plataforma y entornos de list_platforms.options.platforms[], usando sus ID. list_platforms.platforms[] contiene combinaciones con datos realmente capturados. Usa la clave view guardada exacta de list_pages.views[] para herramientas de página. Pasa environment explícitamente si una versión contiene varios entornos. Las herramientas de contexto necesitan uso disponible en la suscripción y consumen una lectura al aceptarse la llamada, incluidos resultados en caché. Una llamada aceptada sigue contando si falla después. Descubrimiento, herramientas de imagen y descargas de recursos no consumen lecturas. Consulta los límites de uso.
Resolución de problemas
| Síntoma | Comprobación |
|---|---|
401 Unauthorized | Completa el inicio de sesión OAuth o comprueba el token personal; sustitúyelo si ha caducado o se ha revocado. |
/authorize devuelve 404 | Actualiza los metadatos de conexión y repite el inicio de sesión; el endpoint de autorización está bajo https://reconstruct.dev/sso/realms/reconstruct. |
invalid_scope | Solicita openid aud-mcp; Grok Build también puede solicitar el ámbito opcional offline_access. |
| Se exige autenticación después de iniciar sesión | Actualiza el servidor y repite su inicio de sesión OAuth. Elimina las credenciales bearer manuales en conflicto. |
| La redirección OAuth no coincide | Utiliza el puerto de devolución de llamada documentado para tu cliente. Si persiste, contacta con soporte con el URI que muestra el cliente. |
| Registro dinámico de cliente rechazado | Elige registro OAuth automático y reintenta al cabo de un minuto. El cliente debe proporcionar una devolución de llamada HTTPS exacta o de bucle local y admitir PKCE S256. Si no puede registrarse solo, usa los ajustes OAuth preconfigurados de su guía. |
| El servidor no puede conectarse | Confirma que https://reconstruct.dev/mcp es accesible desde el equipo del agente. |
| Las herramientas deniegan el acceso | Inicia sesión con tu cuenta de Reconstruct y comprueba la suscripción. Contacta con soporte si sigue sin haber acceso. |
| Cuota o uso no disponible | Comprueba el uso en los ajustes de cuenta y la página de estado. Reintenta cuando haya acceso. |
| Hay varios entornos capturados | Proporciona environment de list_versions. |
| Plataforma o vista solicitada no disponible | Utiliza combinaciones de plataforma/entorno capturadas y las claves exactas de list_pages.views[]; admitir opciones no garantiza datos almacenados. |
| No aparecen herramientas | Reinicia el agente o actualiza su lista MCP y comprueba el estado del servidor. |
Una vez conectado, prueba los ejemplos de instrucciones o consulta el catálogo de herramientas MCP.
Solicitar una captura nueva o actualización
El servidor MCP incluye get_request_options, create_product_request, get_product_request, list_product_requests y wait_product_request. Inicia sesión mediante OAuth o usa un token MCP. Tu suscripción debe admitir solicitudes y solo puedes ver las enviadas con tu cuenta. Pide al agente que envíe una URL de producto nueva o actualice una clave de producto publicada conocida; después debe conservar requestId y esperar cambios de estado de revisión. Una solicitud aprobada no significa que la captura esté lista. Consulta los parámetros en las herramientas de solicitudes.