
claude code 추천 mcp를 찾는다면 결론은 간단합니다. 처음부터 많이 붙이지 말고 filesystem, GitHub, Playwright, Postgres 또는 Supabase, Context7, fetch 정도만 먼저 연결해도 실제 개발 속도가 확 달라집니다.
내 프로젝트에 맞는 MCP를 2~3개만 고르고, 먼저 읽기 권한으로 연결해 테스트해보세요.
특히 Claude Code를 터미널에서 쓰는 사람은 MCP를 붙였을 때 차이가 큽니다. 단순 코드 생성이 아니라 파일을 읽고, 이슈를 확인하고, 브라우저에서 동작을 검증하고, DB 스키마까지 참고하는 흐름으로 바뀌기 때문입니다.
아래 표에서 내 프로젝트에 필요한 2~3개만 고른 뒤 Claude Code 설정에 순서대로 추가해보세요.
먼저 붙이면 좋은 MCP 서버 조합
MCP는 Claude가 외부 도구와 안전하게 대화하게 해주는 연결 규격입니다. Claude Code에서는 이 연결 덕분에 에이전트가 로컬 프로젝트, GitHub, 브라우저, 문서, 데이터베이스를 더 정확히 다룰 수 있습니다.
다만 MCP 서버를 많이 붙인다고 항상 좋아지는 것은 아닙니다. 컨텍스트가 복잡해지고, 권한 범위가 넓어지며, 잘못된 도구 호출로 시간이 늘어날 수 있습니다. 그래서 목적별로 작게 시작하는 편이 낫습니다.
| MCP 서버 | 좋은 용도 | 우선순위 | 주의할 점 |
|---|---|---|---|
| filesystem | 로컬 파일 읽기, 수정, 프로젝트 구조 파악 | 매우 높음 | 허용 디렉터리를 프로젝트 폴더로 제한 |
| GitHub | PR, 이슈, 레포 상태 확인 | 높음 | 토큰 권한을 최소화 |
| Playwright | 브라우저 테스트, UI 동작 확인 | 높음 | 테스트 시간이 길어질 수 있음 |
| Postgres / Supabase | 스키마 확인, 쿼리 점검, 데이터 기반 디버깅 | 중간~높음 | 쓰기 권한은 신중히 제한 |
| Context7 | 최신 라이브러리 문서 참고 | 중간 | 지원 문서 범위를 확인 |
| fetch | API 응답 확인, 문서 URL 읽기 | 중간 | 민감 URL 호출 주의 |
1. filesystem은 거의 필수에 가깝다
Claude Code의 강점은 코드베이스 안에서 작업 흐름을 이어가는 데 있습니다. filesystem MCP를 붙이면 에이전트가 파일 구조를 더 명확히 보고, 필요한 파일을 찾아 수정하는 흐름이 자연스러워집니다.
권장 설정은 전체 홈 디렉터리를 열지 않는 것입니다. 예를 들어 ~/projects/my-saas처럼 현재 작업 중인 레포만 허용하면 실수와 보안 리스크를 줄일 수 있습니다.
2. GitHub MCP는 협업 프로젝트에서 체감이 크다
혼자 만드는 토이 프로젝트라면 GitHub 연결이 당장 필수는 아닐 수 있습니다. 하지만 이슈 기반으로 개발하거나 PR 리뷰를 자주 한다면 GitHub MCP는 우선순위가 높습니다.
예를 들어 에이전트에게 “열려 있는 버그 이슈를 읽고 재현 가능한 순서로 정리한 뒤 수정 브랜치 계획을 세워줘”라고 요청할 수 있습니다. 여기서 중요한 점은 토큰 권한입니다. 처음에는 읽기 권한 위주로 시작하고, 쓰기 권한은 필요할 때만 추가하는 편이 안전합니다.
3. Playwright MCP는 ‘진짜 돌아가나?’를 확인할 때 유용하다
코드를 생성한 뒤 가장 많이 막히는 지점은 화면에서 실제로 동작하지 않는 경우입니다. Playwright MCP를 연결하면 Claude가 브라우저를 열고 버튼 클릭, 폼 입력, 라우팅 확인 같은 작업을 수행할 수 있습니다.
Next.js, React, Vue 기반 관리자 페이지를 만들 때 특히 좋습니다. 단, 모든 작업을 브라우저 테스트로 돌리면 느려질 수 있으니 로그인, 결제 전 단계, 핵심 폼 제출처럼 중요한 플로우에만 쓰는 것을 권합니다.
예시: 작은 SaaS 관리자 페이지를 만든다면
가상의 예로, Airtable 대신 Supabase를 백엔드로 쓰는 내부 예약 관리 페이지를 만든다고 해보겠습니다. 이 경우 추천 조합은 filesystem + Supabase 또는 Postgres + Playwright + Context7입니다.
Claude Code에게 먼저 프로젝트 구조를 읽게 하고, Supabase 테이블 구조를 확인하게 한 뒤, 예약 생성 폼을 구현하게 합니다. 마지막으로 Playwright로 “예약 생성 → 목록 반영 → 상세 페이지 이동”까지 확인시키면 단순 코드 생성보다 실패 지점을 훨씬 빨리 찾을 수 있습니다. 실제 결과는 코드베이스 상태와 권한 설정에 따라 달라질 수 있습니다.
누구에게 어떤 조합을 추천하나
개인 개발자와 바이브 코딩 입문자
처음에는 filesystem과 Context7만으로 충분합니다. 로컬 파일을 안전하게 읽고, React, Tailwind CSS, Next.js 같은 문서를 최신 방식으로 참고하게 만드는 쪽이 효과적입니다.
팀 프로젝트나 오픈소스 유지보수자
GitHub MCP를 추가하세요. 이슈, PR, 릴리스 노트를 함께 보면서 작업하면 “무엇을 고쳐야 하는지”를 에이전트가 더 잘 이해합니다. Slack이나 Linear까지 연결하고 싶을 수 있지만, 처음부터 협업 도구를 과하게 붙이면 알림과 문맥이 섞일 수 있습니다.
DB가 중요한 SaaS 빌더
Postgres, Supabase MCP가 잘 맞습니다. 다만 운영 DB에 바로 연결하지 말고 개발 DB나 읽기 전용 계정부터 쓰세요. AI 에이전트에게 데이터 쓰기 권한을 주는 순간부터는 백업과 롤백 계획이 필요합니다.
많이 하는 실수: MCP를 플러그인처럼 잔뜩 설치하는 것
가장 흔한 실수는 “유명한 MCP 서버 목록”을 그대로 다 넣는 것입니다. 그러면 Claude가 어떤 도구를 언제 써야 할지 헷갈리거나, 불필요한 호출로 작업 시간이 늘어납니다.
좋은 기준은 간단합니다. 지금 만드는 기능을 끝내는 데 필요한 외부 세계만 열어주는 것입니다. 파일 수정이 목표면 filesystem, 화면 검증이 목표면 Playwright, 스키마 확인이 목표면 DB 연결처럼 좁게 고르세요.
FAQ
Claude Code에서 MCP는 꼭 필요한가요?
필수는 아닙니다. 단일 파일 수정이나 간단한 질문은 없어도 됩니다. 하지만 여러 파일을 오가며 기능을 만들거나 테스트까지 맡기려면 MCP가 작업 품질을 끌어올립니다.
무료로 쓸 수 있는 MCP도 있나요?
filesystem, fetch, Playwright처럼 오픈소스 기반으로 사용할 수 있는 서버가 많습니다. 다만 GitHub, Supabase, 데이터베이스 연결은 각 서비스 계정과 API 권한 정책을 따릅니다.
가장 먼저 설치할 하나만 고르면요?
로컬 개발 기준이라면 filesystem입니다. 그다음 웹앱이라면 Playwright, 협업 레포라면 GitHub, 데이터 중심 앱이라면 Postgres나 Supabase를 붙이면 됩니다.
바로 할 다음 행동
오늘 바로 시도한다면 30분만 잡고 현재 프로젝트에 filesystem 하나를 먼저 붙여보세요. 그다음 Claude Code에게 “프로젝트 구조를 읽고, 위험한 변경 없이 개선 가능한 작업 3개를 제안해줘”라고 요청하면 연결이 제대로 되었는지 빠르게 확인할 수 있습니다.
그 결과가 괜찮다면 Playwright나 GitHub를 하나씩 더하세요. MCP 셋업은 한 번에 완성하는 작업이 아니라, 내가 만드는 제품의 병목에 맞춰 확장하는 도구함에 가깝습니다.
관련 링크
- 관련 태그 더 보기
- 카테고리 더 보기
- 검색 결과 더 보기
- 참고 링크
