Externe clients verbinden

In een host zoals Claude registreer je een externe server door de URL op te geven in plaats van een opdracht, zodat de host via HTTP verbinding maakt.

Een beveiligde server verwacht een toegangstoken. Clients voegen dit toe in een Authorization-header bij elke aanvraag die ze versturen.

Je eigen Python-client maakt op dezelfde manier verbinding: open een streamable HTTP-sessie tegen de externe URL in plaats van stdio te starten.

Extern of lokaal, de verbinding begint met dezelfde initialize-handshake waarin client en server het eens worden over de versie en functies.

Na het verbinden vermeldt de client tools, bronnen en prompts via het netwerk, precies zoals bij een lokale server.

Netwerksprongen voegen vertraging toe die lokale stdio niet had. Houd rekening met enige latentie en ontwerp tools zo dat een trage aanroep de gebruiker niet blokkeert.

Internetverbindingen zijn onbetrouwbaar en kunnen wegvallen. Een goede client maakt opnieuw verbinding en hervat de sessie in plaats van de hele sessie te laten mislukken.

Bevestig dat het volledige pad werkt: van client naar proxy naar server en terug. Een geslaagd toolresultaat bewijst dat de uitrol echt live is. ✅

De grote winst van op afstand werken is delen: één gehoste server kan tegelijk teamgenoten, agents en apps bedienen.

Externe clients maken met een authenticatietoken verbinding met je openbare URL, voeren dezelfde handshake en ontdekking uit en laten één server veel clients bedienen. 🎉