Claude Code에서 MCP 활용하기

2026.06.18 / 동준상.넥스트플랫폼
(AWS SAA, AWS AIF, GCP GenAI Leader)

How to use MCP in Claude Code

핵심 요약 (Executive Summary)

MCP for Claude Code -infographic by NextPlatform

MCP (Model Context Protocol)은 Claude Code가 외부 도구 및 데이터 소스와 연결될 수 있도록 지원하는 개방형 표준이며, AI 에이전트는 MCP를 통해 데이터베이스, 생산성 앱, 공개 저장소 등 외부의 맥락(Context)을 이해하고 직접적인 행동을 수행할 수 있습니다.

사용자는 클로드 코드 터미널에서 claude mcp add 명령어를 통해 간단하게 서버를 추가할 수 있으며, 이를 프로젝트 또는 사용자 단위로 관리할 수 있습니다. 특히 효율적인 워크플로우를 위해 컨텍스트 창(Context Window) 관리가 핵심적인 요소로 작용하며, 시스템은 도구 점유율이 10%를 초과할 경우 자동으로 ‘도구 검색 모드’로 전환하는 기능을 갖추고 있습니다.

서버/도구 이름	유형 (HTTP/stdio)	범위 (Scope)	주요 기능 및 용도	연결 방법
GitHub CLI (gh)	stdio (로컬)	사용자 설정 또는 기술(Skill)	GitHub 관련 액션 수행 및 데이터 접근	기술(Skill)로 등록하여 CLI 명령 실행
AWS CLI	stdio (로컬)	사용자 설정 또는 기술(Skill)	AWS 인프라 관리 및 데이터 조회	기술(Skill)로 등록하여 CLI 명령 실행
Linear MCP 서버	HTTP (원격)	로컬, 사용자, 또는 프로젝트 (mcp.json)	프로젝트 관리 소프트웨어인 Linear의 특정 이슈 상세 정보를 가져옴	claude mcp add 명령어를 통해 추가
Context.ai MCP 서버	HTTP (원격)	로컬, 사용자, 또는 프로젝트 (mcp.json)	사용 중인 종속성(dependency)의 최신 문서를 제공함	claude mcp add 명령어를 통해 추가

MCP for Claude Code -mindmap-s by NextPlatform

1. MCP의 정의와 역할

MCP for Claude Code -Bridge for AI Agent by NextPlatform

MCP는 단순한 텍스트 출력을 넘어, AI 에이전트가 특정 과업을 완료하기 위해 외부 환경과 상호작용하는 ‘에이전트형 AI(Agentic AI)’로서의 기능을 수행하게 합니다.

핵심 개념: Claude Code가 질문을 받았을 때, 쿼리의 맥락을 보완하기 위해 외부 도구를 사용해야 하는 시점을 자동으로 파악하게 하는 표준입니다.
주요 데이터 소스:
- 프로젝트 관리 소프트웨어 (예: Linear의 이슈 세부 정보)
- 의존성 문서 (예: context-7 MCP 서버를 통한 최신 문서 제공)
- 기타 데이터베이스 및 생산성 애플리케이션
커넥터 생태계: claude.com/connectors를 통해 수백 개의 다양한 커넥터를 이용할 수 있습니다.

2. 서버 유형 및 관리 방식

MCP 서버는 연결 방식과 물리적 위치에 따라 두 가지 주요 유형으로 분류됩니다.

2.1 서버 유형

유형	설명	연결 방식
HTTP 서버	서비스 제공자가 호스팅하는 원격 서비스용	네트워크를 통한 연결
stdio 서버	사용자의 로컬 머신에서 실행되는 프로세스용	로컬 프로세스 통신

2.2 관리 명령어

추가: claude mcp add 명령어를 사용하여 새로운 MCP 서버를 구성에 추가합니다.
모니터링 및 제어: Claude Code 세션 내에서 /mcp 명령어를 사용하여 현재 연결된 서버의 목록과 상태를 확인하고, 불필요한 서버를 비활성화할 수 있습니다.

3. 설정 범위 (Scoping) 및 팀 협업

MCP 서버는 사용 용도와 협업 방식에 따라 세 가지 범위로 설정할 수 있습니다.

로컬(Local): 현재 프로젝트를 수행하는 개별 사용자에게만 유효합니다.
사용자(User): 해당 사용자의 모든 프로젝트에서 범용적으로 사용 가능합니다.
프로젝트 범위(Project Scope): mcp.json 파일을 생성하여 버전 관리 시스템(Git 등)에 포함시킵니다. 이 방식을 사용하면 해당 코드베이스에서 작업하는 모든 팀원이 동일한 서버 설정을 자동으로 공유하게 됩니다.

4. 컨텍스트 윈도우(Context Window) 최적화

MCP 도구 정의는 사용 중이지 않을 때도 컨텍스트 윈도우의 용량을 차지하므로, 효율적인 관리가 필수적입니다.

컨텍스트 점유 이슈: 너무 많은 서버가 구성되어 있으면 실제 작업에 사용할 수 있는 컨텍스트 용량이 줄어듭니다.
해결 방안 및 대안:
- 비활성화: 사용하지 않거나 당장 필요 없는 서버는 /mcp 명령어로 비활성화합니다.
- CLI 활용: GitHub(gh)나 AWS(aws)와 같이 CLI 대응 도구가 있는 경우, CLI를 사용하는 것이 더 효율적입니다. CLI는 영구적인 도구 정의를 추가하지 않기 때문입니다.
- 기술(Skill) 활용: 이름과 설명만 컨텍스트에 로드하고, 실제 필요 시에만 전체 도구를 로드하는 방식입니다. CLI 도구들을 이 ‘Skill’ 영역에 배치하여 효율을 높일 수 있습니다.
자동 전환 기능: MCP 도구가 전체 컨텍스트 창의 10%를 초과할 경우, Claude Code는 자동으로 **’도구 검색 모드(Tool Search Mode)’**로 전환됩니다. 이 모드에서는 필요에 따라 적절한 도구를 온디맨드로 찾아내지만, 컨텍스트 내에 직접 포함되어 있는 것보다 성능이 낮을 수 있습니다.