Claude Code MCP는 Windows에서 시작하자마자 연결이 끊깁니다. 특히 로컬 MCP 서버가 'npx'로 시작할 때는 'cmd /c' 래퍼가 없는지 먼저 확인하세요. Anthropic 문서에는 네이티브 윈도우에서 'npx'를 사용하는 로컬 MCP 서버가 보통 'cmd /c'로 올바르게 실행되어야 한다고 명확히 경고하고 있습니다.
먼저 Windows인지 WSL 인지 확인하세요
WSL에서 Claude 코드를 실행 중이라면, Linux 경로와 Linux Node 환경별로 문제 해결하세요. 초점은 '어느 노드'와 '어느 npm'이 WSL 내에 위치하는지에 있습니다.
네이티브 윈도우에서 실행 중이라면, 문제는 명령어 파싱 때문일 수 있습니다. 많은 MCP 구성 예시에서는 'npx 서버-name'을 작성하는데, 이는 Windows에서 Claude Code로 직접 실행되지 않을 수 있습니다.
구성 변경 방법
'npx'를 직접 부르는 명령어에서 'cmd /c'로 부르는 명령어로 변경하세요. 이 아이디어는 Windows 명령 인터프리터가 npx를 찾고 실행하는 역할을 맡게 하는 것입니다. 구체적인 필드 이름은 MCP 구성 형식에 따라 다르지만, 핵심은 명령어가 'cmd'이고, 인수에는 '/c', 'npx', 그리고 서버 패키지 이름이 포함됩니다.
변경 후에는 Claude 코드를 재시작하고 '/mcp'를 사용해 연결 상태를 확인하세요. 구성 파일이 저장되었는지만 보는 것이 아니라, 서비스가 실제로 연결되어 있는지 확인하세요.
이 문제들도 함께 해결하세요
노드는 설치되어 있지 않고, npm은 PATH에 없으며, 회사 에이전트가 npm을 가로채고, MCP 서버는 환경 변수를 요구하지만 전달하지 않아 연결이 끊깁니다. 같은 명령을 일반 터미널에서 수동으로 실행해 시작할 수 있는지 확인한 후, Claude Code에 넘기세요.
서버가 API 키를 필요로 한다면, 채팅 메시지에 키를 적지 말고 환경 변수나 보안 설정에 넣어야 합니다.
가장 안정적인 접근법
윈도우는 기본적으로 'cmd /c'를 먼저 확인하고, WSL은 리눅스 노드 경로를 우선시합니다. 그 다음 '/mcp'로 상태를 확인하고, 일반 터미널로 시작 명령을 재현하세요. "명령어가 실행될 수 있는가"와 "Claude 코드를 연결할 수 있는지"를 따로 체크하면 MCP 연결 해제가 훨씬 쉽게 해결될 것입니다.
