MCP란? 외부 도구를 Claude Code에 연결하기 (2026)

MCP란? (Model Context Protocol)

MCP(Model Context Protocol)는 AI 애플리케이션을 외부 시스템, 도구, 데이터 소스에 일관된 방식으로 연결해 주는 개방형 표준입니다. Anthropic은 2024년 후반에 이 프로토콜을 도입하고 오픈소스로 공개해, 누구나 호환 서버를 만들 수 있게 했습니다(Anthropic, "Introducing the Model Context Protocol", Nov 25, 2024).

가장 쉬운 비유는 MCP가 AI를 위한 USB-C 포트라는 것입니다. USB-C 이전에는 기기마다 전용 케이블이 필요했습니다. USB-C 이후에는 포트 하나로 모든 것을 처리합니다. MCP는 AI에 대해 똑같은 일을 합니다. 일회성 통합이 잔뜩 쌓인 더미 대신, 단일 연결 표준을 제공하는 것이죠.

MCP가 해결하는 문제는 M × N 문제입니다. AI 앱이 M개, 도구가 N개 있다면 예전 방식으로는 M × N개의 개별 통합을 작성해야 했습니다. MCP를 쓰면 각 도구에는 MCP 서버 하나만 있으면 되고, 각 앱은 MCP를 "말할" 줄만 알면 되므로, 계산이 M + N으로 확 줄어듭니다. MCP가 그토록 빠르게 퍼진 이유가 바로 이것입니다. 데이터베이스용 MCP 서버를 하나 작성하면, MCP를 지원하는 모든 앱(Claude Code, Claude Desktop, 그리고 점점 늘어나는 IDE 목록)이 곧바로 그것을 사용할 수 있습니다.

요컨대 MCP는 표준화된 "AI를 데이터에 연결하는" 레이어입니다. 이 가이드에서는 Claude Code 안에서, 즉 실제로 명령을 입력하고 결과를 보는 부분에서 그것이 어떻게 동작하는지에 초점을 맞춥니다.

어떤 MCP? Model Context Protocol과 다른 의미들

약어에 대한 참고: "MCP"는 의미가 너무 많습니다. 이 가이드에서 MCP는 Model Context Protocol, 즉 2024년 후반에 나온 Anthropic의 AI 프로토콜을 뜻합니다. Microsoft Certified Professional(자격증)도, Master Control Program(영화 '트론'의 악당)도, Multi-Chip Package(칩 패키징 용어)도 아닙니다. 그중 하나를 찾아 오셨다면, 이 글은 원하시는 글이 아닙니다.

한 가지 더 분명히 해 둘 것이 있습니다. 많은 MCP 튜토리얼은 Claude Desktop을 통해 프로토콜을 설명합니다. 이 가이드는 특별히 Claude Code(CLI)를 위한 MCP에 관한 것으로, 명령줄에서 서버를 연결하고 코딩 워크플로 안에서 바로 사용하는 방법을 다룹니다.

Claude Code에 왜 MCP가 필요할까요?

기본적으로 AI 모델은 채팅 창에 붙여 넣은 것만 알고 있습니다. 프로젝트 안의 파일을 스스로 읽을 수 없고, 비공개 GitHub 저장소에 접근할 수 없으며, 데이터베이스에 질의할 수 없고, 브라우저를 열 수도 없습니다. 여러분이 건네준 텍스트 바깥에 있는 모든 것은 사각지대입니다.

MCP는 그 사각지대를 없앱니다. MCP 서버를 Claude Code에 연결하면, 어시스턴트는 다음을 할 수 있습니다.

• 파일 읽기와 쓰기를 현재 작업 디렉터리 밖에서 수행(Filesystem 서버).
• 데이터베이스 질의로 추측이 아닌 실제 데이터로 답하기(Postgres/SQLite 서버).
• 저장소 작업: 이슈 보기, PR 열기, 커밋 이력 읽기(GitHub 서버).
• 브라우저 조작: 페이지 열기, 폼 채우기, 스크린샷 찍기(Playwright 서버).
• 최신 문서 찾기 또는 웹 검색(Context7, Brave/Exa 서버).

이것이 Claude Code를 질문에 답하기만 하는 챗봇에서 실제로 행동하는 AI 에이전트로 바꾸는 단계입니다. "마이그레이션을 실행해야 합니다"라고 말해 주기만 하는 대신, 스키마 자체를 질의하고, 마이그레이션을 작성하고, PR을 열 수 있습니다. MCP는 이 "외부 도구에 연결하는" 동작을 표준화되고 통제된 방식으로 일어나게 하는 레이어입니다.

