05강. MCP 서버 설정으로 능력 확장

🎯 학습 목표

MCP(Model Context Protocol)가 무엇이고 왜 필요한지 이해한다.
Filesystem MCP와 Browser MCP를 Windows 11에 설정한다.
MCP 설정 파일(JSON)의 구조를 이해한다.
Windows 경로 관련 흔한 오류를 해결한다.

📖 개념 설명

MCP(Model Context Protocol)는 Claude 같은 AI가 외부 도구·데이터에 표준화된 방식으로 접근할 수 있게 해주는 프로토콜입니다. 비유하자면 AI에게 꽂아 쓰는 ‘USB 포트’ 같은 것으로, MCP 서버를 연결하면 Claude가 파일 시스템, 브라우저, 데이터베이스 등 새로운 능력을 얻습니다.

예를 들어 Filesystem MCP를 연결하면 지정한 폴더의 파일을 더 풍부하게 다룰 수 있고, Browser MCP를 연결하면 실제 웹페이지를 열어 내용을 확인하거나 스크린샷을 찍을 수 있습니다. 이렇게 MCP는 Claude Code의 기본 능력을 프로젝트 필요에 맞게 확장합니다.

MCP 서버는 설정 파일에 등록합니다. 어떤 명령으로 서버를 실행할지, 어떤 인자를 줄지를 JSON으로 기술합니다. Windows에서는 경로에 백슬래시가 들어가는데, JSON에서 백슬래시는 이스케이프 문자이므로 \로 두 번 쓰거나 슬래시(/)로 적어야 하는 점이 핵심 주의사항입니다.

MCP가 등장하기 전에는 AI 도구마다 외부 연동 방식이 제각각이어서, 새로운 도구를 붙일 때마다 별도의 통합 코드를 짜야 했습니다. MCP는 이 연결 방식을 표준화해, 한 번 만들어진 MCP 서버를 여러 AI 클라이언트가 공통으로 쓸 수 있게 합니다. 덕분에 생태계가 빠르게 커지고 있으며, 파일 시스템·브라우저뿐 아니라 데이터베이스, 깃허브, 슬랙, 검색 엔진 등 다양한 MCP 서버가 공개되어 있습니다.

MCP 서버는 크게 두 가지 능력을 제공합니다. 하나는 ‘Tools(도구)’로, AI가 호출해 어떤 동작을 수행하게 합니다(예: 파일 읽기, 웹페이지 열기). 다른 하나는 ‘Resources(자원)’로, AI가 참고할 데이터를 제공합니다. Claude는 연결된 MCP가 어떤 도구를 제공하는지 자동으로 인식하고, 필요할 때 적절한 도구를 골라 사용합니다. 사람은 그저 “이 페이지 열어서 제목 알려줘” 같은 자연어 요청만 하면 됩니다.

다만 MCP는 강력한 만큼 신중하게 다뤄야 합니다. 파일 시스템에 쓰기 권한을 주거나 브라우저로 임의의 사이트에 접근하게 하는 것은 보안과 직결됩니다. 그래서 접근 범위를 최소한으로 제한하고, 신뢰할 수 있는 MCP 서버만 등록하는 것이 원칙입니다. 특히 회사 환경에서는 보안 정책을 먼저 확인하세요.

💻 실습

Claude Code의 MCP 관리 명령으로 Filesystem MCP를 추가할 수 있습니다.

# 현재 등록된 MCP 서버 목록 확인
claude mcp list

# Filesystem MCP 추가 (접근 허용 폴더 지정)
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem C:/dev

직접 설정 파일을 편집할 수도 있습니다. 설정 파일에는 다음과 같은 구조가 들어갑니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:/dev"
      ]
    },
    "browser": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

설정 후 Claude Code를 재시작하고, MCP가 정상 로드되었는지 확인합니다.

claude mcp list

# Claude 안에서 연결 상태 확인
> /mcp

⚠️ Windows 환경 주의사항

JSON 안의 경로는 C:\dev처럼 백슬래시를 이중으로 쓰거나, C:/dev처럼 슬래시를 사용하세요. C:dev는 JSON 파싱 오류를 일으킵니다.
npx가 인식되지 않으면 Node.js 설치 경로가 PATH에 등록되었는지 확인하세요. 새 터미널을 열면 PATH가 갱신됩니다.
회사 프록시 환경에서는 npx가 패키지를 못 받을 수 있습니다. npm config set proxy로 프록시를 설정하세요.
Puppeteer 기반 Browser MCP는 첫 실행 시 Chromium을 내려받으므로 시간이 걸리고 디스크 공간이 필요합니다.

💡 팁

필요한 MCP만 등록하세요. 너무 많이 붙이면 컨텍스트가 복잡해지고 느려집니다.
Filesystem MCP의 접근 폴더는 최소 범위로 지정해 보안을 유지하세요.
/mcp 명령으로 연결 상태와 사용 가능한 도구를 수시로 확인하세요.
설정이 꼬이면 claude mcp remove <이름> 후 다시 추가하는 것이 빠릅니다.
새로운 MCP를 붙였다면 “지금 사용할 수 있는 도구를 알려줘”로 능력 변화를 확인하세요.