MCP란 무엇인가 — Claude가 도구·데이터를 연결하는 표준

MCP가 뭔가

Anthropic이 2024년 말 공개한 AI 도구·데이터 연결 표준. 간단히: "AI에게 함수를 제공하는 USB-C".

예전엔 도구 연결이 모델·플랫폼별로 다 달라서 호환 안 됐는데, MCP가 표준화하면서 한 번 만든 도구가 Claude·여러 플랫폼에서 그대로 동작.

어떻게 작동하나

Claude Code  ─┐
Claude 데스크톱 ─┼─ MCP Client ──[표준 프로토콜]── MCP Server ── 실제 도구
VS Code 확장   ─┘                                            (GitHub, DB, 파일 등)

Server 쪽이 "이 도구가 있어요"라고 등록하면, Client가 알아서 호출.

실전 활용 예

filesystem MCP — Claude가 로컬 파일 직접 읽기·쓰기 github MCP — 이슈 검색·PR 작성·코드 리뷰 puppeteer MCP — 브라우저 자동화 postgres MCP — DB 스키마 조회·쿼리 실행 slack MCP — 메시지 검색·발송

Claude Code에서 MCP 설정

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_..." }
    }
  }
}

파일: ~/.claude/mcp_servers.json (글로벌) 또는 .claude/mcp_servers.json (프로젝트).

직접 MCP 서버 만들기

TypeScript SDK로 30분 안에 가능. "내 회사 API를 Claude에 연결" 같은 사내 통합에 강력.

MCP가 중요한 이유

• 한 번 만들면 여러 AI 클라이언트에서 재사용
• 보안 통제 (allowed tools로 권한 제한)
• 커뮤니티 MCP 서버 카탈로그 빠르게 성장
• 차세대 에이전트의 표준 인프라

흔한 오류

• 서버 연결 실패 → MCP 연결 디버깅
• 권한 부족 → allowed_tools 설정 확인
• 환경변수 미전달 → config의 env 필드 점검