로드 중
로드 중

MCP

요약스크립트

Model Context Protocol(MCP)은 Claude Code가 외부 도구 및 데이터 소스에 연결할 수 있게 해주는 개방형 표준입니다. 질문을 하면 Claude는 쿼리를 더 잘 처리하기 위해 언제 이러한 도구를 사용해야 하는지 자동으로 파악합니다.

여러분의 컨텍스트 중 상당 부분은 코드베이스 외부에 존재합니다 — 데이터베이스, 생산성 앱, 또는 공개 저장소에 말이죠. MCP는 그 간극을 연결해줍니다.

MCP로 무엇을 할 수 있나요?

먼저, 에이전틱 AI에서 "도구"라는 개념을 이해하는 것이 중요합니다. 도구는 Claude Code와 같은 에이전트가 작업을 더 효과적으로 완수할 수 있도록 특정 동작을 수행할 수 있는 능력을 부여합니다. 이는 단순히 텍스트 응답만 받는 일반적인 AI와는 다른 점입니다.

예를 들어, 팀에서 프로젝트 관리에 Linear를 사용한다면 Linear MCP 서버를 추가해 특정 이슈의 세부 정보를 가져올 수 있습니다. 의존성 패키지에 대한 최신 문서가 필요하다면 Context7 같은 문서용 MCP 서버가 Claude Code에 해당 정보를 제공할 수 있습니다.

Claude Code가 Linear MCP 서버에 쿼리하여 티켓의 이슈 세부 정보를 가져오는 모습

Claude Code가 Context7 MCP 서버를 사용해 최신 shadcn/ui 문서를 조회하는 모습

MCP 서버 추가하기

claude mcp add 명령으로 MCP 서버를 추가할 수 있습니다. 크게 두 가지 유형이 있습니다:

터미널에서 claude mcp add를 실행해 HTTP Linear MCP 서버를 추가하는 모습

  • HTTP 서버는 원격 서비스를 위한 것입니다. 서비스 제공업체가 호스팅하며 네트워크를 통해 연결됩니다.
  • Stdio 서버는 여러분의 컴퓨터에서 실행되는 로컬 프로세스를 위한 것입니다.

Python 스크립트로 로컬 stdio MCP 서버를 추가하기 위해 claude mcp add를 실행하는 모습

Claude Code 세션 내에서 /mcp를 사용해 연결된 서버를 확인하고, 상태를 점검하고, 필요 없는 서버를 비활성화하는 등 서버를 관리할 수 있습니다.

연결된 MCP 서버와 그 상태를 보여주는 /mcp 명령

서버 범위 지정하기

MCP 서버는 세 가지 방식으로 범위를 지정할 수 있습니다:

  1. 로컬(Local) — 현재 프로젝트에서만, 본인에게만 사용 가능합니다.
  2. 사용자(User) — 여러분의 모든 프로젝트에서 사용 가능합니다.
  3. 프로젝트(Project) — 버전 관리에 커밋하는 .mcp.json 파일을 사용하여 코드베이스에 참여하는 모든 사람이 자동으로 동일한 서버를 얻게 합니다.

컨텍스트 비용

MCP 서버는 실제로 사용하고 있지 않을 때도 도구 이름과 지침을 컨텍스트 창에 추가합니다. 연결된 서버마다 일정한 공간을 차지하므로, /mcp를 실행해 무엇이 연결되어 있는지 확인하고 실제로 사용하지 않는 서버는 비활성화하세요.

도구 보기, 재연결, 또는 서버 비활성화 옵션이 있는 /mcp 서버 세부 보기

GitHub용 gh나 AWS용 aws처럼 도구에 CLI 대응 도구가 있다면, CLI는 각 도구에 대한 목록을 추가하지 않으므로 컨텍스트 효율성이 더 높습니다.

또한 MCP 서버를 해당 서버의 도구를 잘 사용하는 방법을 Claude에게 알려주는 Skill과 함께 사용하면 도움이 될 수 있습니다. Skill에는 컨텍스트에 로드되는 이름과 설명이 있으며, Claude는 해당 Skill이 필요하다고 판단했을 때만 전체 Skill 콘텐츠를 로드합니다.

도구 검색(Tool search)은 기본적으로 켜져 있어서, Claude Code는 Claude가 필요로 할 때까지 각 MCP 도구의 전체 정의를 컨텍스트에서 제외합니다.

요약

MCP는 Claude Code를 외부 도구 및 데이터 소스에 연결해줍니다. claude mcp add로 서버를 추가하세요. .mcp.json을 사용해 프로젝트에 범위를 지정하면 팀원들이 자동으로 해당 서버를 얻게 됩니다. 그리고 실제로 사용하지 않는 서버는 비활성화하여 컨텍스트 사용량을 주시하세요.