원격 MCP를 사용한 커스텀 커넥터는 Claude, Cowork, Claude Desktop에서 무료, Pro, Max, Team, Enterprise 플랜의 사용자에게 제공됩니다. 무료 사용자는 하나의 커스텀 커넥터로 제한됩니다. 이 기능은 현재 베타 버전입니다.
원격 MCP 서버 구축
원격 서버를 시작하려면 다음 리소스부터 시작하세요:
인증 사양, 특히 타사 서비스의 인증 흐름에 대한 세부 정보.
TypeScript 및 Python SDK의 원격 서버 예제.
TypeScript 및 Python SDK의 클라이언트 및 서버 인증 구현.
공식 MCP 로드맵 및 드래프트 사양의 변경 로그에서 프로토콜이 어떻게 발전할지에 대한 세부 정보.
다른 리소스(예: 이것)도 원격 서버 구축, 배포 및 문제 해결 시 고려 사항을 배우는 데 도움이 될 수 있습니다.
또한 Cloudflare와 같은 일부 솔루션은 자동 확장, OAuth 토큰 관리 및 배포가 내장된 원격 MCP 서버 호스팅을 제공합니다.
MCP 지원
플랫폼
원격 MCP 서버는 Pro, Max, Team, Enterprise 플랜의 Claude 및 Claude Desktop에서 지원됩니다.
Claude Desktop에서 사용할 원격 MCP 서버를 구성하려면 설정 > 커넥터를 통해 추가하세요. Claude Desktop은 claude_desktop_config.json을 통해 직접 구성된 원격 서버에 연결하지 않습니다.
7월부터 Claude for iOS 및 Android도 원격 MCP 서버를 지원합니다!
사용자는 claude.ai를 통해 이미 추가한 원격 서버의 도구, 프롬프트 및 리소스를 사용할 수 있습니다. 사용자는 Claude Mobile에서 직접 새 서버를 추가할 수 없습니다.
전송 및 인증
Claude는 SSE 및 Streamable HTTP 기반 원격 서버를 모두 지원하지만, SSE에 대한 지원은 향후 몇 개월 내에 중단될 수 있습니다.
Claude는 인증 없음 및 OAuth 기반 원격 서버를 모두 지원합니다.
인증 지원
Claude는 3/26 인증 사양 및 (7월부터) 6/18 인증 사양을 지원합니다.
Claude는 동적 클라이언트 등록(DCR)을 지원합니다.
OAuth 서버는 DCR 클라이언트가 삭제되었으며 Claude가 클라이언트를 다시 등록해야 함을 Claude에 신호할 수 있습니다. 이는 토큰 엔드포인트에서 invalid_client 오류와 함께 HTTP 401을 반환하여 수행할 수 있으며, RFC 6749에 설명되어 있습니다.
7월부터 사용자는 DCR을 지원하지 않는 서버를 구성할 때 커스텀 클라이언트 ID 및 클라이언트 시크릿을 지정할 수도 있습니다.
Claude의 OAuth 콜백 URL은 https://claude.ai/api/mcp/auth_callback이고 OAuth 클라이언트 이름은 Claude입니다.
이 콜백 URL은 향후 https://claude.com/api/mcp/auth_callback으로 변경될 수 있습니다. MCP 클라이언트 콜백 URL을 허용 목록에 추가하기로 선택한 경우, 서버가 Claude와 계속 작동하도록 이 콜백 URL도 허용 목록에 추가하세요.
Claude는 토큰 만료 및 새로 고침을 지원합니다. 서버는 사용자에게 최상의 경험을 제공하기 위해 이 기능을 지원해야 합니다.
Claude가 MCP 서버에 대한 인바운드 및 아웃바운드 연결에 사용하는 IP 주소는 여기를 참조하세요. 비 Claude MCP 클라이언트를 거부하려는 서버 개발자는 이러한 IP 주소, Claude의 OAuth 콜백 URL 및/또는 Claude의 OAuth 클라이언트 이름을 허용 목록에 추가할 수 있습니다.
프로토콜 기능
Claude는 도구, 프롬프트 및 리소스를 지원합니다.
Claude는 텍스트 및 이미지 기반 도구 결과를 지원합니다.
Claude는 텍스트 및 바이너리 기반 리소스를 지원합니다.
Claude는 아직 리소스 구독, 샘플링 및 기타 고급 또는 드래프트 기능을 지원하지 않습니다.
원격 MCP 서버 테스트
서버를 테스트하고 검증하는 가장 좋은 방법은 Claude에 추가하는 것입니다.
또는 inspector 도구를 사용하세요. 이를 통해 다음을 검증할 수 있습니다:
서버가 인증 흐름을 성공적으로 시작하고 완료하는지 여부.
서버가 인증 흐름의 다양한 부분을 올바르게 구현하는지 여부.
서버가 노출하는 도구, 프롬프트, 리소스 및 기타 MCP 기능.
inspector 사용 방법 및 서버 디버깅 및 문제 해결 방법에 대한 기타 팁은 MCP 문서를 참조하세요.
또한 Cloudflare의 AI Playground와 같은 다른 솔루션을 통해 원격 MCP 서버 기능을 테스트할 수 있습니다.