로드 중

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에게 문서 내용을 마크다운 형식으로 변환하도록 요청할 수 있습니다.

Claude Code에 포함된 MCP 클라이언트가 우리가 MCP 서버에 방금 작성한 document_path_to_markdown 도구를 호출합니다.

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

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

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

Claude에 각각의 기능을 추가하는 여섯 가지 인기 MCP 서버 표(아래에 나열됨).

  • 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가 이미 사용 중인 모든 도구와 서비스와 원활하게 작업할 수 있는 개발 환경이 만들어지며, 이는 Claude를 여러분의 특정 워크플로우에 맞춰진 훨씬 더 강력한 코딩 어시스턴트로 만들어줍니다.