Claude Code MCP 설정 갱신시 주의사항

문제 상황

Claude Code에서 MCP MySQL 서버를 사용하던 중 호스트를 변경했음에도 불구하고 기존 설정이 계속 동작하는 문제가 발생했습니다.

원인 분석

claude mcp list 명령어로 확인해보니 설정하지 않은 기존 MySQL MCP 서버가 여전히 활성화되어 있었습니다. 이는 이전 설정이 완전히 제거되지 않아 새로운 설정이 제대로 적용되지 않은 것이 원인이었습니다.

해결 방법

1. 기존 MCP 서버 제거
   claude mcp remove [기존_mysql_서버_이름]
2. 프로젝트별 고유한 MCP 서버 이름 사용
   • 각 프로젝트마다 다른 이름으로 MySQL MCP 서버를 설정
   • 예: mysql-project1, mysql-project2 등
3. 설정 확인
   • 루트 디렉토리의 .claude.json 파일에서 기존 설정이
     삭제되었는지 확인
   • claude mcp list로 현재 활성화된 MCP 서버 목록 재확인

claude mcp remove mcp_server_mysql
Removed MCP server "mcp_server_mysql" from local config
File modified: /Users/yobs/.claude.json [project: /Users/yobs/Documents/dev/app]

주의사항

MCP 서버 설정을 변경할 때는 기존 설정의 완전한 제거가 중요합니다. 특히 여러 프로젝트에서 동일한 유형의 MCP 서버를 사용할 때는 프로젝트별로 고유한 이름을 부여하여 충돌을 방지하는 것으로 임시 처리했습니다.