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