로드 중

Claude Code에 MCP 서버 추가하기

강의 607분

Claude Code에는 MCP 클라이언트가 내장되어 있어, MCP 서버를 연결하여 Claude가 할 수 있는 작업을 크게 확장할 수 있습니다. 이를 통해 개발 워크플로우를 맞춤화할 수 있는 매우 강력한 가능성이 열립니다.

MCP가 Claude를 확장하는 방법

Model Context Protocol을 사용하면 Claude Code가 MCP 서버를 통해 외부 서비스 및 도구에 연결할 수 있습니다. Claude의 내장 기능에만 국한되지 않고, 특정 도구, 리소스 또는 통합 기능을 제공하는 서버를 연결하여 맞춤형 기능을 추가할 수 있습니다.

Claude Code 내부의 MCP 클라이언트가 두 개의 별도 MCP 서버에 연결되며, 각 서버는 자체 외부 서비스에 접근합니다.

각 MCP 서버는 세 가지 주요 구성 요소인 Tools(작업 수행용), Prompts(템플릿용), Resources(데이터 접근용)를 통해 Claude에게 다양한 유형의 기능을 노출할 수 있습니다.

MCP 서버 설정하기

Claude Code에 MCP 서버를 추가하는 것은 간단합니다. 명령줄을 사용하여 서버를 등록합니다:

bash
claude mcp add [server-name] [command-to-start-server]

예를 들어, uv run main.py로 시작하는 문서 처리 서버가 있다면 다음과 같이 실행합니다:

bash
claude mcp add documents uv run main.py

등록이 완료되면 Claude Code는 시작 시 자동으로 서버에 연결합니다.

예시: 문서 처리

실용적인 예시로는 Claude가 PDF 및 Word 문서를 읽을 수 있게 해주는 도구를 만드는 것이 있습니다. "document_path_to_markdown" 도구가 포함된 MCP 서버를 구축하면, Claude에게 문서 내용을 markdown 형식으로 변환해 달라고 요청할 수 있습니다.

Claude Code에는 MCP 클라이언트가 포함되어 있으며, 이는 우리가 MCP 서버에 작성한 document_path_to_markdown 도구를 호출합니다.

Claude에게 "tests/fixtures/mcp_docs.docx 파일을 markdown으로 변환해줘"라고 요청하면, Claude는 자동으로 사용자 지정 도구를 사용하여 문서를 읽고 변환된 내용을 반환합니다.

터미널 markdown 출력: 사용자 제어 Prompts, 애플리케이션 제어 Resources, 모델 제어 Tools의 표.

MCP 생태계에는 다양한 일반적인 개발 도구 및 서비스를 위한 서버가 포함되어 있습니다:

여섯 가지 인기 MCP 서버와 각각이 Claude에 추가하는 기능을 나열한 표.

  • sentry-mcp - Sentry에 기록된 버그를 자동으로 발견하고 수정
  • playwright-mcp - 테스트 및 문제 해결을 위한 브라우저 자동화 기능을 Claude에 제공
  • figma-context-mcp - Figma 디자인을 Claude에 노출
  • mcp-atlassian - Claude가 Confluence 및 Jira에 접근할 수 있도록 허용
  • firecrawl-mcp-server - Claude에 웹 스크래핑 기능 추가
  • slack-mcp - Claude가 메시지를 게시하거나 특정 스레드에 답장할 수 있도록 허용

개발 워크플로우 구축하기

진정한 강력함은 특정 개발 프로세스에 맞는 여러 MCP 서버를 결합하는 데서 나옵니다. 다음과 같이 설정할 수 있습니다:

  • 프로덕션 오류 세부 정보를 가져오는 Sentry 서버
  • 티켓 요구 사항을 읽는 Jira 서버
  • 작업이 완료되면 팀에 알리는 Slack 서버
  • 내부 도구 및 API를 위한 맞춤형 서버

이를 통해 Claude가 이미 사용 중인 모든 도구 및 서비스와 원활하게 작업할 수 있는 개발 환경이 만들어지며, 특정 워크플로우에 맞춘 훨씬 더 강력한 코딩 어시스턴트가 됩니다.