차이를 보여 주기 위한 예시(실측 벤치마크가 아니라 설명을 위한 것)를 들어 보겠습니다. MCP 없이: "왜 /orders 엔드포인트가 느릴까?"라고 물어도 Claude Code는 여러분이 붙여 넣은 코드만 읽고 거기서 추측할 수밖에 없습니다. MCP 있음(Postgres 서버): Claude Code는 실제 쿼리에 EXPLAIN ANALYZE를 실행해 orders 테이블에 인덱스가 없다는 것을 확인하고, 구체적인 마이그레이션을 제안하며, GitHub 서버를 통해 PR을 엽니다. 같은 질문이지만, 답은 어림짐작에서 근거로 옮겨 갑니다.

핵심은 이것입니다. MCP는 모델에 "지능"을 더하는 것이 아니라 감각과 손을 더합니다. 모델의 추론은 예전과 같지만, 이제 실제 데이터를 보고 여러분이 부여한 권한 범위 안에서 실제 시스템에 대해 행동할 수 있습니다.

MCP는 어떻게 동작할까요? Host, Client, Server

MCP 아키텍처에는 세 가지 주요 역할이 있습니다. 이 셋을 이해하면 프로토콜 전체를 이해한 것입니다.

• Host - 여러분이 사용하는 AI 앱. 여기서는 Claude Code가 그것입니다. Host는 모든 것을 조율하고, 어떤 도구를 호출할지 결정하며, 승인 권한을 가집니다.
• Client - Host 내부에 존재합니다. 각 클라이언트는 하나의 서버에 대한 연결을 정확히 하나 관리합니다. 서버 3개를 연결하면 Host는 클라이언트 3개를 띄웁니다.
• Server - 기능을 제공하는 외부 프로그램. 각 서버는 세 종류를 노출합니다. tools(AI가 호출할 수 있는 동작, 예: "이슈 만들기"), resources(읽을 수 있는 데이터, 예: 파일 내용), prompts(미리 만들어진 프롬프트 템플릿)입니다.

Claude Code에 그대로 대응시키면, Claude Code가 Host이고, 여러분이 추가하는 각 MCP 서버는 독립적인 "커넥터"입니다. GitHub로 작업하고 싶으세요? GitHub 서버를 연결하세요. 데이터베이스에 질의해야 하나요? Postgres 서버를 연결하세요. 커넥터들은 서로를 알지 못합니다. 모든 것이 합쳐지는 곳은 Host입니다.

통신 측면에서 MCP는 Host와 Server가 대화하기 위해 JSON-RPC를 사용합니다. 마주치게 될 주요 전송 방식(transport)은 두 가지입니다.

• 로컬(stdio) - 서버가 여러분의 컴퓨터에서 프로세스로 실행되며 표준 입출력으로 통신합니다. 파일 시스템, 로컬 데이터베이스, 개인 컴퓨터에서 실행되는 도구에 적합합니다.
• 원격(HTTP/SSE) - 서버가 원격 엔드포인트에서 실행됩니다. 클라우드 서비스나 팀이 공유하는 서버에 적합합니다.

전형적인 요청 흐름은 이렇습니다. Claude Code에서 명령을 주면 Host가 어떤 도구가 필요한지 판단하고, 해당 Client가 Server에 JSON-RPC 요청을 보내며, Server가 실행해 결과(있다면 리소스도 함께)를 반환하고, Host가 그 결과를 모델에 넘겨 답을 구성합니다. 도구가 실제로 실행되기 전에 Host가 여러분의 승인 단계를 끼워 넣습니다. 바로 그곳에서 여러분은 모든 쓰기나 삭제에 대해 통제권을 유지합니다.

첫 MCP 서버를 Claude Code에 연결하기 (실제 예제)

이론은 여기까지. 지금 바로 입력할 수 있는 부분입니다. Claude Code는 claude mcp 명령으로 MCP 서버를 관리합니다. 서버를 추가하는 문법은 다음과 같습니다.

claude mcp add <name> <command to run the server> [args...]

예제 1 - Filesystem 서버를 추가해 Claude Code가 특정 디렉터리를 읽고 쓸 수 있게 하기:

claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /path/to/your-project

예제 2 - GitHub 서버 추가하기(환경 변수로 개인 토큰이 필요하며, 명령에 절대 하드코딩하지 마세요):

claude mcp add github --env GITHUB_TOKEN=$GITHUB_TOKEN -- npx -y @modelcontextprotocol/server-github

하나를 추가한 뒤에는 Claude Code 세션을 열고 /mcp를 입력해 연결된 서버와 상태를 확인하세요.

/mcp

