Claude Code + MCP: 개발 워크플로우 자동화
Claude Code에서 MCP 서버를 활용하는 실전 워크플로우 — claude mcp add, 에이전틱 루프, GitHub/Jira 연동, 토큰 46.9% 절약.
🔄 레슨 5에서 Python FastMCP로 나만의 MCP 서버를 만들었습니다. Claude Desktop에서 잘 돌아가죠. 근데 실제 개발 업무는 터미널에서 합니다. 여기서 Claude Code가 등장합니다.
Claude Code란?
Claude Code는 터미널에서 돌아가는 AI 코딩 도구입니다. 파일 읽기/쓰기, 명령어 실행, Git 작업을 할 수 있고 — MCP 서버까지 연결하면 외부 시스템과도 상호작용합니다.
Claude Desktop이 “대화형 AI + MCP"라면, Claude Code는 “코딩 AI + MCP"입니다. 개발 워크플로우에 MCP를 통합하는 가장 실전적인 방법입니다.
MCP 서버 추가: claude mcp add
Claude Code에서 MCP 서버를 추가하는 건 한 줄이면 됩니다:
# GitHub MCP 서버 추가
claude mcp add github -- npx -y @modelcontextprotocol/server-github
# 환경 변수가 필요한 경우
claude mcp add brave-search -e BRAVE_API_KEY=your-key -- npx -y @modelcontextprotocol/server-brave-search
# 추가된 서버 목록 확인
claude mcp list
claude_desktop_config.json을 직접 편집하지 않아도 됩니다. 명령어 하나로 서버 등록, 환경 변수 설정, 연결 확인까지 끝.
서버 범위 설정:
# 이 프로젝트에서만 사용 (기본값)
claude mcp add github --scope project -- ...
# 모든 프로젝트에서 사용
claude mcp add github --scope user -- ...
--scope project면 해당 프로젝트 디렉토리에서만, --scope user면 어디서든 사용 가능합니다.
✅ Quick Check: 팀원과 같은 MCP 서버 설정을 공유하려면 어떤 scope를 써야 할까요? (
--scope project입니다. 프로젝트별 설정은.claude/디렉토리에 저장되어 Git으로 공유할 수 있습니다.)
Tool Search: 토큰 46.9% 절약
MCP 서버를 10개 연결하면 도구가 50개 이상이 될 수 있습니다. 문제는 — 모든 도구 정의를 AI 컨텍스트에 넣으면 토큰을 엄청나게 소모한다는 겁니다.
Claude Code의 Tool Search가 이걸 해결합니다:
- 모든 도구를 미리 로드하는 대신, 도구 이름과 설명만 인덱싱
- Claude가 대화 맥락을 분석해서 “지금 필요한 도구"만 검색
- 관련 도구만 컨텍스트에 동적으로 추가
결과: 토큰 사용량 46.9% 감소. 도구가 많을수록 절감 효과가 큽니다.
에이전틱 루프: MCP의 진짜 힘
Claude Code에서 MCP가 빛나는 건 에이전틱 루프 — 여러 단계를 자동으로 반복하는 워크플로우입니다.
사용자: "이 레포의 열린 버그를 확인하고, 가장 긴급한 걸 고쳐줘"
Claude Code의 동작:
1. [컨텍스트] GitHub MCP로 열린 이슈 목록 가져옴
2. [분석] 이슈 레이블과 설명을 분석해서 우선순위 판단
3. [컨텍스트] 해당 이슈 관련 코드 파일 읽기
4. [액션] 코드 수정
5. [검증] 테스트 실행
6. [액션] PR 생성
7. [완료] 결과 보고
이 전체 과정에서 MCP 서버가 제공하는 것:
- GitHub MCP: 이슈 목록 조회, PR 생성
- Filesystem: 코드 파일 읽기/쓰기
- 테스트 도구: 결과 확인
실전 워크플로우 예제
1. 코드 리뷰 자동화
# GitHub MCP + 코드 분석
claude mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github
이제 Claude Code한테: “PR #42를 리뷰하고, 문제 있으면 코멘트 달아줘”
Claude가 MCP로 PR diff를 가져오고, 코드를 분석하고, 직접 GitHub에 리뷰 코멘트를 남깁니다.
2. 배달의민족 사례에서 배우기
우아한형제들(배달의민족) 개발팀은 2025년 MCP 해커톤에서 이런 워크플로우를 만들었습니다:
- 에러 알림 분석 에이전트: Sentry 에러 알림 → MCP로 관련 코드 검색 → 원인 분석 → 수정 제안
- 코드 리뷰 에이전트: PR 생성 시 → MCP로 코드 변경 사항 가져오기 → 자동 리뷰
핵심은 단일 도구가 아니라, 여러 MCP 서버를 조합한 “에이전트” 워크플로우를 만든 것입니다.
3. DB 스키마 기반 쿼리 작성
# PostgreSQL MCP 추가
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost/mydb
“이번 달 가입한 유저 중에서 결제 완료한 사람 비율 구해줘” — Claude가 DB 스키마를 읽고, 적절한 SQL을 작성해서 실행합니다.
✅ Quick Check: 에이전틱 루프에서 Claude Code가 ‘검증’ 단계를 수행하는 이유는? (수정한 코드가 제대로 작동하는지 확인하기 위해서입니다. 테스트 실행, 린트 체크 등으로 검증하고, 실패하면 다시 수정 → 검증을 반복합니다.)
Claude Code를 MCP 서버로 쓰기
Claude Code는 MCP 서버를 사용할 뿐 아니라, 자기 자신도 MCP 서버가 될 수 있습니다. 다른 에이전트가 Claude Code를 도구로 호출하는 것.
# Claude Code를 MCP 서버 모드로 실행
claude mcp serve
이렇게 하면 다른 MCP 호스트(예: n8n, 커스텀 에이전트)에서 Claude Code의 코딩 능력을 도구로 사용할 수 있습니다.
핵심 정리
claude mcp add한 줄로 Claude Code에 MCP 서버 추가--scope project(기본)는 프로젝트 내,--scope user는 전역 사용- Tool Search로 많은 도구를 연결해도 토큰 46.9% 절감
- 에이전틱 루프: 컨텍스트 수집 → 액션 수행 → 결과 검증 → 반복
- 실전 활용: 코드 리뷰 자동화, DB 쿼리, 에러 분석 워크플로우
- Claude Code 자체도 MCP 서버로 활용 가능
다음 레슨
MCP의 기능을 최대한 활용하는 법을 배웠습니다. 하지만 강력한 도구일수록 보안이 중요합니다. 레슨 7에서 MCP 보안 — API 키 관리, 인증, 최소 권한 원칙, 그리고 절대 하면 안 되는 것들을 다룹니다.
이해도 체크
먼저 위의 퀴즈를 완료하세요
레슨 완료!