blevels

Home / AI / AI 바이브코딩 / MCP 입문 — AI가 외부 도구를 쓰는 방법

VIBE

MCP 입문 — AI가 외부 도구를 쓰는 방법

게시일 2026-04-30수정일 2026-04-30
공식 링크
On this page

:::callout type=info 이 가이드는 Claude Code 1.x / MCP 프로토콜 기준입니다 (2026-04). 도구 업데이트 시 검토 필요. :::

AI와 대화하면서 "이 파일을 읽어봐", "GitHub 이슈를 확인해봐", "슬랙에 메시지를 보내봐"라고 말하는 장면을 상상해 보자. MCP(Model Context Protocol)를 사용하면 이게 현실이 된다. MCP는 AI가 외부 도구와 서비스를 직접 호출할 수 있게 만드는 표준 프로토콜이다. Claude Code에서는 MCP 서버를 설정하는 것만으로 AI가 파일 시스템, 데이터베이스, 외부 API를 직접 다룰 수 있게 된다.

MCP가 무엇인가

MCP는 Anthropic이 공개한 오픈 프로토콜이다. AI 모델(Claude)과 외부 도구 서버 사이의 통신 규격을 정의한다. 서버-클라이언트 구조로, Claude Code가 클라이언트, 외부 도구가 서버 역할을 한다.

MCP 서버가 제공할 수 있는 것들:

  • 도구(Tool) — AI가 호출할 수 있는 함수 목록. 파일 읽기, API 호출, DB 조회 등
  • 리소스(Resource) — 파일, DB 레코드 등 AI가 읽을 수 있는 데이터 소스
  • 프롬프트(Prompt) — 재사용 가능한 프롬프트 템플릿

준비물

  • Claude Code CLI (최신 버전)
  • Node.js 20+ (Node 기반 MCP 서버 실행 시)
  • 설치할 MCP 서버 패키지
  • 예상 시간: 30분

1단계 — MCP 서버 설치

공개된 MCP 서버 패키지를 설치한다. 파일 시스템 접근 서버를 예시로 사용한다.

npm install -g @modelcontextprotocol/server-filesystem
AD

2단계 — Claude Code에 MCP 서버 등록

claude mcp add 명령으로 서버를 등록한다.

# 파일 시스템 MCP 서버 등록
claude mcp add filesystem -- npx @modelcontextprotocol/server-filesystem /path/to/allowed/dir

또는 ~/.claude/settings.json에 직접 추가한다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-filesystem",
        "/home/user/projects"
      ]
    }
  }
}

3단계 — 등록된 서버 확인

claude mcp list

등록된 서버 목록과 상태를 확인한다. connected 상태여야 정상이다. disconnected가 표시되면 서버 실행 경로와 권한을 점검한다.

AD

4단계 — Claude에서 MCP 도구 사용

Claude Code 세션에서 MCP 서버가 제공하는 도구를 자연어로 요청한다.

/allowed/dir 안에 있는 모든 .json 파일 목록을 보여줘.

Claude가 MCP 파일시스템 도구를 호출해 실제 디렉터리를 읽고 결과를 반환한다. 별도의 코드 작성 없이 AI가 외부 리소스에 직접 접근하는 것이다.

GitHub MCP 서버 연동 예시

GitHub MCP 서버를 사용하면 이슈, PR, 코드 검색을 Claude에서 직접 처리할 수 있다.

claude mcp add github -- npx @modelcontextprotocol/server-github

환경 변수에 GitHub Personal Access Token을 설정한다.

export GITHUB_TOKEN=ghp_xxxx

이후 Claude에게 자연어로 요청한다.

contents-auto 레포의 오픈 이슈 목록을 가져오고,
"bug" 라벨이 붙은 것만 정리해줘.

Claude가 GitHub MCP 서버를 통해 실제 이슈 데이터를 조회하고 요약해 반환한다.

결과 확인

MCP 서버가 정상 연결되면 Claude Code 세션에서 도구 호출 시 서버에서 반환된 실제 데이터가 응답에 포함된다. 연결 오류 발생 시 claude mcp list로 서버 상태를 먼저 확인한다. 서버가 반환하는 도구 목록은 /mcp 명령으로 확인할 수 있다.

다음 단계

기본 MCP 서버 활용이 익숙해지면, 직접 MCP 서버를 만들어 사내 API나 전용 데이터베이스를 Claude에서 다루는 단계로 넘어간다. MCP SDK를 사용하면 Node.js로 커스텀 서버를 구현할 수 있다. 내부 시스템을 MCP로 감싸면 AI가 기업 내부 리소스를 자연어로 다루는 환경을 구축할 수 있다.

관련 가이드: api-연동-자동화 / 훅-설정하기 / 에이전트-팀-구성

AD