https://studysprintnote.tistory.com/entry/Claude-Code에서-MCP-서버-설정하는-법-글로벌-vs-프로젝트별-정리

 

ChatGPT 요약

📌 핵심 요약: Claude Code MCP 서버 설정 (글로벌 vs 프로젝트)

1️⃣ MCP 서버란?

• MCP (Model Context Protocol) = Claude가 외부 도구/데이터/API와 연결하는 방식
• 예: GitHub, DB, 파일시스템, 브라우저 자동화 등

👉 즉,
“Claude 능력을 확장하는 플러그인 시스템”

---

2️⃣ 설정 방식 2가지

🌍 글로벌(Global) 설정

• 위치: ~/.claude/ 또는 사용자 설정 파일
• 특징:
  • 모든 프로젝트에 공통 적용
  • 한 번 설정하면 계속 사용 가능
• 용도:
  • GitHub, Notion, Slack 같은 항상 쓰는 도구

👉 한마디
“내 기본 장비 세팅”

---

📁 프로젝트(Project) 설정

• 위치: 프로젝트 내부 .mcp.json
• 특징:
  • 해당 프로젝트에서만 적용
  • 팀과 공유 가능 (Git commit 가능)
• 용도:
  • 특정 프로젝트에 필요한 도구
  • 팀 협업 환경

👉 한마디
“이 프로젝트 전용 도구 세트”

📌 실제 구조:

• 글로벌 → ~/.claude.json
• 프로젝트 → .mcp.json

---

3️⃣ 핵심 차이 (중요)

구분	글로벌	프로젝트
적용 범위	전체 프로젝트	특정 프로젝트
설정 위치	사용자 홈	프로젝트 폴더
공유	❌ 개인	✅ 팀 공유
용도	공통 도구	프로젝트 특화
관리 난이도	낮음	팀 관리 필요

---

4️⃣ 언제 어떤 걸 써야 하나?

✔️ 글로벌 써야 할 때

• 항상 쓰는 도구
• 개인 생산성 도구
• 반복적으로 필요한 MCP

👉 예:

• GitHub MCP
• Notion MCP

---

✔️ 프로젝트 써야 할 때

• 프로젝트마다 다른 환경
• 팀 전체가 동일하게 써야 할 때
• 특정 DB / API 연결

👉 예:

• 특정 DB 서버
• 프로젝트 전용 API
• 테스트 도구

---

5️⃣ 핵심 인사이트 (이 글의 포인트)

👉 가장 중요한 한 줄

“글로벌은 개인 최적화, 프로젝트는 팀 표준화”

---

6️⃣ 추가 중요한 설정 옵션

MCP 관련 주요 옵션들:

• enableAllProjectMcpServers → 모든 프로젝트 서버 자동 승인
• enabledMcpjsonServers → 허용 리스트
• disabledMcpjsonServers → 차단 리스트

👉 기업 환경에서는:

• 허용/차단 리스트로 보안 제어 가능

---

🔥 최종 한 줄 정리

👉 글로벌 = 내 기본 툴셋 / 프로젝트 = 팀과 공유하는 프로젝트 전용 툴셋