설계상 안전함(safe by design)에 관한 중요한 점 하나: Claude Code가 MCP 서버의 도구를 처음 호출하려 할 때 여러분의 승인을 요청합니다(human-in-the-loop). 어떤 도구가 어떤 인자로 실행되려는지 여러분이 "예"라고 말하기 전에 정확히 볼 수 있습니다. 습관적으로 "승인"을 클릭하지 마세요.

스코프(설정이 저장되는 곳)에 관해서는, Claude Code에서 서버를 로컬 수준(내 컴퓨터에만), 프로젝트 수준(설정 파일을 통해 저장소에서 공유), 또는 사용자 수준(내 모든 프로젝트)으로 연결할 수 있습니다. 그 서버를 비공개로 둘지 공유할지에 따라 스코프를 고르세요.

/mcp가 서버를 connected로 보고하면, 이제 평범한 말로 Claude Code에 작업을 부탁하면 적절한 도구를 골라 줍니다. 예를 들어 "가장 최근에 열린 이슈 5개를 나열해 줘"라고 하면 GitHub 서버의 도구를 호출합니다. 서버가 연결 오류를 보고한다면, 흔한 원인은 잘못된 패키지 경로, 누락된 토큰 환경 변수, 설치되지 않은 런타임입니다. 설정이 잘못되었을 때는 claude mcp remove <name>으로 서버를 제거하고 다시 추가하는 것이 빠른 해결책입니다.

특정 서버 하나를 깊이 파고들고 싶다면, 엔드투엔드 PR 예제가 담긴 GitHub MCP 서버를 Claude Code에 연결하기 설명을 보세요.

알아 둘 만한 인기 MCP 서버 (2026)

MCP 생태계는 이미 방대합니다. 먼저 알아 둘 가치가 있는 서버들을, 각각 언제 사용하면 좋은지 힌트와 함께 소개합니다.

이 목록은 시작점일 뿐입니다. 더 찾으려면 Glama 같은 디렉터리나 GitHub의 awesome-mcp-servers 저장소가 수백 개의 서버를 카테고리별로 정리해 두었습니다. 특정 서버의 설정 세부 사항은 GitHub MCP 서버를 Claude Code에 연결하기 가이드를 보세요.

MCP는 Skills, Subagents, Hooks와 어떻게 다를까요?

입문자들은 이 넷을 늘 헷갈려 합니다. 넷 다 Claude Code를 "확장"하기 때문이죠. 빠른 구분은 이렇습니다.

• MCP = 외부 도구와 데이터에 연결하는 레이어(GitHub, DB, 브라우저).
• Skills = 패키지화된 기능(지침 + 스크립트)으로, Claude를 특정 부류의 작업에 더 능숙하게 만듭니다.
• Subagents = 자체 컨텍스트로 자체 작업을 수행하는 전문화된 서브 에이전트.
• Hooks = 이벤트로 트리거되는 자동화(예: 파일 편집 후 린터 실행).

간단히 말하면, MCP는 바깥으로 연결을 담당하고, 나머지 셋은 Claude가 내부에서 어떻게 동작하는지를 담당합니다. 전체 정리는 Skills, Subagents, Hooks, MCP의 차이에서 보세요.

MCP를 사용할 때의 위험과 안전 참고사항

이 부분은 대부분의 튜토리얼이 건너뛰지만, MCP를 실제로 쓰기 시작하면 가장 중요합니다. MCP는 강력하고, "강력함"은 "조심해서 다루라"는 뜻입니다.

• 도구/리소스를 통한 프롬프트 인젝션: MCP 서버가 반환하는 내용(이슈, 웹 페이지, 파일)에는 여러분의 의도에 반해 행동하도록 AI를 부추기는 악의적 지시가 담겨 있을 수 있습니다. 서버가 돌려주는 모든 것이 안전하다고 가정하지 마세요.
• 서드파티 서버 신뢰: MCP 서버는 여러분의 컴퓨터에서, 또는 여러분의 데이터에 접근해 실행되는 코드입니다. 평판이 좋은 출처(공식, 또는 직접 검증할 수 있는 오픈소스)에서만 설치하고, 연결하기 전에 그것을 읽어 보세요.
• 사람을 루프에 유지하기: 편의만을 위해 도구 승인 단계를 끄지 마세요. 모든 쓰기나 삭제(파일 쓰기, 쿼리 실행, 커밋 푸시)에 대해 먼저 검토한 뒤 승인하세요.
• 시크릿을 하드코딩하지 마세요: 토큰과 API 키는 환경 변수로 전달하고, 명령에 인라인으로 넣거나 저장소에 커밋하지 마세요.

좋은 습관: 가능한 한 적은 서버로 시작하고, 각 서버에는 필요한 최소한의 스코프만 주세요(예: Filesystem은 드라이브 전체가 아니라 정확한 프로젝트 폴더를 가리키게 하기). 민감한 데이터의 경우, 읽기만 하면 될 때는 읽기 전용 계정이나 토큰을 선호하세요.

