원격 클라이언트 연결하기

서버를 구축하고 프록시를 설정했으며 정상 상태도 확인했습니다. 이제 실제 클라이언트가 공개 URL을 사용해 인터넷으로 서버에 연결합니다. 🌍

원격 클라이언트는 더 이상 로컬 프로세스를 실행하지 않습니다. 대신 일반적으로 /mcp 엔드포인트로 끝나는 서버의 공개 URL을 전달합니다.

Claude 같은 호스트에서는 명령 대신 URL을 제공해 원격 서버를 등록합니다. 그러면 호스트가 HTTP를 통해 연결합니다.

보호된 서버는 액세스 토큰을 요구합니다. 클라이언트는 모든 요청에 Authorization 헤더로 토큰을 첨부합니다.

직접 만든 Python 클라이언트도 같은 방식으로 연결합니다. stdio를 생성하는 대신 원격 URL에 대해 스트리밍 가능한 HTTP 세션을 여세요.

원격이든 로컬이든 연결은 동일한 초기화 핸드셰이크로 시작됩니다. 이 과정에서 클라이언트와 서버가 버전과 기능에 합의합니다.

연결한 후 클라이언트는 로컬 서버를 사용할 때와 마찬가지로 네트워크를 통해 도구, 리소스, 프롬프트를 나열합니다.

네트워크를 거치면 로컬 stdio에는 없던 지연이 추가됩니다. 약간의 지연 시간을 예상하고, 느린 호출 하나가 사용자를 멈춰 세우지 않도록 도구를 설계하세요.

인터넷은 불안정하므로 연결이 끊어질 수 있습니다. 좋은 클라이언트는 전체 세션을 실패시키는 대신 재연결하고 작업을 재개합니다.

클라이언트에서 프록시를 거쳐 서버로 갔다가 돌아오는 전체 경로가 작동하는지 확인하세요. 도구의 성공적인 결과가 배포가 실제로 작동 중임을 증명합니다. ✅

원격으로 전환했을 때의 가장 큰 이점은 공유입니다. 호스팅된 서버 하나가 팀원, 에이전트, 앱에 동시에 서비스를 제공할 수 있습니다.

원격 클라이언트는 인증 토큰과 함께 공개 URL에 연결하고, 동일한 핸드셰이크와 검색을 수행하며, 서버 하나가 여러 클라이언트에 서비스를 제공하게 합니다. 🎉