Łączenie zdalnych klientów

Serwer jest zbudowany, działa za proxy i ma prawidłowy stan. Teraz prawdziwi klienci mogą łączyć się z nim przez internet za pomocą publicznego adresu URL. 🌍

Zdalni klienci nie uruchamiają już procesu lokalnie. Zamiast tego przekazuje się im publiczny adres URL serwera, zwykle kończący się endpointem /mcp.

W hoście takim jak Claude rejestruje się zdalny serwer, podając jego adres URL zamiast polecenia, dzięki czemu host łączy się przez HTTP.

Chroniony serwer wymaga tokenu dostępu. Klienci dołączają go do nagłówka Authorization w każdym wysyłanym żądaniu.

Własny klient w Pythonie łączy się w ten sam sposób: otwiera sesję streamable HTTP z użyciem zdalnego adresu URL zamiast uruchamiać standardowe wejście/wyjście.

Niezależnie od tego, czy połączenie jest zdalne, czy lokalne, zaczyna się od tego samego uzgodnienia initialize, podczas którego klient i serwer uzgadniają wersję oraz funkcje.

Po nawiązaniu połączenia klient wyświetla narzędzia, zasoby i prompty przez sieć dokładnie tak samo, jak w przypadku serwera lokalnego.

Przeskoki w sieci wprowadzają opóźnienie, którego nie ma w lokalnym standardowym wejściu/wyjściu. Należy uwzględnić niewielką latencję i projektować narzędzia tak, aby powolne wywołanie nie blokowało użytkownika.

Internet bywa zawodny, więc połączenia mogą się zrywać. Dobry klient łączy się ponownie i wznawia pracę zamiast przerywać całą sesję.

Potwierdź działanie pełnej ścieżki: od klienta, przez proxy i serwer, z powrotem do klienta. Pomyślny wynik działania narzędzia dowodzi, że wdrożenie rzeczywiście działa. ✅

Największą korzyścią z przejścia na tryb zdalny jest udostępnianie: jeden hostowany serwer może jednocześnie obsługiwać członków zespołu, agentów i aplikacje.

Zdalni klienci łączą się z publicznym adresem URL za pomocą tokenu uwierzytelniającego, wykonują to samo uzgodnienie i wykrywanie, a jeden serwer może obsługiwać wielu klientów. 🎉