MCP
Model Context Protocol (MCP)는 Claude Code가 외부 도구 및 데이터 소스에 연결할 수 있게 해주는 개방형 표준입니다. 질문을 하면 Claude는 해당 질문을 더 잘 처리하기 위해 언제 이러한 도구를 사용해야 하는지 자동으로 이해합니다.
한국어 대본
- 00:00Model Context Protocol은 Claude Code가 외부 도구와 데이터 소스에 연결할 수 있게 하는 개방형 표준입니다.
- 00:09질문하면 Claude가 쿼리를 더 잘 이해하기 위해 해당 도구를 사용해야 할 시점을 자동으로 파악합니다.
- 00:18컨텍스트는 Claude Code로 작업할 때 가장 중요한 부분 중 하나입니다.
- 00:23컨텍스트의 상당 부분은 데이터베이스, 생산성 앱, 공개 리포지터리처럼 다른 곳에 있습니다.
- 00:29리포지터리입니다. 여기서 MCP가 등장합니다. 먼저 에이전트 AI를 말할 때 도구의 개념을 이해하는 것이 중요합니다.
- 00:38도구는 Claude Code 같은 에이전트가 작업을 더 잘 완료하도록 행동을 수행할 수 있게 합니다.
- 00:43이는 보통 텍스트로 결과를 바로 받는 다른 AI와 다릅니다.
- 00:48예를 들어 팀에서 Linear를 프로젝트 관리 소프트웨어로 사용한다면,
- 00:54linear MCP 서버를 추가해 특정 이슈의 세부 정보를 가져올 수 있습니다.
- 00:59작업 중인 종속 항목의 최신 문서를 확인하고 싶다면,
- 01:05Context 7 MCP 서버가 Claude Code에 해당 문서를 제공합니다. 또한 수백 개의 다른 커넥터가
- 01:10claude.com/connectors에 있습니다. 다음 명령으로 MCP 서버를 추가할 수 있습니다.
- 01:16`claude mcp add` 명령을 사용하세요. 주요 유형은 두 가지입니다. HTTP 서버는 원격 서비스용이며, 이는
- 01:24서비스 제공자가 호스팅하고 네트워크를 통해 연결합니다.
- 01:27STDIO 서버는 컴퓨터에서 실행되는 로컬 프로세스용입니다.
- 01:32Claude Code 세션 안에서 `/mcp`를 사용해 서버를 관리하고 어떤 서버가
- 01:36연결되어 있는지와 상태를 확인하고 사용하지 않을 서버를 비활성화할 수 있습니다.
- 01:42MCP 서버의 범위는 세 가지 방식으로 지정할 수 있습니다.
- 01:46첫째, local은 현재 프로젝트에서만 사용할 수 있다는 뜻입니다.
- 01:49둘째, user는 모든 프로젝트에서 사용할 수 있다는 뜻입니다.
- 01:53셋째, Project Scope는 버전 관리에 커밋하는 `.mcp.json` 파일을 사용하므로
- 01:58코드베이스에서 작업하는 모든 사람이 정확히 같은 서버를 자동으로 받습니다.
- 02:04여기서 알아둘 점은 MCP 서버가 도구 정의를 컨텍스트 창에 추가한다는 것입니다.
- 02:09사용하지 않을 때도 마찬가지입니다.
- 02:11따라서 서버를 많이 구성하면 사용 가능한 컨텍스트가 그만큼 줄어듭니다.
- 02:17`/mcp` 명령을 실행해 연결된 항목을 확인하고 적극적으로 사용하지 않는 것은 비활성화하세요.
- 02:22앞으로 사용할 것 같지 않은 것도 비활성화하세요.
- 02:24도구에 GitHub용 GH나 AWS용 AWS 같은 CLI 대응 항목이 있다면,
- 02:31CLI가 지속적인 도구 정의를 추가하지 않으므로 컨텍스트 측면에서 더 효율적입니다.
- 02:36이런 상황에서는 스킬을 사용하는 것도 도움이 될 수 있습니다.
- 02:40스킬에는 컨텍스트에 로드되는 이름과 설명이 있습니다.
- 02:44MCP와 마찬가지로 Claude가 해당 스킬을 사용해야 한다고 판단하면,
- 02:47이를 컨텍스트 창에 로드하기로 결정하고,
- 02:49그곳에 명령줄 인터페이스 도구를 넣을 수 있습니다.
- 02:53MCP 도구가 컨텍스트 창의 10%를 초과하면,
- 02:57Claude Code가 자동으로 도구 검색 모드로 전환해
- 02:59필요할 때 적절한 도구를 찾습니다.
- 03:01하지만 컨텍스트에 직접 들어 있는 것이 아니므로 잘 작동하지 않을 수도 있습니다.
- 03:10이제 간단히 요약하겠습니다.
- 03:12MCP는 Claude Code를 외부 도구와 데이터 소스에 연결합니다.
- 03:15`claude mcp add`로 서버를 추가하고 `.mcp.json`으로 프로젝트 범위를 지정하면
- 03:24팀이 서버를 자동으로 받게 할 수 있습니다. 서버를 비활성화해 컨텍스트 사용량을 주시하고
- 03:29적극적으로 사용하지 않는 서버는 비활성화하세요.
여러분의 컨텍스트 중 많은 부분은 코드베이스 외부에 존재합니다 — 데이터베이스, 생산성 앱, 또는 공개 저장소에 말이죠. 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는 지속적인 도구 정의를 추가하지 않기 때문에 컨텍스트 측면에서 더 효율적입니다.
Skill을 대신 사용하는 것도 도움이 될 수 있습니다. Skill은 이름과 설명이 컨텍스트에 로드되며, Claude는 해당 Skill을 사용해야 한다고 판단할 때만 전체 Skill 내용을 로드합니다.
MCP 도구가 컨텍스트 윈도우의 10%를 초과하면, Claude Code는 자동으로 도구 검색 모드로 전환되어 필요에 따라 적절한 도구를 찾아냅니다 — 다만 이는 안정적으로 작동하지 않을 수 있습니다.
요약
MCP는 Claude Code를 외부 도구 및 데이터 소스에 연결합니다. claude mcp add로 서버를 추가하세요. .mcp.json으로 프로젝트에 범위를 지정하면 팀이 자동으로 해당 서버를 얻게 됩니다. 그리고 실제로 사용하지 않는 서버를 비활성화하여 컨텍스트 사용량을 주시하세요.