Tan Kim

mcp

MCP (Model Context Protocol)

MCP(Model Context Protocol)는 AI 모델이 외부 시스템·도구·데이터에 표준화된 방식으로 접근할 수 있게 하는 오픈 프로토콜이다. Anthropic이 설계했으며, Claude 외 다른 AI 모델에도 적용 가능하다.

개념

MCP는 AI 모델과 외부 도구 사이의 공통 인터페이스 표준이다. MCP 이전에는 AI 모델이 특정 서비스에 접근하려면 각각 커스텀 통합을 구현해야 했다. MCP는 이 통합 방식을 표준화하여 AI 모델이 어떤 MCP 서버와도 동일한 방식으로 상호작용할 수 있게 한다.

구성 요소

MCP 호스트 (Host)

MCP 클라이언트를 실행하는 애플리케이션이다. Claude Code, Claude Desktop, Cursor 등이 MCP 호스트다.

MCP 서버 (Server)

도구와 리소스를 제공하는 프로세스다. 각 MCP 서버는 특정 시스템(DB, API, 파일 등)에 대한 접근을 제공한다.

통신 방식

방식 설명
stdio 표준 입출력으로 통신 (로컬 프로세스)
SSE HTTP Server-Sent Events (원격 서버)

서버 구성 예시

~/.claude/claude.json에 MCP 서버를 등록한다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "my-api": {
      "command": "node",
      "args": ["./my-mcp-server.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

MCP 서버가 제공하는 기능

Tools (도구)

AI 모델이 호출할 수 있는 함수다. 데이터 조회, 액션 수행, 외부 API 호출 등을 정의한다.

Resources (리소스)

AI 모델이 읽을 수 있는 데이터다. 파일, DB 레코드, API 응답 등을 리소스로 노출할 수 있다.

Prompts (프롬프트)

재사용 가능한 프롬프트 템플릿을 서버에서 제공하는 기능이다.

주요 활용 사례

데이터베이스 연동

Claude가 직접 DB에 쿼리를 실행하고 실제 데이터를 기반으로 답변할 수 있다.

  • MySQL, PostgreSQL, SQLite 등 연동
  • 스키마 파악 → 쿼리 작성 → 결과 해석까지 자동화

이슈 트래커 연동

GitHub Issues, Jira, Linear, Redmine 등 이슈 트래커를 연결하여 이슈를 조회하고, 코드 수정 및 PR 생성까지 자동화할 수 있다.

외부 API 호출

Slack 메시지 전송, 캘린더 이벤트 생성, 이메일 발송 등 외부 서비스와 연동하여 실제 액션을 수행할 수 있다.

Claude Code에서의 활용

Claude Code는 MCP를 통해 사내 시스템에 직접 접근하는 개발 자동화 파이프라인을 구성하는 데 특히 유용하다.

  • 이슈 트래커에서 이슈 조회 → 코드 수정 → PR 생성
  • DB 스키마 직접 조회 → 마이그레이션 스크립트 생성
  • 사내 API 문서 조회 → API 클라이언트 코드 자동 생성