MCP 서버 추가·삭제와 Claude Code 고급 설정 완전 정복 가이드

요즘 개발자 커뮤니티에서 자주 들리는 말이 있습니다.


“Claude Code에 MCP 붙여보면 신세계다.”


하지만 막상 시도해보면 서버 추가는 어떻게 하는지, 삭제는 안전한지, 설정 하나 잘못 건드리면 터지는 건 아닌지 불안해지는 게 현실입니다.


이 글은 그런 분들을 위해 실제로 써본 사람 기준으로 쉽고 재미있게, 그리고 지금 기준 팩트만 정리했습니다.

---

📚 목차

• 1. MCP 서버란 무엇인가
• 2. MCP 서버 추가 방법
• 3. MCP 서버 삭제 시 주의점
• 4. Claude Code 고급 설정 핵심
• 5. 실전에서 겪는 문제와 해결 팁

---

1️⃣ MCP 서버란 무엇인가

MCP(Model Context Protocol)는 AI 코드 도구가 외부 데이터와 도구를 안전하게 연결하도록 만든 표준입니다.


쉽게 말해 Claude Code가 “내 로컬 파일, DB, API를 직접 읽고 쓰게 해주는 다리” 역할을 합니다.


그래서 MCP 서버를 붙이면 ✔ 코드 이해력 상승 ✔ 프로젝트 맥락 유지 ✔ 반복 설명 감소 라는 체감 효과가 생깁니다.

---

2️⃣ MCP 서버 추가 방법 (초보자 기준)

MCP 서버 추가는 생각보다 단순합니다.


핵심은 “Claude Code 설정 파일을 건드리는 것”입니다.


보통 다음 경로에 설정합니다.

~/.config/claude/mcp.json

여기에 서버 정보를 추가하면 Claude가 실행 시 자동으로 MCP 서버를 인식합니다.


중요한 점은 서버 주소, 실행 명령, 권한 범위를 최소 권한 원칙으로 설정하는 것입니다.

---

3️⃣ MCP 서버 삭제 시 절대 놓치면 안 되는 것

삭제는 더 조심해야 합니다.


단순히 서버만 지우면 끝일 것 같지만 실제로는 캐시와 세션이 남는 경우가 많습니다.


그래서 순서는 이렇습니다.

• ① Claude Code 종료
• ② mcp.json에서 서버 항목 제거
• ③ 관련 프로세스 종료
• ④ 재실행

이 과정을 건너뛰면 “없는 서버를 계속 호출하는 이상한 현상”이 생깁니다.

---

4️⃣ Claude Code 고급 설정 핵심만 요약

고급 설정에서 가장 중요한 건 세 가지입니다.


컨텍스트 길이, 자동 도구 호출, MCP 우선순위입니다.


특히 MCP 우선순위를 잘못 잡으면 로컬 정보보다 모델 추측을 먼저 써서 엉뚱한 코드가 나올 수 있습니다.

---

5️⃣ 실전에서 다들 겪는 문제와 해결 팁

가장 흔한 실수는 이것입니다.


“잘 모르겠는데 일단 다 켜두자.”


하지만 MCP는 필요한 서버만 붙일수록 Claude가 더 똑똑해집니다.


적을수록 정확해지고, 명확할수록 사고를 덜 칩니다.

---

🔗 꼭 필요한 공식 홈페이지

MCP 공식 문서 바로가기

Claude Code 공식 페이지

---

이 글은 단순 설정 설명이 아니라 “왜 이렇게 해야 덜 고생하는지”를 기준으로 썼습니다.


MCP와 Claude Code는 잘 쓰면 동료가 되고, 대충 쓰면 사고 원인이 됩니다.


지금 이 글을 저장해두면 언젠가 분명히 다시 찾게 될 겁니다.