Claude Code에서 MCP 서버 등록하고 잘 쓰다가, 다른 프로젝트 폴더로 이동하니까 갑자기 MCP가 안 잡히는 경우가 있습니다. 분명히 claude mcp add로 등록했는데 /mcp 쳐보면 없다고 나오더라고요.
원인은 간단합니다. 로컬로 등록해서 그렇습니다.
전역 설치시 옵션 확인하기
claude mcp add 명령어는 기본적으로 현재 폴더 기준으로 로컬 등록됩니다. 그래서 해당 폴더에서만 MCP 서버가 동작하고, 다른 폴더 가면 없는 취급당합니다.
어디서든 쓰려면 -s user 옵션 붙여서 전역으로 등록해야 합니다.
# 로컬 등록 (현재 폴더에서만 동작)
claude mcp add 서버이름 --env API_KEY=... -- npx ...
# 전역 등록 (어디서든 동작)
claude mcp add 서버이름 -s user --env API_KEY=... -- npx ...
예시: TestSprite MCP 전역 등록
claude mcp add TestSprite -s user --env API_KEY=your-api-key -- npx @testsprite/testsprite-mcp@latest이렇게 등록하면 어느 폴더에서 Claude Code 실행해도 TestSprite MCP 서버 사용할 수 있습니다.
이미 로컬로 MCP를등록한 경우
기존에 로컬로 등록한 거 지우고 다시 전역으로 등록하면 됩니다.
# 기존 로컬 설정 삭제
claude mcp remove 서버이름
# 전역으로 재등록
claude mcp add 서버이름 -s user --env API_KEY=... -- npx ...저도 처음에 이거 몰라서 프로젝트마다 MCP 등록하고 설치가 완료된줄 알았는데 다른 프로젝트에서는 안보여서 당황스러웠던 적이 있습니다. 이후에 -s user 알고 나니까 한 번 등록으로 끝나고 굉장히 간편했습니다.