참고팁Reddit
Claude Code용 로컬 MCP 서버, 윈도우 환경 설정 이슈 해결 팁
JSON 설정 파일의 백슬래시 오작동으로 인한 에이전트 연결 실패 사례. 윈도우 개발 환경에서 바로 적용 가능한 해결책.
요약
윈도우 환경에서 Claude Code용 로컬 MCP 서버를 구축할 때 발생할 수 있는 3가지 침묵 오류 사례가 공유되었습니다. 첫 번째는 .mcp.json 설정 파일 내 경로 지정 시 역슬래시(\)를 사용하면 JSON 파싱 오류로 인해 별도의 경고 없이 서버가 무시되는 문제입니다. 이 경우 역슬래시를 슬래시(/)로 변경하여 해결할 수 있으며, 이는 윈도우 환경의 Node.js에서도 정상 작동합니다. 두 번째는 stdio 방식의 MCP 서버에서 stdout이 프로토콜 통신 전용으로 사용되어야 한다는 점입니다. 서버 코드에서 stdout에 일반 로그를 출력할 경우 프로토콜 오류가 발생할 수 있으므로, 로그는 stderr로 출력해야 합니다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 3 silent failures I hit building a local MCP server for Claude Code on Windows
원문 보기 ↗