MCP 서버란? Claude Code에 손발을 달아주는 법
Claude Code에게 "Next.js 최신 라우팅 알려줘"라고 했더니, 작년 어딘가에서 멈춘 지식으로 답한다. 검색을 못 하니까. 내 깃허브 이슈도 못 읽고, 옆 폴더의 파일도 못 연다. 똑똑한 두뇌인데 손발이 없는 상태. 그 손발을 달아주는 게 바로 MCP 서버다.
"MCP"라는 세 글자만 보면 또 무슨 개발자 전문 용어인가 싶다. 하지만 막상 연결하는 데 필요한 건 명령어 한 줄이다. 코드를 한 줄도 짤 줄 몰라도 따라 할 수 있다. 이 글은 그 한 줄까지 가는 길을 정리한다.
MCP가 뭐길래 — Claude Code에 'USB 포트'를 다는 일
MCP는 Model Context Protocol(모델 컨텍스트 프로토콜)의 약자다. Anthropic이 2024년 11월에 공개한 개방형 표준이고, AI 모델을 바깥 세상의 도구·데이터와 연결하는 공통 규격이다.
비유가 제일 빠르다. MCP는 AI에게 USB-C 포트를 다는 것이다. 예전엔 도구마다 전용 케이블을 따로 만들어야 했다. 검색용 연결, 깃허브용 연결, 데이터베이스용 연결이 전부 제각각. 표준 포트가 생기자 이야기가 달라졌다. 포트 하나에 무엇을 꽂든 같은 방식으로 작동한다. MCP 서버는 그 포트에 꽂는 주변기기인 셈이다.
왜 이게 중요할까. Claude Code 자체는 추론은 뛰어나지만 기본 상태에선 갇혀 있다. 학습 시점 이후의 정보를 모르고, 내 사설 깃허브 저장소를 들여다볼 수 없고, 로컬 파일에도 손대지 못한다. MCP 서버를 붙이는 순간 그 벽이 사라진다. 검색 MCP를 꽂으면 눈이 생기고, 파일 MCP를 꽂으면 손이 생긴다.
정리하면, MCP는 "AI에 도구를 꽂는 표준 콘센트"이고, 우리가 할 일은 그 콘센트에 쓸모 있는 플러그를 골라 꽂는 것뿐이다. 표준 명세는 modelcontextprotocol.io에 공개돼 있다.
연결은 세 단계면 끝난다 — 설치·등록·검증
실제 연결은 길어야 5분이다. 순서는 단순하다. 준비 → 등록 → 검증.
1. 준비 — Node.js 한 번만 깔아두기
대부분의 MCP 서버는 npx로 실행된다. 그래서 Node.js(v20 이상)만 한 번 설치해 두면 된다. 종류는 두 가지다. 내 컴퓨터에서 직접 돌리는 로컬(stdio) 방식과, 인터넷 주소만 등록하는 원격(HTTP) 방식. 처음이라면 원격이 더 간단하다.
2. 등록 — 명령어 한 줄
터미널에서 claude mcp add를 한 번 실행하면 끝난다. 형태는 이렇다.
# 원격(HTTP) MCP 등록 — URL만 있으면 된다
claude mcp add --transport http --scope user 이름 https://...
# 로컬(stdio) MCP 등록 — 내 컴퓨터에서 직접 실행
claude mcp add 이름 -- npx -y 패키지명 [옵션]--scope 옵션이 "어디까지 쓸지"를 정한다. user면 내 모든 프로젝트에서, 생략하면 지금 이 프로젝트에서만, project면 팀과 공유된다. 잘 모르겠으면 --scope user로 시작하면 무난하다.
3. 검증 — 진짜 꽂혔는지 확인
Claude Code를 켠 상태에서 /mcp라고 입력해 보자. 연결된 서버와, 그 서버가 제공하는 도구 목록이 뜬다. 목록이 보이면 성공이다. 안 보이면 명령어 오타나 API 키를 다시 본다. 이게 전부다.
바이브코딩에 바로 꽂는 MCP 세 개
수천 개 중 뭘 먼저 깔지 고민할 필요는 없다. 바이브코딩에서 체감이 가장 큰 세 개부터 시작하면 된다. 검색·코드·파일, 즉 눈과 기억과 손이다.
① Tavily — Claude에게 '눈'을 주는 검색
가장 답답한 순간은 최신 정보를 물었을 때 옛날 지식으로 답할 때다. Tavily MCP를 꽂으면 Claude가 실시간으로 웹을 검색한다(search·extract·map·crawl 네 가지 도구). 원격으로 등록하는 게 제일 빠르다.
claude mcp add --transport http --scope user tavily \
"https://mcp.tavily.com/mcp/?tavilyApiKey=발급받은키"무료 키 발급 후 이 한 줄이면, "이 라이브러리 최신 버전 사용법" 같은 질문에 실제 검색 결과로 답한다.
② GitHub — 내 코드를 읽는 기억
깃허브 공식 MCP 서버는 내 저장소의 이슈·PR·코드를 Claude가 직접 읽게 해준다. "이 버그 관련 이슈 찾아서 고쳐줘" 같은 지시가 가능해진다.
claude mcp add --transport http github \
https://api.githubcopilot.com/mcp/③ Filesystem — 파일을 만지는 손
Filesystem MCP는 지정한 폴더의 파일을 읽고 쓰게 해준다(read_file·write_file·list_directory). 핵심은 "지정한 폴더"라는 점이다. 아래처럼 작업 폴더만 열어준다.
claude mcp add filesystem -- \
npx -y @modelcontextprotocol/server-filesystem ~/projects| MCP | 역할 | 연결 방식 |
|---|---|---|
| Tavily | 실시간 웹 검색(눈) | 원격 HTTP + API 키 |
| GitHub | 내 저장소 코드·이슈 조회(기억) | 원격 HTTP |
| Filesystem | 지정 폴더 읽기·쓰기(손) | 로컬 npx |
손발을 달기 전에: 권한이라는 청구서
여기서 한 번 멈추자. 손발이 편한 만큼, 그 손이 내 파일을 지우거나 API 키를 흘릴 수도 있다. MCP를 무작정 많이 꽂는 게 능사가 아니라는 얘기다.
다행히 안전장치는 있다. Filesystem MCP는 쓰기·삭제 같은 작업마다 사용자에게 명시적 승인을 요구한다. 좋은 기본값이다. 다만 폴더를 넓게 열지 말 것. 홈 디렉터리 전체가 아니라 작업 폴더 하나만 지정하는 습관이 안전을 절반 이상 책임진다.
원격이냐 로컬이냐도 따져볼 문제다. 원격(HTTP) MCP는 URL만 등록하니 간편하지만, 그만큼 외부 서버로 데이터가 흐른다 — API 키를 포함해서. 로컬(stdio) MCP는 내 컴퓨터에서만 도니 통제하기 좋은 대신 설치 수고가 든다. 정답은 용도마다 다르지만, 원칙은 하나다. 출처가 분명한 공식 서버부터. 출처 불명의 MCP에 파일 쓰기 권한을 주는 건, 모르는 사람에게 집 열쇠를 맡기는 것과 같다.
직접 만들 수도 있다 (맛보기)
MCP가 표준이라는 건, 남이 만든 걸 꽂기만 하는 게 아니라 내가 직접 서버를 만들 수도 있다는 뜻이다. 파이썬이나 타입스크립트 SDK로 함수 몇 개를 "도구"로 노출하면, 사내 API나 회사 데이터베이스도 Claude에 꽂을 수 있다. 다만 첫술에 배부르랴. 직접 만들기는 나중 일이고, 우선은 잘 만들어진 공식 MCP 세 개를 손에 익히는 것으로 충분하다.
결론 — 두뇌만으로는 일을 못 한다
Claude Code가 답답하게 느껴졌다면, 모델이 부족해서가 아니라 손발이 없어서였을 가능성이 크다. 검색 MCP 하나만 꽂아봐도 체감이 다르다. 어제까지 "모르겠습니다"라던 도구가, 오늘은 직접 찾아보고 답한다.
그러니 질문을 하나 남겨두자. 지금 당신이 Claude에게 가장 자주 막혔던 지점은 어디였나. 검색이었나, 내 코드였나, 파일이었나. 그 자리에 꽂을 포트가 이미 표준으로 열려 있다. 주나이테크 블로그에 바이브코딩 실전 글이 더 있으니, 한 줄씩 따라 꽂아보면 된다.