MCP란 무엇인가 — Claude Code에 외부 도구 연결하기
MCP(Model Context Protocol)의 개념과, Claude Code에 외부 도구를 연결하는 방법을 단계별로 설명합니다.
앞 편까지 Claude Code를 설치하고, CLAUDE.md로 맥락을 주고, 첫 화면까지 만들어봤습니다. 여기까지 AI는 “내 프로젝트 파일” 안에서만 일합니다. 이번 편에서는 그 범위를 넓혀, AI가 외부 도구까지 다룰 수 있게 해주는 MCP(Model Context Protocol)를 소개합니다.
처음 들어보는 개념이어도 걱정하지 않아도 됩니다. 설정은 터미널에서 명령어 한 줄이면 끝납니다.
MCP란 무엇인가
MCP는 AI가 외부 도구를 사용할 수 있게 해주는 표준 방식입니다. 2024년 말 Anthropic이 공개했으며, Claude Code뿐만 아니라 다양한 AI 도구에서 지원합니다.
쉽게 이해하려면 이렇게 생각하면 됩니다. AI와 대화할 때 AI는 기본적으로 대화 내용과 열린 파일 안에서만 정보를 얻습니다. MCP를 연결하면 AI가 외부 서비스(문서 사이트, 브라우저, 데이터베이스, 협업 도구 등)의 정보를 직접 가져오거나 작업을 수행할 수 있게 됩니다.
| 구분 | MCP 없을 때 | MCP 있을 때 |
|---|---|---|
| AI가 알 수 있는 것 | 대화 내용, 열린 파일 | 외부 서비스 데이터까지 포함 |
| 작업 방식 | 코드만 작성 | 외부 서비스 조회·수정 가능 |
| 예시 | ”이 함수 고쳐줘" | "이 라이브러리 최신 문서 찾아서 그대로 적용해줘” |
즉 MCP는 AI에게 손과 눈을 더 달아주는 확장 슬롯이라고 볼 수 있습니다.
어떤 MCP를 붙일 수 있나
MCP 서버는 종류가 다양합니다. 바이브코딩을 막 시작한 단계에서 특히 유용한 대표적인 예시입니다.
| MCP 서버 | 하는 일 |
|---|---|
| Context7 | 라이브러리·프레임워크의 최신 공식 문서를 가져와 정확한 사용법으로 코드 작성 |
| Playwright | 실제 브라우저를 열어 만든 화면을 클릭·입력하며 동작 테스트 |
| Filesystem | 지정한 폴더의 파일을 읽고 쓰기 |
| GitHub | 이슈·PR 조회, 저장소 정보 확인 |
이 외에도 데이터베이스, 디자인 도구, 프로젝트 구조 추적 서비스(Umtri 같은) 등 다양한 MCP가 있습니다. 전부 미리 붙일 필요는 없고, 필요해지는 것부터 하나씩 붙이면 됩니다.
Claude Code에 MCP 연결하기
연결은 터미널에서 claude mcp add 명령으로 합니다. 서버마다 연결 방식(로컬에서 실행 또는 원격 URL 접속)이 조금씩 다른데, 공식 문서나 해당 서비스의 안내에 명령어가 그대로 나와 있습니다.
예를 들어 원격 서버(HTTP 방식)를 붙이는 형태는 이렇습니다. YOUR_TOKEN 부분은 로그인이 필요한 서비스에서 발급받는 토큰입니다.
claude mcp add <이름> \
--transport http \
--url https://example.com/mcp \
--header "Authorization: Bearer YOUR_TOKEN"로컬에서 실행하는 서버라면 이런 형태가 됩니다.
claude mcp add <이름> -- npx -y <서버-패키지>명령을 실행하면 Claude Code가 해당 MCP 서버를 등록하고, 이후 Claude Code를 실행할 때마다 연결이 자동으로 활성화됩니다.
연결 확인
Claude Code를 실행한 뒤 /mcp 를 입력하면 현재 연결된 MCP 서버 목록과 상태를 볼 수 있습니다.
인증 토큰은 안전하게
일부 MCP 서버는 로그인이 필요해 API 토큰을 요구합니다. 이 토큰은 계정에 대한 접근 권한을 가지므로, 코드 파일에 직접 넣으면 GitHub 같은 곳에 공개되는 위험이 있습니다.
토큰은 환경 변수로 관리하는 것이 안전합니다.
# .env 파일을 만들고
echo "SERVICE_TOKEN=your_token_here" > .env
# .gitignore에 추가해서 git에 올라가지 않게 설정
echo ".env" >> .gitignore그리고 MCP 등록 명령에서 토큰 값을 직접 쓰는 대신 환경 변수를 참조하면 됩니다.
MCP는 언제 붙이면 좋을까
처음부터 여러 MCP를 붙일 필요는 없습니다. 기본 개발은 Claude Code와 CLAUDE.md만으로도 충분히 시작할 수 있습니다. “불편이 생겼을 때 그 불편을 없애는 MCP 하나”를 붙이는 식으로 접근하면 됩니다.
- 라이브러리 사용법이 자꾸 틀린다 → Context7로 최신 문서 연결
- 만든 화면을 매번 손으로 확인하기 번거롭다 → Playwright로 브라우저 테스트
- 프로젝트가 커져 구조·이력을 자동으로 추적하고 싶다 → 전용 서비스 MCP 검토
다음 편부터는 다시 개발로 돌아가, 만든 화면 위에 기능을 하나씩 쌓아가는 과정을 다룹니다.