
# Conectar otro cliente MCP {/* #connect-another-mcp-client */}

Estos pasos se aplican a un agente de IA o editor compatible con servidores MCP remotos que no tenga una guía específica aquí. Primero elige OAuth o un token personal según [Antes de empezar](/docs/es/connect-ai-agents#before-you-start).

## Añadir el servidor {/* #add-the-server */}

1. Abre la configuración de servidores MCP del cliente y añade un servidor llamado `reconstruct`.
2. Selecciona **Streamable HTTP** (a veces denominado **HTTP** o **remote HTTP**).
3. Establece la URL del servidor en `https://reconstruct.dev/mcp`.

## Inicio de sesión OAuth en el navegador {/* #oauth-browser-sign-in */}

Si tu cliente admite descubrimiento OAuth y registro dinámico de clientes (DCR), añade solo `https://reconstruct.dev/mcp`, elige OAuth y conecta. El cliente registra su propia devolución de llamada, abre el inicio de sesión de Reconstruct y recibe automáticamente la devolución de llamada al autorizar el acceso. No necesitas introducir manualmente un ID de cliente ni un puerto.

Las aplicaciones alojadas pueden registrar una devolución de llamada HTTPS exacta en un dominio público, como `https://app.example.com/mcp/callback`. Las aplicaciones nativas pueden registrar una devolución de llamada HTTP exacta en `127.0.0.1` o `localhost` con puerto explícito. La devolución de llamada pertenece al cliente y este la gestiona, no el servidor MCP. El registro requiere PKCE `S256`, consentimiento y ámbitos exclusivos de MCP. Se rechazan comodines, direcciones HTTP que no sean de bucle local, fragmentos y URL de claves remotas.

### Clientes sin registro automático {/* #clients-without-automatic-registration */}

Utiliza el cliente público prerregistrado si la aplicación no puede registrarse sola:

1. Establece el ID de cliente en `reconstruct-mcp`, los ámbitos en `openid aud-mcp` y deja vacío el secreto.
2. Establece el puerto OAuth local en `58234` y la ruta en `/callback`.
3. Guarda y conecta, completa el inicio de sesión en el navegador, autoriza el acceso y vuelve al cliente.

### Devolución de llamada local para clientes personalizados {/* #local-callback-for-custom-clients */}

Configura el cliente para escuchar en el puerto `58234` de tu ordenador y utilizar uno de estos URI de redirección exactos:

- `http://127.0.0.1:58234/callback`
- `http://localhost:58234/callback`

El cliente debe admitir código de autorización con PKCE (`S256`). Usa el ID `reconstruct-mcp`, los ámbitos `openid aud-mcp` y ningún secreto de cliente. El URI de redirección enviado al iniciar sesión e intercambiar el token debe coincidir exactamente con el configurado.

El puerto `58234` es solo para la devolución de llamada local del navegador. La URL remota MCP sigue siendo `https://reconstruct.dev/mcp` por HTTPS. Vincula el receptor a la interfaz de bucle local; no expongas este puerto a la red. Solo un flujo puede escuchar en el puerto a la vez; finaliza el inicio de sesión existente antes de empezar otro.

### Retorno automático al cliente {/* #automatic-return-to-the-client */}

El cliente MCP debe iniciar su receptor local antes de abrir el navegador. Tras iniciar sesión y consentir, Keycloak redirige el navegador a ese receptor; el cliente recibe la respuesta, intercambia el código con PKCE y reanuda la conexión MCP. Los usuarios no deberían tener que copiar manualmente una URL de devolución de llamada ni un código de autorización.

Muse Code, Grok Build, Codex y Claude Code pueden usar el puerto compartido según sus guías. Los clientes con devolución de llamada fija propia, como Cursor o Claude Desktop, conservan sus direcciones compatibles.

Para una aplicación C# personalizada, configura `ClientOAuthOptions.RedirectUri` e implementa `AuthorizationCallbackHandler` para abrir el navegador y capturar `code`, `state` e `iss`. Definir solo el URI no crea un receptor; el manejador predeterminado del SDK solicita manualmente la URL de redirección. Consulta las [opciones OAuth oficiales del SDK C#](https://github.com/modelcontextprotocol/csharp-sdk/blob/main/src/ModelContextProtocol.Core/Authentication/ClientOAuthOptions.cs).

El emisor es `https://reconstruct.dev/sso/realms/reconstruct`; utiliza sus endpoints de autorización y token descubiertos en vez de construir las URL raíz `/authorize` y `/token`.

Elimina cualquier cabecera `Authorization` manual al elegir OAuth. Si aparece un error de devolución de llamada al iniciar sesión, [contacta con soporte](https://reconstruct.dev/support) con el URI que muestra el cliente.

## Token de acceso personal {/* #personal-access-token */}

Si el cliente no admite OAuth, [crea un token MCP](/docs/es/connect-ai-agents#personal-access-token) en la configuración de la plataforma y establece la cabecera HTTP `Authorization` en `Bearer <your MCP token>`. Utiliza el almacén de secretos del cliente o la variable `CR_RECONSTRUCT_MCP_TOKEN` si se admiten.

## Comprobar la conexión {/* #check-the-connection */}

Reconecta o reinicia el cliente. Confirma que `list_products` aparece en su lista de herramientas y pide al agente que la llame.

No existe un formato JSON único para todos los clientes. Algunos usan `mcpServers`, otros `servers` o `mcp`; algunos requieren `type`. Sigue la documentación de tu cliente para los nombres exactos y la sintaxis de interpolación de tokens. Un cliente compatible solo con el transporte SSE antiguo no puede usar como SSE el endpoint HTTP `/mcp` de Reconstruct.

Si falla la conexión, consulta la [tabla de resolución de problemas](/docs/es/connect-ai-agents#troubleshooting). Una vez conectado, prueba los [ejemplos de instrucciones](/docs/es/prompt-examples).
