CPN 한국어 자습서 · 러닝패스 2 / 4 — Building with the Claude API
Anthropic 앱
Enhancements with MCP servers
Claude Code에는 MCP 클라이언트가 내장되어 있습니다. claude mcp add 한 줄로 MCP 서버를 붙이면 기능이 크게 확장됩니다. 앞서 만든 문서 변환 도구를 연결해 보고, Sentry·JIRA·Slack 같은 실무 확장도 살펴봅니다.
Stephen Grider · Anthropic 기술 스태프
이번 영상에서는 Claude Code의 가장 흥미로운 면 하나를 보여 드립니다. Claude Code에는 MCP 클라이언트가 내장되어 있습니다. 즉, MCP 서버를 Claude Code에 연결해 기능을 극적으로 확장할 수 있다는 뜻입니다.
이를 보여 주기 위해, 우리가 작업해 온 MCP 서버를 Claude Code에 연결합니다. 방금 document_path_to_markdown이라는 도구를 만들었죠. 이제 그 도구를 Claude Code에 노출해, Claude Code가 PDF와 Word 문서의 내용을 읽을 수 있게 합니다. Claude Code의 능력을 동적으로 확장하는 것입니다.
설정하는 법을 보여 드립니다. 터미널로 돌아가, 실행 중인 세션을 Control-C로 종료합니다. 그다음 claude mcp add를 실행해 MCP 서버를 추가합니다. 이어서 서버의 이름을 넣습니다 — 이름은 무엇이든 좋습니다. 우리 경우 문서와 관련된 서버라 documents라고 부르겠습니다. 마지막으로, 서버를 시작할 때 쓰는 명령을 넣습니다 — 우리는 uv run main.py입니다. 그게 전부입니다. 실행한 뒤 claude로 Claude Code를 다시 띄웁니다.
이제 방금 만든 도구를 실제로 테스트해 봅니다. 테스트 디렉터리 안 fixtures 폴더에 데모 파일 두 개 — Word 문서와 PDF 문서 — 가 있고, 둘 다 MCP에 관한 짧은 설명이 담겨 있습니다. Claude에게 둘 중 하나의 내용을 Markdown으로 변환해 달라고 합니다. 기대대로 Claude는 방금 만든 그 도구를 사용합니다. 조금 위로 스크롤해 보면, 정말로 동작했습니다 — 이게 그 파일의 내용입니다.
MCP 서버를 소비하는 이 능력은 Claude Code에 엄청난 유연성을 더하고, 정말 흥미로운 개발 기회의 문을 엽니다. 예를 들어, 여러분의 개발 흐름에 맞는 MCP 서버들을 줄줄이 붙일 수 있습니다. 프로덕션 모니터링에 Sentry를 쓴다면, Sentry MCP 서버를 붙여 Claude가 프로덕션에서 발생한 에러의 상세를 가져오게 할 수 있습니다. JIRA를 쓴다면, 특정 티켓의 내용을 Claude가 볼 수 있게 하는 MCP 서버를 더할 수 있습니다. Slack 사용자라면, Claude가 어떤 문제를 다 끝냈을 때 여러분에게 메시지를 보내도록 Slack을 붙일 수 있습니다.
이것들은 여러분이 Claude Code에 더할 수 있는 수많은 확장 가능성의 작은 일부일 뿐입니다. 여러분의 개발 워크플로를 어떻게 강화할 수 있을지 시간을 들여 고민해 볼 만합니다.
이 장에서 배우는 것What you'll learn
약 5분Claude Code에는 MCP 클라이언트가 내장 → 서버를 붙여 기능 확장
claude mcp add documents "uv run main.py" 한 줄로 연결
claude 재시작 → 새 도구를 바로 사용
테스트: fixtures의 Word/PDF를 Markdown으로 변환 → 도구가 동작
실무 확장: Sentry(프로덕션 에러)·JIRA(티켓)·Slack(완료 알림)
내 개발 흐름에 맞는 MCP 서버를 줄줄이 붙일 수 있다
Claude Code의 가장 흥미로운 면 하나는 MCP 클라이언트가 내장되어 있다는 점입니다. 덕분에 MCP 서버를 연결해 기능을 극적으로 확장할 수 있습니다. 앞서 만든 document_path_to_markdown 도구를 Claude Code에 노출하면, Claude Code가 PDF·Word 문서를 읽게 됩니다.
서버는 도구·프롬프트·리소스를 담고, 클라이언트는 그것에 접근하는 통신 다리입니다. Claude Code가 바로 그 클라이언트 역할을 해, 우리가 만든 서버의 도구를 동적으로 끌어다 씁니다.
터미널에서 한 줄이면 됩니다. claude mcp add에 이름과 서버 시작 명령을 넘기고, claude를 다시 띄우면 그 도구를 바로 쓸 수 있습니다.
claude로 다시 띄우면 서버의 도구가 노출된다.테스트 디렉터리 fixtures의 Word·PDF 데모 파일로 확인합니다 — Claude가 document_path_to_markdown 도구를 써서 내용을 변환합니다.
재시작 후, 테스트 디렉터리의 데모 파일로 확인합니다. "이 PDF를 Markdown으로 변환해 줘"라고 하면 Claude가 방금 붙인 도구를 호출합니다.
# claude 재시작 후, 데모 파일로 도구를 테스트 # test/fixtures 에 Word 문서 1 + PDF 문서 1 (MCP 설명 담김) > test/fixtures 안의 PDF 파일 내용을 Markdown으로 변환해 줘. # → Claude가 document_path_to_markdown 도구를 호출 # → 변환된 Markdown 내용이 출력됨 (정상 동작 확인)
MCP 서버를 소비하는 능력은 Claude Code에 큰 유연성을 더합니다. 내 개발 흐름에 맞춰 여러 서버를 붙일 수 있습니다.
프로덕션 모니터링. MCP 서버를 붙이면 Claude가 프로덕션에서 난 에러의 상세를 직접 가져와 분석·수정을 돕습니다.
이슈 트래킹. 특정 티켓의 내용을 Claude가 읽어, 요구사항을 반영해 작업하도록 연결할 수 있습니다.
팀 메신저. Claude가 어떤 문제를 다 끝냈을 때 여러분에게 메시지로 알리도록 붙일 수 있습니다.
이는 가능한 확장의 작은 일부일 뿐입니다. 내 개발 워크플로를 어떻게 강화할지 고민하며 필요한 서버를 골라 붙이세요.
claude mcp add documents "uv run main.py" → claude 재시작 → 도구 사용.Q1Claude Code에 MCP 서버를 붙이는 명령은?
예: claude mcp add documents "uv run main.py". 이름은 자유, 뒤에 서버를 시작하는 명령을 넣습니다.
Q2Claude Code가 MCP 서버를 붙여 쓸 수 있는 이유는?
클라이언트는 서버의 도구·리소스에 접근하는 다리입니다. Claude Code가 그 클라이언트라 서버를 붙여 도구를 쓸 수 있습니다.
Q3다음 중 MCP 확장의 실무 예가 아닌 것은?
Sentry·JIRA·Slack은 MCP 서버로 붙이는 실무 확장 예입니다. 온도 설정은 MCP 확장과 무관합니다.
두 앱을 통해 에이전트의 실제 모습을 봤습니다. 이제 에이전트와 워크플로를 본격적으로 정리합니다. → 에이전트와 워크플로
전 코스는 계속 무료입니다. 등록하면 이 코스의 남은 76개 레슨을 끝까지 읽을 수 있습니다.
이미 등록하셨다면 그때 쓰신 이메일을 넣어 주세요.