claude code 추천 mcp: 실제 빌드에 먼저 붙일 서버 6개와 선택 기준

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 셋업은 한 번에 완성하는 작업이 아니라, 내가 만드는 제품의 병목에 맞춰 확장하는 도구함에 가깝습니다.

관련 링크

글쓴이 용기

AI 코딩 에이전트로 직접 빌드하는 개발자. Claude Code·Codex 실사용 후기와 빌더 일지를 씁니다.

지식창고