Claude Code MCP 서버 추천 5개와 최소 설정
MCP 서버는 Claude Code에 외부 시스템을 붙이는 통로입니다. 2026년 9월 11일 기준 공식 MCP 문서는 원격 서버를 claude mcp add --transport http <이름> <URL>, 로컬 서버를 claude mcp add <이름> -- <실행 명령>으로 등록한다고 적습니다. --는 Claude의 옵션과 서버 실행 명령을 가르는 표시이고, 문서는 이를 "critical"이라고 표기합니다. 아래 다섯 개는 공식 저장소나 공식 문서를 열어 존재를 확인한 것만 골랐습니다.
MCP·Skills·서브에이전트의 역할 구분은 별도 글에 있습니다. 이 글은 그다음 단계, 곧 무엇을 붙이고 어떤 옵션으로 잠글지만 다룹니다.
먼저 범위를 정합니다
같은 서버라도 어디에 저장되느냐에 따라 공유 범위가 달라집니다. 공식 문서의 표를 옮기면 이렇습니다.
| 범위 | 적용 대상 | 공유 | 저장 위치 |
|---|---|---|---|
local (기본) | 지금 프로젝트만 | 안 됨 | ~/.claude.json |
project | 지금 프로젝트만 | 됨(git) | 프로젝트 루트 .mcp.json |
user | 내 모든 프로젝트 | 안 됨 | ~/.claude.json |
혼자 쓰는 도구는 --scope user, 팀과 같은 설정이 필요하면 --scope project입니다. .mcp.json은 대화형 세션에서 첫 사용 시 승인을 요구합니다.
추천 5개와 최소 설정
1. 파일시스템 — 폴더 하나만 열어 주기
공식 레퍼런스 서버이고 패키지는 @modelcontextprotocol/server-filesystem입니다. 인자로 준 디렉터리 밖으로는 파일 작업이 나가지 못합니다.
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/work/blog-drafts
원고 폴더처럼 범위를 좁힌 경로만 넘기십시오. 홈 디렉터리 전체를 주는 설정은 권하지 않습니다.
2. GitHub — 이슈와 PR을 말로 다루기
github/github-mcp-server가 공식 저장소이고, 원격 서버 주소는 https://api.githubcopilot.com/mcp/입니다. 저장소 문서는 토큰을 만들지 않고 브라우저로 로그인하는 OAuth 방식을 권장합니다.
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
등록 뒤 세션에서 /mcp로 인증합니다. 읽기만 할 목적이면 --read-only, 필요한 도구 묶음만 켜려면 --toolsets 옵션이 있습니다.
3. Notion — 문서를 검색하고 갱신하기
Notion 공식 MCP 문서는 OAuth로 연결을 승인하면 해당 계정이 접근할 수 있는 콘텐츠를 검색·읽기·수정하고 페이지와 데이터베이스를 만들 수 있다고 적습니다. Claude Code 공식 문서의 예시 주소는 다음과 같습니다.
claude mcp add --transport http notion https://mcp.notion.com/mcp
4. Playwright — 만든 페이지를 브라우저로 확인하기
microsoft/playwright-mcp이고 패키지는 @playwright/mcp입니다. 스크린샷 대신 접근성 트리를 읽어서 시각 모델 없이도 화면 구조를 다룹니다.
claude mcp add playwright -- npx @playwright/mcp@latest
5. Supabase — 데이터베이스를 읽기 전용으로 붙이기
Supabase 공식 MCP 문서가 제시하는 Claude Code 명령은 다음과 같습니다.
claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp"
같은 문서는 운영 프로젝트 연결을 피하라고 경고하고, 꼭 필요하면 ?read_only=true(읽기 전용 실행)와 ?project_ref=<id>(프로젝트 한정)를 붙이라고 안내합니다. 처음이라면 연습용 프로젝트에 읽기 전용으로만 붙이는 편이 안전합니다.
컨텍스트와 비용은 어떻게 되나
비용 문서는 확인일 기준 "MCP 도구 정의가 기본적으로 지연 로드되어, 특정 도구를 쓰기 전까지는 도구 이름과 서버 설명만 컨텍스트에 들어간다"고 적습니다. 예전만큼 무거워지지는 않지만 공짜는 아닙니다. 같은 문서는 gh, aws 같은 CLI 도구가 여전히 더 컨텍스트 효율적이라고 덧붙입니다.
결과 크기에도 한도가 있습니다. MCP 문서 기준 경고 임계값은 10,000 토큰, 기본 한도는 25,000 토큰이며 MAX_MCP_OUTPUT_TOKENS로 조정합니다. 한도를 넘는 결과는 파일로 저장되고 대화에는 파일 참조만 남습니다. 쓰지 않는 서버는 /mcp에서 꺼 두십시오. 절약법은 비용 줄이는 7가지와 비용 계산기에 있습니다.
연결 전 점검
공식 문서는 **"연결하기 전에 각 서버를 신뢰할 수 있는지 확인하라"**고 적고, 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션 위험에 노출될 수 있다고 경고합니다. 세 가지만 지키면 사고 대부분을 막습니다.
- 공식 저장소나 공식 문서에서 안내하는 서버만 씁니다.
- 쓰기 권한은 마지막에 엽니다. 읽기 전용 옵션이 있으면 그것부터 씁니다.
- 토큰과 키는 예시 값을 복사해 두지 않습니다.
.mcp.json은${VAR}환경 변수 확장을 지원하므로 값을 파일에 적을 필요가 없습니다.
다음 단계
- 개념 정리는 MCP, Skills, 서브에이전트 차이
- 세션 기본기는 Claude Code 사용법
- 프로젝트 규칙 파일은 CLAUDE.md 작성법
- 토큰 절약은 비용 줄이는 7가지
- 강의는 코스 안내에서 준비 중입니다. 현재 수강 신청과 결제는 열려 있지 않습니다.