Collegare client remoti

Il server è pronto, protetto da un proxy e integro. Ora i client reali vi si connettono tramite Internet usando il suo URL pubblico. 🌍

I client remoti non avviano più un processo locale. Invece, fornisca loro l'URL pubblico del server, che di solito termina con l'endpoint /mcp.

In un host come Claude, registri un server remoto fornendo il relativo URL anziché un comando, così l'host si connette tramite HTTP.

Un server protetto richiede un token di accesso. I client lo allegano in un'intestazione Authorization a ogni richiesta inviata.

Il client Python che ha creato si connette allo stesso modo: apra una sessione streamable HTTP verso l'URL remoto invece di avviare stdio.

Remota o locale, la connessione inizia con lo stesso handshake initialize, durante il quale client e server concordano versione e funzionalità.

Dopo la connessione, il client elenca strumenti, risorse e prompt sulla rete esattamente come farebbe con un server locale.

I passaggi di rete aggiungono un ritardo che lo stdio locale non aveva. Preveda una certa latenza e progetti gli strumenti in modo che una chiamata lenta non blocchi l'utente.

Internet è instabile, quindi le connessioni possono interrompersi. Un buon client si riconnette e riprende il lavoro invece di interrompere l'intera sessione.

Confermi che l'intero percorso funzioni: dal client al proxy, dal proxy al server e ritorno. Un risultato positivo dello strumento dimostra che la distribuzione è realmente online. ✅

Il principale vantaggio dell'accesso remoto è la condivisione: un server ospitato può servire contemporaneamente colleghi, agenti e applicazioni.

I client remoti si connettono all'URL pubblico con un token di autenticazione, eseguono lo stesso handshake e rilevamento e permettono a un unico server di servire molti client. 🎉