Claude Code MCP 완전 입문

MCP 아키텍처 이해와 claude mcp add 실전 활용법

배경 지식

MCP란 무엇인가

MCP(Model Context Protocol)는 AI 어시스턴트가 외부의 툴이나 데이터 소스에 접속하기 위한 표준 프로토콜입니다. 기존에 AI 모델이 외부 서비스와 연계하려면 서비스마다 개별 API 통합이나 플러그인 개발이 필요했습니다. MCP는 이 과제를 해결하여, 통일된 인터페이스로 다양한 외부 서비스로의 접속을 가능하게 합니다.

공식 문서에서는 MCP를 "Claude Code의 능력을 확장하기 위한 구조"로 자리매김하고 있습니다.

※ 한국 개발 환경에서의 MCP 활용 배경
GitHub, Jira, Confluence, Slack, AWS 등 현재 한국 개발 팀이 사용하는 대부분의 서비스가 MCP 서버를 통해 Claude Code와 연계될 수 있습니다. 1장(Skills)에서 배운 자동화 절차에 실제 외부 서비스 데이터를 조합하면, 훨씬 강력한 개발 워크플로우를 구축할 수 있습니다.

MCP의 아키텍처

MCP는 클라이언트·서버 모델로 동작합니다.

왜 MCP가 필요한가

스코프의 이해

MCP 서버를 등록할 때 지정하는 스코프는, 설정이 어느 범위에 적용되는지를 결정합니다.

※ 팀 공유 관점
--scope project로 등록된 MCP 서버 설정은 .mcp.json에 저장됩니다. 이 파일을 Git으로 관리하면 팀 멤버 전원이 git pull만으로 같은 MCP 환경을 사용할 수 있습니다. 1장에서 .claude/skills/를 Git 관리한 것과 같은 접근 방식입니다.

대표적인 유스케이스

파일 시스템 접속: 로컬 파일의 읽기·쓰기·검색을 MCP 경유로 실행

GitHub 연계: 리포지토리 조작, Issue 관리, PR 작성을 Claude Code에서 직접 실행

데이터베이스 접속: SQLite나 PostgreSQL로의 쿼리 실행

API 연계: REST API나 GraphQL API로의 접속

개발 툴 통합: ESLint, Jest 등 린터·테스트 러너의 통합

협업 툴 연계: Slack, Jira, Confluence, Notion 등과의 연결

"외부 서비스 통합 워크스페이스"의 전체 구조

2부 전 9회를 통해, 다음의 통합 워크스페이스를 단계적으로 구축합니다.

외부 서비스 통합 워크스페이스

├── filesystem MCP ← 2부 1장에서 접속

├── GitHub MCP ← 2부 3장에서 추가

├── 인증 설정 ← 2부 4장에서 API 키 / OAuth 관리

├── claude mcp serve ← 2부 6장에서 서버화

└── 통합 환경 ← 2부 9장에서 완성

따라하기

1단계: 프로젝트 디렉토리 준비