Claude Code에 MCP 서버 추가하기

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

MCP 통합 작동 방식

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

Claude Code의 MCP 클라이언트가 도구, 프롬프트, 리소스를 갖춘 두 개의 MCP 서버에 연결되며, 각 서버는 외부 서비스를 호출합니다.

이 예시에서는 Claude Code를 문서 변환 도구를 제공하는 사용자 지정 MCP 서버에 연결해 보겠습니다. 이를 통해 Claude가 PDF 및 Word 문서를 읽고 마크다운 형식으로 변환할 수 있게 됩니다.

Claude Code 내부의 MCP 클라이언트가 document_path_to_markdown 도구를 보유한 우리의 MCP 서버에 연결됩니다.

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

bash

claude mcp add documents uv run main.py

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

서버 이름(원하는 대로 지정 가능 - 이 경우 "documents")
MCP 서버를 시작하는 명령

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

통합 테스트하기

연결이 완료되면 Claude는 MCP 서버가 제공하는 도구를 사용할 수 있습니다. 이 예시에서는 Claude에게 문서 파일을 마크다운 형식으로 변환해 달라고 요청할 수 있으며, Claude는 우리가 만든 문서 변환 도구를 자동으로 사용합니다.

Claude Code가 mcp_docs.docx에 대해 MCP 도구 document_path_to_markdown을 실행하여 기본 요소 표가 포함된 마크다운을 반환합니다.

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

개발을 위한 인기 있는 MCP 서버

개발 워크플로우를 향상시킬 수 있는 기존 MCP 서버가 많이 있습니다:

Claude를 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 서버
특정 도구 및 프로세스를 위한 사용자 지정 서버

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

MCP 통합 작동 방식