Saltar al contenido principal

Conectar otro cliente MCP

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.

Añadir el servidor​

  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​

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​

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​

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​

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#.

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 con el URI que muestra el cliente.

Token de acceso personal​

Si el cliente no admite OAuth, crea un token MCP 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​

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. Una vez conectado, prueba los ejemplos de instrucciones.