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→ 차단 리스트
👉 기업 환경에서는:
- 허용/차단 리스트로 보안 제어 가능
🔥 최종 한 줄 정리
👉 글로벌 = 내 기본 툴셋 / 프로젝트 = 팀과 공유하는 프로젝트 전용 툴셋
