claude code 특정 mcp가 아무리 지우고 다시 설치해도 설치가 제대로 안되는 이슈 해결 방법

 experience

• claude code 사용중에 mcp 서버 설치해서 이용하려는데, 설치가 안되는 현상 발생

windows 11을 메인 OS로 사용중이라 빠르게 업데이트되는 claude 쪽에서 윈도우 대응이 느려서 그런건가 싶기도 했고, 

claude를 terminal에서 열면 어떤 mcp는 설치가 되고, VSCode에서 열면 failed가 뜨기도 하고 그래서 실행환경(?)과도 연관이 있다고 생각해서 그냥 이용.

그리고 VSCode 재시작시 /mcp로 목록을 조회하면, 특정 mcp만 어떤 경우는 성공하고, 또 재시작해서 확인해보면, 어떤 경우는 실패하는 경우가 종종 발견됨.

그러려니 하고, 이용중 불편해서 claude에게 이에 대해서 문의하면, 윈도우라 해당 mcp 실행 커맨드의 문제라거나 등으로 안내를 해주는데, 해결방법대로 수정을 해도 동일 문제가 계속 재현됨.

잠시 잊고, claude와 많은 대화 과정에서 단서를 발견.. 이유는 아래와 같았음.

Claude Code의 유저영역(~) 에 mcp와 관련된 설정파일이 아래 두 종류 존재

• ~/.claude.json
• ~/.claude/settings.json

~/.claude.json 

Claude가 직접 읽고 쓰는 내부 상태파일

GUI에서 MCP 서버 추가/삭제 시 위 파일 이용

MCP 서버 설정시 높은 우선순위

그 외, 계정, 세션 기록, 캐시, 통계 등 앱상태를 포함함

~/.claude/settings.json 

유저가 설정하는 보조 설정파일

권한(permissions)등 설정 위주

MCP 서버도 정의하지만 .claude.json과 머지되면서 우선순위가 낮음

결국 위 두파일의 충돌이 원인이었던 것으로 확인.

프로젝트 단위가 아닌, 유저 영역에서 사용할 mcp설정은 주로 claude를 시켜서 ~ 하위의 유저영역에 설치하도록 하곤 했는데, claude가 가끔 위 두파일을 모두 호환되게 수정하지 못하고, 한쪽만 수정해서 문제가 발생한 듯. (또는 본인이 직접 잘못 수정했을 수도 있음..)

claude에게 문제의 MCP에 대해서 위 두파일 설정 봐달라고 했더니, 문제 바로 인식하고 수정도 해줌.