Sign in to save your progressYou can keep reading without an account, but completed lessons won't be saved.
Sign in

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

MCP 통합 작동 방식

Model Context Protocol을 통해 Claude Code는 MCP 서버를 거쳐 외부 서비스에 연결할 수 있습니다. 각 서버는 Claude가 할 수 있는 작업을 확장하는 도구, 프롬프트, 리소스를 제공할 수 있습니다.

이 예제에서는 Claude Code를 문서 변환 도구를 제공하는 맞춤형 MCP 서버에 연결해 보겠습니다. 이를 통해 Claude가 PDF 및 Word 문서를 읽고 markdown 형식으로 변환할 수 있게 됩니다.

Claude Code에 MCP 서버 추가하기

MCP 서버를 설정하는 것은 간단합니다. 먼저 실행 중인 Claude Code 세션을 중지한 다음, MCP add 명령을 사용하세요:

bash
claude mcp add documents uv run main.py

이 명령은 두 개의 인수를 받습니다:

  • 서버 이름(원하는 이름을 사용할 수 있습니다 - 이 경우 "documents")
  • MCP 서버를 시작하는 명령

서버를 추가한 후 Claude Code를 재시작하면 자동으로 MCP 서버에 연결됩니다.

통합 테스트하기

연결이 완료되면 Claude는 MCP 서버가 제공하는 도구를 사용할 수 있습니다. 이 예제에서는 Claude에게 문서 파일을 markdown 형식으로 변환하도록 요청할 수 있으며, 이때 우리가 만든 문서 변환 도구를 자동으로 사용하게 됩니다.

이 도구는 문서 내용을 성공적으로 변환하며, MCP 서버가 Claude Code에 완전히 새로운 기능을 추가할 수 있는 방법을 보여줍니다.

개발 워크플로우를 향상시킬 수 있는 기존 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 서버
  • 특정 도구 및 프로세스를 위한 맞춤형 서버

이러한 유연성 덕분에 Claude Code는 다양한 개발 환경과 워크플로우에 놀라울 정도로 잘 적응할 수 있습니다. 평소에 자주 사용하는 외부 서비스와 도구가 무엇인지 생각해 보세요 - 이를 Claude Code와 통합할 수 있는 MCP 서버가 있을 가능성이 높습니다.