MCP
Model Context Protocol(MCP)은 Claude Code가 외부 도구 및 데이터 소스에 연결할 수 있게 해주는 개방형 표준입니다. 질문을 하면 Claude는 해당 질문을 더 잘 처리하기 위해 이러한 도구를 사용해야 하는 시점을 자동으로 파악합니다.
여러분의 컨텍스트 중 많은 부분은 코드베이스 외부, 즉 데이터베이스, 생산성 앱, 또는 공개 저장소에 존재합니다. MCP는 그 간극을 연결해 줍니다.
MCP로 무엇을 할 수 있나요?
먼저, 에이전틱 AI에서 "도구(tools)"라는 개념을 이해하는 것이 중요합니다. 도구는 Claude Code와 같은 에이전트가 작업을 더 효과적으로 완료할 수 있도록 행동을 수행할 수 있는 능력을 부여합니다. 이는 단순히 텍스트 응답만 받는 일반적인 AI와는 다릅니다.
예를 들어, 팀에서 프로젝트 관리를 위해 Linear를 사용한다면, Linear MCP 서버를 추가하여 특정 이슈의 세부 정보를 가져올 수 있습니다. 의존성에 대한 최신 문서가 필요하다면, Context7과 같은 문서 MCP 서버가 Claude Code에 해당 정보를 제공할 수 있습니다.
MCP 서버 추가하기
claude mcp add 명령으로 MCP 서버를 추가할 수 있습니다. 주요 유형은 두 가지입니다:
- HTTP 서버는 원격 서비스용입니다. 서비스 제공업체가 호스팅하며 네트워크를 통해 연결됩니다.
- Stdio 서버는 여러분의 머신에서 실행되는 로컬 프로세스용입니다.
Claude Code 세션 내에서 /mcp를 사용하여 서버를 관리하고, 연결된 항목을 확인하고, 상태를 점검하고, 필요하지 않은 서버를 비활성화할 수 있습니다.
서버 범위 지정하기
MCP 서버는 세 가지 방식으로 범위를 지정할 수 있습니다:
- Local — 현재 프로젝트에서만, 본인에게만 사용 가능합니다.
- User — 모든 프로젝트에서 사용 가능합니다.
- Project — 버전 관리에 커밋하는
.mcp.json파일을 사용하여 코드베이스에 참여하는 모든 사람이 자동으로 동일한 서버를 갖게 됩니다.
컨텍스트 비용
MCP 서버는 실제로 사용하지 않을 때도 컨텍스트 윈도우에 도구 정의를 추가합니다. 서버를 많이 설정해 두면 사용 가능한 컨텍스트를 잠식하게 됩니다. /mcp를 실행하여 연결된 항목을 확인하고 실제로 사용하지 않는 것은 비활성화하세요.
도구에 CLI 대응 버전이 있다면(예: GitHub용 gh, AWS용 aws), CLI가 지속적인 도구 정의를 추가하지 않기 때문에 컨텍스트 측면에서 더 효율적입니다.
대신 스킬을 사용하는 것이 더 유리할 수도 있습니다. 스킬은 이름과 설명이 컨텍스트에 로드되며, Claude는 필요하다고 판단할 때만 전체 스킬 내용을 로드합니다.
MCP 도구가 컨텍스트 윈도우의 10%를 초과하면, Claude Code는 자동으로 도구 검색 모드로 전환되어 필요에 따라 적절한 도구를 찾아냅니다. 다만 이 방식은 안정적으로 작동하지 않을 수 있습니다.
요약
MCP는 Claude Code를 외부 도구 및 데이터 소스에 연결해 줍니다. claude mcp add로 서버를 추가하세요. .mcp.json으로 프로젝트에 범위를 지정하면 팀원들이 자동으로 해당 서버를 사용할 수 있습니다. 그리고 실제로 사용하지 않는 서버를 비활성화하여 컨텍스트 사용량을 주시하세요.