솔직히 말하면, MCP는 완벽하게 안전하지 않습니다. 안전성은 어떤 서버를 고르고 권한을 어떻게 부여하는지에 달려 있습니다. 모든 서버를, 기본으로 켜져 있는 무해한 기능이 아니라 여러분이 설치하는 소프트웨어로 대하세요.

지름길: 키트에 묶인 MCP 서버

각 MCP 서버를 손으로 설정하는 일(패키지 찾기, 토큰 처리, 스코프 고르기, 연결 확인)은 여러 개가 필요할 때 시간을 잡아먹습니다. 일부 Claude Code 키트는 MCP 통합 세트를 미리 구축해 제공하므로 수동 연결을 건너뛸 수 있습니다. 예를 들어, Marketing Kit은 12개 이상의 사전 구축된 MCP 통합을 제공하며, 리드 생성과 이메일/SEO 같은 흐름을 겨냥합니다. 궁금하다면 AgentKit 가격을 확인(링크로 20% 할인)할 수 있습니다. Marketing Kit은 99달러로 표시되어 있고, 페이지에는 반복 결제 언급이 없습니다.

자주 묻는 질문 (FAQ)

MCP는 무료인가요?

MCP 프로토콜 자체는 개방형 표준이며 무료입니다. 인기 있는 MCP 서버 대부분(Filesystem, GitHub, Postgres 등)은 오픈소스이며 무료로 사용할 수 있습니다. 유일한 비용은 서버가 연결하는 서비스(예: 클라우드 서비스의 API 요금제)에 드는 것입니다.

MCP는 일반 API와 어떻게 다른가요?

일반 API는 앱과 서비스 쌍마다의 일회성 통합입니다. MCP는 공유 표준입니다. MCP 서버를 하나 작성하면 MCP를 지원하는 모든 앱이 재통합 없이 사용할 수 있습니다. 내부적으로 MCP 서버는 여전히 그런 API들을 호출하는 경우가 많으며, MCP는 그 위에 얹히는 표준화 레이어입니다.

MCP 서버는 어디서 실행되나요 - 로컬인가요, 원격인가요?

둘 다입니다. 로컬 서버(stdio)는 여러분의 컴퓨터에서 프로세스로 실행되며, 파일 시스템과 개인 데이터베이스에 적합합니다. 원격 서버(HTTP/SSE)는 원격 엔드포인트에서 실행되며, 클라우드 서비스와 팀이 공유하는 서버에 적합합니다.

MCP 서버를 설치하려면 코딩을 알아야 하나요?

사용하는 데는 필요 없습니다. 이미 만들어진 서버라면 claude mcp add 명령 하나만 실행하면 끝입니다. 새 MCP 서버를 직접 만들고 싶을 때만 코딩이 필요합니다.

MCP는 안전한가요?

안전성은 어떤 서버를 고르고 어떤 권한을 부여하느냐에 달려 있습니다. 주요 위험은 프롬프트 인젝션과 신뢰할 수 없는 서드파티 서버입니다. 평판이 좋은 출처에서만 설치하고, 도구 승인 단계를 켜 두고, 시크릿을 하드코딩하지 마세요. MCP는 완벽하게 안전하지 않습니다.

Claude Code는 MCP 서버를 몇 개까지 지원하나요?

공개적으로 명시된 엄격한 한도는 없습니다. 많은 서버를 각각 자체 클라이언트로 동시에 연결할 수 있습니다. 실무에서는 세션을 가볍게 유지하고 권한을 통제하기 쉽도록 필요한 만큼만 두세요.

결론과 다음 단계

MCP는 Claude Code를 채팅 어시스턴트에서, 현실 세계(파일, 데이터베이스, GitHub, 브라우저)에 연결되는 AI 에이전트로 바꾸는 개방형 표준입니다. 이제 여러분은 그 정의, Host-Client-Server 아키텍처, claude mcp add 실행 방법, 그리고 주의할 위험을 알게 되었습니다. 가장 자연스러운 다음 단계는 연습입니다. 터미널을 열고 서버 하나로 claude mcp add를 시도해 보세요. 그런 다음 엔드투엔드 흐름을 만들기 위해 GitHub MCP 서버를 Claude Code에 연결하기를, 각 작업에 맞는 도구를 고르기 위해 Skills, Subagents, Hooks, MCP의 차이를 읽어 보세요.

· 참고 출처: modelcontextprotocol.io(문서, 2026-07-28 빌드) 및 Anthropic - Introducing MCP (Nov 25, 2024).