Claude Code MCP Server Guide
🔌 Claude Code 필수 MCP 서버 가이드
2026년 최신 — 설치부터 API 토큰 발급까지 완벽 정리
🤖 MCP(Model Context Protocol)란?
MCP는 Anthropic이 개발한 오픈 표준으로, AI 모델(Claude)과 외부 도구·데이터 소스 간의 통신을 표준화하는 프로토콜입니다. USB 포트처럼 범용 어댑터 역할을 하여, Claude Code가 GitHub, 데이터베이스, 파일 시스템, 웹 브라우저 등과 실시간으로 상호작용할 수 있게 해줍니다. MCP 서버를 연결하면 Claude Code는 단순 코드 생성기에서 완전한 자동화·생산성 엔진으로 진화합니다.
터미널 입력
MCP Host
도구/API 연결
GitHub, DB 등
🏆 Tier 1 — 거의 필수급
1. GitHub MCP Server
공식 서버Claude Code를 종합 개발 플랫폼으로 변환시켜주는 핵심 MCP. 리포지토리 읽기, 이슈 관리, PR 생성/리뷰, CI/CD 워크플로우 트리거, 커밋 분석까지 터미널에서 모든 것을 처리할 수 있습니다. 2026년 현재 가장 널리 사용되는 MCP 서버 중 하나로, Claude Desktop, Cursor, VS Code 등 다양한 AI 개발 도구에서 지원됩니다.
claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp add github -- docker run -i --rm \ -e GITHUB_PERSONAL_ACCESS_TOKEN \ ghcr.io/github/github-mcp-server
🔑 GitHub Personal Access Token (PAT) 발급 방법 — 무료
export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_xxxxxxxxxxxx"
2. Filesystem MCP Server
공식 서버로컬 머신의 파일을 읽고, 생성, 편집, 정리할 수 있는 제어된 접근 권한을 제공합니다. 접근 가능한 디렉토리를 명시적으로 지정하여 보안을 유지하면서도 강력한 파일 관리 기능을 활성화합니다. 대규모 코드베이스 리팩토링, 로그 파일 분석, 프로젝트 파일 정리 등 모든 로컬 파일 작업의 기본이 되는 서버입니다.
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/Projects
claude mcp add filesystem -s user -- npx -y \ @modelcontextprotocol/server-filesystem \ ~/Projects ~/Documents ~/Desktop
💡 별도 토큰 불필요
Filesystem MCP는 로컬에서 실행되며 별도의 API 키나 토큰이 필요 없습니다. 접근할 디렉토리 경로만 지정하면 됩니다.
3. Sequential Thinking MCP Server
인기 1위Smithery.ai 사용 데이터 기준 가장 인기 있는 MCP 서버(5,550+ uses)입니다. 구조화된 사고 과정을 통한 동적이고 반성적인 문제 해결 도구를 제공하며, 인간의 인지 패턴을 모방한 체계적 추론 프로세스를 도입합니다. 복잡한 아키텍처 결정, 까다로운 디버깅, 대규모 기능 설계 시 Claude를 사려 깊은 개발 파트너로 변환시키는 핵심 도구입니다.
claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
💡 별도 토큰 불필요
로컬에서 실행되며 API 키 없이 바로 사용 가능합니다. 설치 후 복잡한 문제에 대해 자동으로 단계적 사고를 활성화합니다.
🥈 Tier 2 — 생산성 크게 향상
4. Context7 MCP Server
실시간 문서AI 보조 개발에서 가장 답답한 문제인 오래된 라이브러리 문서 문제를 해결합니다. 소스 리포지토리에서 실시간으로 최신 문서를 가져와서, Claude Code가 항상 현재 버전에 맞는 코드 예시와 API 사용 패턴을 제공하도록 보장합니다. React, Next.js, Vue 같은 빠르게 변하는 프레임워크에 특히 유용합니다.
claude mcp add context7 -- npx -y @upstash/context7-mcp
💡 사용법
프롬프트에 "use context7"을 추가하면 최신 문서를 참조합니다. 예: "Create a React Server Component using Next.js 15 patterns - use context7"
5. Playwright MCP Server
Microsoft 공식Microsoft 공식 Playwright MCP 서버로, 구조화된 접근성 스냅샷(Accessibility Tree)을 통해 웹 페이지와 상호작용합니다. 스크린샷 기반이 아닌 시맨틱 접근 방식으로 웹 자동화가 더 안정적이고 빠릅니다. 웹 앱 E2E 테스트 자동화, 폼 작성, 데이터 추출 등에 핵심적입니다.
claude mcp add playwright -- npx -y @playwright/mcp
💡 별도 토큰 불필요
로컬 브라우저를 제어하므로 API 키가 필요 없습니다. 설치만 하면 "이 페이지의 로그인 폼 테스트해줘" 같은 요청을 바로 처리합니다.
6. Git MCP Server
공식 서버Git 리포지토리를 읽고, 검색하고, 조작하는 도구를 제공하는 공식 레퍼런스 서버입니다. GitHub MCP가 GitHub API(원격)에 초점을 맞추는 반면, Git MCP는 로컬 Git 리포지토리에 대한 직접 접근을 제공합니다. 커밋 히스토리 분석, 브랜치 비교, diff 확인 등에 유용합니다.
claude mcp add git -- npx -y @modelcontextprotocol/server-git
7. Memory MCP Server
공식 서버지식 그래프(Knowledge Graph) 기반의 영속적 메모리 시스템을 제공합니다. 프로젝트 컨텍스트, 코딩 컨벤션, 아키텍처 결정 사항 등을 세션 간에 유지할 수 있어 장기 프로젝트에서 매번 같은 설명을 반복하지 않아도 됩니다. Claude가 프로젝트의 맥락을 기억하는 "두 번째 뇌" 역할을 합니다.
claude mcp add memory -- npx -y @modelcontextprotocol/server-memory
🥉 Tier 3 — 필요에 따라 선택
8. Brave Search MCP Server
API 키 필요개발 중 리서치와 문서 검색을 위한 웹 검색 통합을 제공합니다. Brave의 독자 인덱스(350억+ 웹페이지)를 기반으로 하며 개인정보 보호에 특화되어 있습니다. 2025년 Bing API가 종료되면서 Brave Search API가 사실상 유일한 독립적이고 상업적으로 실행 가능한 글로벌 검색 API 옵션이 되었습니다.
claude mcp add brave-search -- npx -y @modelcontextprotocol/server-brave-search
export BRAVE_API_KEY="BSA_xxxxxxxxxxxx"
🔑 Brave Search API 키 발급 방법 — 무료 (월 2,000회)
9. PostgreSQL MCP Server
공식 서버Claude가 PostgreSQL 데이터베이스를 직접 쿼리하고, 데이터 구조를 분석하고, SQL 문을 생성하고, 쿼리 성능을 최적화할 수 있게 해줍니다. 자연어로 "지난달 가입한 사용자 수 알려줘" 같은 요청을 바로 SQL로 변환하여 실행합니다.
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres \ postgresql://user:password@localhost:5432/mydb
⚠️ 보안 주의
프로덕션 DB가 아닌 개발/테스트 DB에 연결하는 것을 권장합니다. 읽기 전용 사용자 계정을 사용하면 더욱 안전합니다.
10. SQLite MCP Server
공식 서버내장 분석 기능이 포함된 SQLite 데이터베이스 작업을 지원합니다. PostgreSQL보다 가볍고 설정이 간단해서, 로컬 프로젝트나 프로토타입 단계에서 빠르게 데이터베이스를 활용할 수 있습니다.
claude mcp add sqlite -- npx -y @modelcontextprotocol/server-sqlite
11. Fetch MCP Server
공식 서버웹 콘텐츠를 가져와서 LLM이 효율적으로 사용할 수 있는 형태로 변환해주는 서버입니다. HTML을 Markdown으로 변환하거나 특정 웹페이지의 내용을 Claude에게 전달할 때 유용합니다.
claude mcp add fetch -- npx -y @modelcontextprotocol/server-fetch
12. Puppeteer MCP Server
공식 서버웹 스크래핑과 브라우저 상호작용을 위한 자동화 서버입니다. Playwright와 유사하지만 Puppeteer 기반으로, 스크린샷 캡처, PDF 생성, 동적 페이지 렌더링 등에 특화되어 있습니다. 기존에 Puppeteer를 사용하던 프로젝트에 자연스럽게 통합됩니다.
claude mcp add puppeteer -- npx -y @modelcontextprotocol/server-puppeteer
⭐ Bonus — 2026년 주목할 MCP 서버
Figma MCP Server (Dev Mode)
디자인→코드Figma의 공식 Dev Mode MCP 서버로, 디자인 레이어의 실제 구조(계층, 오토 레이아웃, 변형, 텍스트 스타일, 토큰 참조)를 MCP로 노출합니다. 스크린샷이 아닌 실제 디자인 데이터를 기반으로 코드를 생성할 수 있어, "Design-to-Code"의 꿈을 실현시키는 도구입니다.
Docker MCP Server
컨테이너AI 명령으로 컨테이너를 빌드, 실행, 검사할 수 있습니다. Dockerfile 생성, 서비스 디버깅, 재현 가능한 개발 환경 관리에 최적화되어 있으며, 컨테이너화된 워크플로우를 사용하는 개발자에게 강력한 생산성 도구가 됩니다.
📋 개발 유형별 추천 조합
2~3개의 핵심 MCP만 선택하여 설치하는 것을 권장합니다. 너무 많은 MCP 서버는 Claude Code 시작 속도를 저하시킬 수 있습니다.
| 개발 유형 | 추천 MCP 조합 |
|---|---|
| 🌐 웹 풀스택 | GitHub + Context7 + Playwright + PostgreSQL |
| ⚙️ 백엔드/인프라 | GitHub + Filesystem + PostgreSQL + Memory |
| 🧠 복잡한 설계/디버깅 | GitHub + Sequential Thinking + Context7 |
| 🎨 프론트엔드/디자인 | GitHub + Context7 + Playwright + Figma |
| 📊 일반 개발 | GitHub + Filesystem + Sequential Thinking |
🛠️ MCP 서버 관리 명령어
설치된 MCP 서버를 확인하고 관리하는 유용한 명령어들입니다.
claude mcp list
claude mcp remove <server-name>
claude mcp add -s user github -- npx -y @modelcontextprotocol/server-github
claude mcp add --transport stdio \ --env BRAVE_API_KEY=BSA_xxxxx brave-search \ -- npx -y @modelcontextprotocol/server-brave-search
🔒 보안 Best Practices
파일 접근을 최소한으로 제한하세요. 실제로 필요한 디렉토리만 지정하고, API 토큰은 환경변수로 관리하며 코드에 하드코딩하지 마세요. 프로덕션 데이터베이스 대신 개발/테스트 환경을 사용하고, MCP 서버는 신뢰할 수 있는 공식 패키지(@modelcontextprotocol)만 설치하는 것이 안전합니다. 정기적으로 토큰을 교체(3~6개월)하고, 사용하지 않는 MCP 서버는 제거하세요.
⚡ 성능 최적화 팁
MCP 서버는 Claude Code 시작 시 로드되므로, 실제로 자주 사용하는 2~3개만 설치하는 것이 최적입니다. 설정 파일(claude_desktop_config.json)에 오타가 없는지 항상 확인하고, 간단한 프롬프트로 각 서버가 정상 작동하는지 먼저 테스트하세요. MCP 생태계는 빠르게 진화하고 있으므로, GitHub에서 새로운 릴리스를 주기적으로 확인하는 것을 추천합니다.
📌 API/토큰 요약 Quick Reference
| MCP 서버 | 토큰/키 필요 | 무료 여부 |
|---|---|---|
| GitHub | ✅ PAT 필요 | 무료 |
| Filesystem | ❌ 불필요 | 무료 |
| Sequential Thinking | ❌ 불필요 | 무료 |
| Context7 | ❌ 불필요 | 무료 |
| Playwright | ❌ 불필요 | 무료 |
| Git | ❌ 불필요 | 무료 |
| Memory | ❌ 불필요 | 무료 |
| Brave Search | ✅ API 키 필요 | 무료 (2,000회/월) |
| PostgreSQL | ✅ DB 접속정보 | 무료 (로컬 DB) |
| SQLite | ❌ 불필요 | 무료 |
| Fetch | ❌ 불필요 | 무료 |
| Puppeteer | ❌ 불필요 | 무료 |
댓글
댓글 쓰기