MCP로 세상과 연결

동작하는 코드

MCP(Model Context Protocol)는 Claude Code에 외부 도구를 연결하는 표준입니다. 예를 들어 파일 시스템, 데이터베이스, 브라우저 등을 Claude가 직접 사용할 수 있게 됩니다.

MCP 서버를 추가해봅시다. .claude/settings.json에서 설정하거나, 명령어로 추가합니다:

> /mcp

현재 연결된 MCP 서버 목록이 표시됩니다. 새 서버를 추가해봅시다:

claude mcp add fetch -- npx -y @anthropic-ai/mcp-fetch

이제 Claude가 웹 페이지를 직접 가져올 수 있습니다:

> https://jsonplaceholder.typicode.com/todos/1 의 내용을 가져와줘

직접 수정하기

더 실용적인 MCP 서버를 추가해봅시다:

GitHub MCP 서버 — GitHub API에 직접 접근:

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

> 이 레포지토리의 최근 이슈 5개를 보여줘

파일 시스템 MCP 서버 — 특정 디렉토리 접근:

claude mcp add filesystem -- npx -y @anthropic-ai/mcp-filesystem /path/to/allowed/dir

설정이 올바른지 확인합니다:

> /mcp

연결된 서버 목록에 추가한 서버가 보이면 성공입니다.

"왜?" — MCP가 게임체인저인 이유

Claude Code 단독으로는 터미널 명령어와 파일 조작만 가능합니다. MCP는 이 한계를 넘어서 외부 시스템과의 통합을 가능하게 합니다.

MCP의 구조

Claude Code ←→ MCP 프로토콜 ←→ MCP 서버 ←→ 외부 서비스
                                    │
                              ┌─────┴─────┐
                              │  도구(tools) │
                              │ 리소스(resources) │
                              └───────────┘

자주 쓰이는 MCP 서버

| 서버 | 기능 | | ------------------- | --------------------------------- | | mcp-fetch | HTTP 요청으로 웹 페이지/API 호출 | | server-github | GitHub 이슈, PR, 리포지토리 관리 | | server-postgres | PostgreSQL 데이터베이스 직접 조회 | | server-filesystem | 허용된 디렉토리의 파일 읽기/쓰기 | | server-puppeteer | 브라우저 자동화, 스크린샷 |

MCP 서버 관리 명령어

claude mcp add <이름> -- <실행 명령어>     # 서버 추가
claude mcp remove <이름>                   # 서버 제거
claude mcp list                            # 서버 목록 확인

설정 범위

| 플래그 | 범위 | 설정 파일 | | ------------ | ------------- | ------------------------- | | -s user | 모든 프로젝트 | ~/.claude/settings.json | | -s project | 현재 프로젝트 | .claude/settings.json |

심화 학습

npx @anthropic-ai/create-mcp-server my-server