Conectar clientes remotos

Su servidor está construido, funciona detrás de un proxy y está saludable. Ahora los clients reales se conectan a él por Internet mediante su URL pública. 🌍

Los clientes remotos ya no inician un proceso local. En su lugar, debe proporcionarles la URL pública del servidor, que normalmente termina en su endpoint /mcp.

En un host como Claude, registra un servidor remoto proporcionando su URL en lugar de un comando, de modo que el host se conecte mediante HTTP.

Un servidor protegido espera un token de acceso. Los clientes lo adjuntan en un encabezado Authorization en cada solicitud que envían.

Su propio cliente de Python se conecta de la misma manera: abre una sesión de streamable HTTP con la URL remota en lugar de iniciar stdio.

Tanto si la conexión es remota como local, comienza con el mismo protocolo de enlace initialize, en el que el cliente y el servidor acuerdan la versión y las funcionalidades.

Después de conectarse, el cliente enumera tools, recursos y prompts a través de la red, exactamente como lo haría con un servidor local.

Los saltos de red añaden un retraso que el stdio local nunca tenía. Espere algo de latency y diseñe las herramientas de modo que una llamada lenta no bloquee al usuario.

Internet es inestable, por lo que las conexiones se interrumpen. Un buen cliente se reconnectará y reanudará la sesión en lugar de hacerla fallar por completo.

Confirme que toda la ruta funciona: del cliente al proxy, del proxy al servidor y de vuelta. Un resultado correcto de una herramienta demuestra que el despliegue está realmente activo. ✅

La gran ventaja de trabajar de forma remota es el sharing: un único servidor alojado puede atender al mismo tiempo a compañeros de equipo, agentes y aplicaciones.

Los clientes remotos se conectan a su URL pública con un token de autenticación, realizan el mismo protocolo de enlace y descubrimiento, y permiten que un servidor atienda a muchos clientes. 🎉