1.2 MCP 서버 종류와 설정
MCP 생태계에는 공식 서버부터 커뮤니티 서버까지 수백 개의 서버가 존재하며, Claude Code에서
claude mcp add명령으로 즉시 연결할 수 있다. 업데이트: 2026-03-08
핵심 요약
| 구분 | 내용 |
|---|---|
| 📖 정의 | MCP 서버는 AI가 접근할 수 있는 도구(Tools)·리소스(Resources)·프롬프트(Prompts)를 제공하는 독립 프로세스 |
| 💡 핵심 | 한 번 설정한 MCP 서버는 Claude Desktop, Claude Code, Cursor 등 모든 MCP 호환 클라이언트에서 재사용된다 |
| 🎯 대상 | Claude Code의 기능을 외부 데이터와 도구로 확장하려는 개발자 |
| ⚠️ 주의 | 서버 실행에는 Node.js 또는 Python 런타임이 필요하며, 민감한 API 키는 환경변수로 관리해야 한다 |
문서 탐색
목차
1. MCP 서버 유형 분류
MCP 서버는 실행 방식에 따라 두 가지로 나뉜다.
| 유형 | 전송 방식 | 특징 | 용도 |
|---|---|---|---|
| 로컬 서버 | stdio | 로컬 프로세스로 실행, 낮은 레이턴시 | 파일 시스템, 로컬 DB, CLI 도구 |
| 원격 서버 | Streamable HTTP | 클라우드 배포, 여러 클라이언트 공유 가능 | SaaS API, 팀 공유 서버 |
2. 서비스 제공사 직접 운영 HTTP 서버
주요 SaaS 서비스들이 자체 MCP 서버를 호스팅하여 제공한다. URL만 있으면 즉시 연결할 수 있고, 별도 런타임 설치가 필요 없다.
| 서비스 | 설정 명령 |
|---|---|
| GitHub | claude mcp add --transport http github https://api.githubcopilot.com/mcp/ |
| Sentry | claude mcp add --transport http sentry https://mcp.sentry.dev/mcp |
| Notion | claude mcp add --transport http notion https://mcp.notion.com/mcp |
| Stripe | claude mcp add --transport http stripe https://mcp.stripe.com |
| HubSpot | claude mcp add --transport http hubspot https://mcp.hubspot.com/anthropic |
| PayPal | claude mcp add --transport http paypal https://mcp.paypal.com/mcp |
| Asana | claude mcp add --transport sse asana https://mcp.asana.com/sse |
💡 HTTP 방식은 OAuth 인증을 사용한다. 서버 추가 후 Claude Code 내에서
/mcp를 입력하면 브라우저 인증 플로우가 시작된다.
3. NPM 패키지 기반 로컬 서버 (stdio)
Anthropic과 커뮤니티가 NPM으로 배포하는 로컬 서버들이다. Node.js 설치가 필요하다.
Anthropic 공식 (stdio)
| 패키지 | 주요 기능 |
|---|---|
@modelcontextprotocol/server-filesystem | 로컬 파일 시스템 읽기·쓰기·탐색 |
@modelcontextprotocol/server-sqlite | SQLite 데이터베이스 쿼리·수정 |
@modelcontextprotocol/server-postgres | PostgreSQL 연동 |
@modelcontextprotocol/server-memory | 대화 간 영구 메모리 저장 |
@modelcontextprotocol/server-git | 로컬 Git 저장소 읽기·조작 |
@modelcontextprotocol/server-fetch | URL 웹 콘텐츠 가져오기 |
@modelcontextprotocol/server-brave-search | Brave Search API 웹 검색 |
@modelcontextprotocol/server-slack | Slack 채널 읽기·메시지 전송 |
커뮤니티 인기 서버 (stdio)
| 패키지 | 기능 |
|---|---|
@playwright/mcp | Playwright 브라우저 자동화 |
airtable-mcp-server | Airtable 스프레드시트 DB |
@bytebase/dbhub | PostgreSQL·MySQL·다중 DB 지원 |
mcp-server-docker | Docker 컨테이너 관리 |
mcp-server-kubernetes | Kubernetes 클러스터 제어 |
mcp-server-linear | Linear 이슈 관리 |
gemini-cli-orchestrator | Gemini CLI를 MCP 서버로 등록 |
서버 탐색 커뮤니티
- github.com/punkpeye/awesome-mcp-servers — 큐레이션 목록 (66,000+ stars)
- glama.ai/mcp/servers — 검색 가능한 마켓플레이스
- github.com/modelcontextprotocol/servers — Anthropic 공식 서버 모음
4. Claude Code에서 MCP 서버 설정하기
4.1 기본 명령어
# 원격 HTTP 서버 추가
claude mcp add --transport http <서버명> <URL>
# 로컬 stdio 서버 추가
claude mcp add --transport stdio <서버명> -- <명령어> [인수...]
# 서버 목록 확인
claude mcp list
# 특정 서버 상세 정보
claude mcp get <서버명>
# 서버 제거
claude mcp remove <서버명>
# Claude Code 내에서 서버 상태 확인 · OAuth 인증
/mcp4.2 실전 예시: 파일 시스템 서버 (stdio)
# 단일 디렉토리
claude mcp add --transport stdio filesystem \
-- npx -y @modelcontextprotocol/server-filesystem /Users/me/projects
# 여러 디렉토리 허용 (보안상 필요한 경로만)
claude mcp add --transport stdio filesystem \
-- npx -y @modelcontextprotocol/server-filesystem /Users/me/project-a /Users/me/project-b⚠️ Windows 주의: 로컬 stdio 서버는
cmd /c래퍼가 필요하다.claude mcp add --transport stdio filesystem -- cmd /c npx -y @modelcontextprotocol/server-filesystem C:\projects
4.3 실전 예시: GitHub (HTTP + OAuth)
# GitHub Copilot 공식 MCP 서버 등록
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
# 등록 후 인증
# Claude Code 내에서 /mcp 입력 → 브라우저 GitHub OAuth 플로우 시작4.4 실전 예시: PostgreSQL (stdio)
# DBHub 사용 (다중 DB 지원, 권장)
claude mcp add --transport stdio db \
-- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly_user:pass@localhost:5432/mydb"4.5 등록 범위(Scope) 설정
| Scope | 저장 위치 | 적용 범위 |
|---|---|---|
local (기본) | ~/.claude.json | 현재 프로젝트, 본인만 사용 |
project | .mcp.json (프로젝트 루트) | 팀 공유 가능, git 커밋 |
user | ~/.claude.json | 모든 프로젝트에서 본인 사용 |
# 팀 공유 (project scope) — .mcp.json에 저장되어 git으로 공유됨
claude mcp add --transport http sentry --scope project https://mcp.sentry.dev/mcp
# 개인 전체 적용 (user scope)
claude mcp add --transport stdio filesystem --scope user \
-- npx -y @modelcontextprotocol/server-filesystem /Users/me4.6 MCP Tool Search (컨텍스트 최적화)
MCP 서버가 많아 도구 목록이 컨텍스트 창의 10%를 초과하면 자동으로 lazy loading이 활성화된다.
ENABLE_TOOL_SEARCH=auto:5 claude # 5% 임계값으로 조정
ENABLE_TOOL_SEARCH=false claude # 비활성화 (모든 도구 사전 로드)- 컨텍스트 사용량 최대 95% 절감 가능
- Sonnet 4+, Opus 4+ 모델에서 지원 (Haiku 미지원)
5. 설정 파일 직접 편집
Claude Code의 MCP 설정은 settings.json에 저장된다. 직접 편집도 가능하다.
.claude/settings.json 예시
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"],
"env": {}
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"],
"env": {}
}
}
}원격 서버 설정 예시
{
"mcpServers": {
"remote-tool": {
"type": "http",
"url": "https://api.example.com/mcp",
"headers": {
"Authorization": "Bearer ${API_TOKEN}"
}
}
}
}🔒 보안 주의: API 키는 직접 문자열로 넣지 않고,
${ENV_VAR_NAME}형식으로 환경변수를 참조한다. 또는-e플래그로 주입한다.
문서 탐색
참고 자료
- Claude Code MCP 공식 설정 가이드
- MCP 공식 서버 저장소 (GitHub)
- Anthropic MCP 공식 문서
- awesome-mcp-servers (커뮤니티 큐레이션)
- glama.ai/mcp/servers (검색 마켓플레이스)