# Conectar un agente de IA {/* #connect-an-ai-agent */}

Reconstruct expone datos de interfaces capturadas mediante un servidor MCP. Elige tu agente para ver las instrucciones de configuración:

- [Codex](/docs/es/agents/codex)
- [Claude](/docs/es/agents/claude)
- [Cursor](/docs/es/agents/cursor)
- [Cline](/docs/es/agents/cline)
- [GitHub Copilot en VS Code](/docs/es/agents/vscode-copilot)
- [Gemini CLI](/docs/es/agents/gemini-cli)
- [MiMo](/docs/es/agents/mimo)
- [Muse Code](/docs/es/agents/muse-code)
- [Grok Build](/docs/es/agents/grok-build)
- [Hermes Agent](/docs/es/agents/hermes)
- [OpenClaw](/docs/es/agents/openclaw)
- [OpenMausBot](/docs/es/agents/openmausbot)
- [Otros clientes MCP](/docs/es/agents/other-mcp-clients)

## Antes de empezar {/* #before-you-start */}

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 {/* #oauth-browser-sign-in */}

No necesitas emitir un token personal en la plataforma antes de conectar mediante OAuth.

1. Añade `https://reconstruct.dev/mcp` como servidor HTTP MCP remoto en tu cliente.
2. Selecciona OAuth o inicio de sesión en navegador. Si el cliente solicita ajustes de conexión, utiliza los valores siguientes.
3. 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.
4. 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.
5. Vuelve al cliente y actualiza sus herramientas. Pídele que llame a `list_products` para 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](/docs/es/agents/codex#oauth-browser-sign-in), [Claude Code](/docs/es/agents/claude-code#oauth-browser-sign-in), [Cursor](/docs/es/agents/cursor#oauth-browser-sign-in), [Cline](/docs/es/agents/cline#oauth-browser-sign-in), [OpenMausBot](/docs/es/agents/openmausbot#oauth-browser-sign-in) u [otro cliente MCP](/docs/es/agents/other-mcp-clients#oauth-browser-sign-in). 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 {/* #client-compatibility */}

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](/docs/es/agents/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 {/* #agent-discovery-and-device-sign-in */}

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](/docs/es/skills) 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 {/* #personal-access-token */}

1. Inicia sesión en [Reconstruct Platform](https://reconstruct.dev/platform/) y abre **Settings → API tokens** (Configuración → Tokens API).
2. Crea un token con el ámbito **MCP** (`mcp`) y copia su secreto cuando aparezca.
3. Configura el cliente para enviar `Authorization: Bearer <token>`. Si lee el token de una variable de entorno, utiliza `CR_RECONSTRUCT_MCP_TOKEN`.
4. 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 {/* #select-captured-data */}

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](/docs/es/mcp-tools#usage-limits).

## Resolución de problemas {/* #troubleshooting */}

| 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](/docs/es/prompt-examples) o consulta el [catálogo de herramientas MCP](/docs/es/mcp-tools).

### Solicitar una captura nueva o actualización {/* #request-a-new-capture-or-update */}

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](/docs/es/mcp-tools#product-requests).