Claude Code에서 MCP 서버 추가했는데 도구가 안 뜹니다
claude mcp add로 MCP 서버를 등록했는데 세션에서 도구가 인식이 안 됩니다. /mcp로 봐도 안 잡히거나 connected가 안 떠요. 설정에서 확인할 점이 있을까요?
답변 1개
보통 셋 중 하나예요.
- 등록은 됐는데 scope를 잘못 잡음.
claude mcp add는 기본이 local(그 프로젝트+그 사용자)이라, 디렉터리 바꿔서 켜면 안 보입니다. 어디서든 쓰려면-s user, 팀이랑 공유하려면-s project(.mcp.json커밋).claude mcp list로 어느 scope에 들어갔는지 먼저 확인. - 서버가 실제로 안 뜸.
/mcp쳐서 connected인지 failed인지 보세요. failed면 command/env가 틀린 거. stdio 서버는command경로랑 인자가 진짜 실행되는지 터미널에서 그 명령 그대로 직접 한 번 돌려보면 바로 나옵니다(보통 node/python 경로나 빌드 안 한 dist 문제). - 고쳤으면 세션 재시작. mcp 설정은 시작 시점에 로드돼서 돌아가는 세션엔 반영이 잘 안 돼요.
원격(SSE/HTTP) 서버면 OAuth 토큰 만료로 조용히 끊겼다 붙는 경우도 있으니 그건
/mcp에서 reconnect 한 번 해보시고요.- 등록은 됐는데 scope를 잘못 잡음.