Conectar clientes remotos

Seu servidor está compilado, protegido por proxy e íntegro. Agora, clientes reais se conectam a ele pela internet usando sua URL pública. 🌍

Os clientes remotos não iniciam mais um processo local. Em vez disso, você fornece a eles a URL pública do servidor, geralmente terminada no seu endpoint /mcp.

Em um host como o Claude, você registra um servidor remoto fornecendo sua URL em vez de um comando, para que o host se conecte por HTTP.

Um servidor protegido espera um token de acesso. Os clientes o anexam em um cabeçalho Authorization a cada solicitação enviada.

Seu próprio cliente Python se conecta da mesma forma: abre uma sessão de HTTP transmitível com a URL remota, em vez de iniciar o stdio.

Seja remota ou local, a conexão começa com o mesmo handshake de initialize, no qual cliente e servidor concordam sobre a versão e os recursos.

Após a conexão, o cliente lista ferramentas, recursos e prompts pela rede exatamente como faria com um servidor local.

Os saltos de rede acrescentam um atraso que o stdio local não tinha. Espere um pouco de latência e projete as ferramentas para que uma chamada lenta não bloqueie o usuário.

A internet é instável, portanto as conexões caem. Um bom cliente irá reconectar e retomar a sessão, em vez de fazer toda a sessão falhar.

Confirme que todo o caminho funciona: do cliente ao proxy, do proxy ao servidor e de volta. Um resultado bem-sucedido da ferramenta comprova que a implantação está realmente ativa. ✅

A grande vantagem de operar remotamente é o compartilhamento: um único servidor hospedado pode atender colegas de equipe, agentes e aplicativos ao mesmo tempo.

Os clientes remotos se conectam à sua URL pública com um token de autenticação, executam o mesmo handshake e a mesma descoberta, e permitem que um único servidor atenda a muitos clientes. 🎉