claude mcp serve 완전 가이드

Claude Code를 MCP 서버로 기동하여 멀티 에이전트 구성

claude mcp serve를 사용하여 Claude Code 자체를 MCP 서버로 기동하고, 다른 클라이언트에서 이용하는 방법을 이해합니다. MCP의 양방향성을 체감하고, 멀티 에이전트 구성의 기반을 구축합니다.

배경 지식

Claude Code의 이중성

이전 장에서는 Claude Code를 MCP 클라이언트로 사용해왔습니다. 즉, 외부의 MCP 서버에 접속하여 툴을 호출하는 쪽이었습니다.

그러나 Claude Code는 claude mcp serve 커맨드에 의해 MCP 서버로도 동작할 수 있습니다.

이전까지 (클라이언트로서):

이번 장 (서버로서):

claude mcp serve란

claude mcp serve는 Claude Code의 기능(파일 편집, 코드 생성, 코드 분석 등)을 MCP 서버로서

외부에 공개하는 커맨드입니다. 이로 인해, 다른 MCP 클라이언트(IDE 확장, 별도의 AI 에이전트 등)에서 Claude Code의 능력을 호출할 수 있습니다.

활용 시나리오

※ 한국 개발 환경에서의 활용 예시
- GitHub Actions 연동: PR이 생성될 때 Claude Code MCP 서버를 자동 호출하여 코드 리뷰를 수행
- Cursor/VSCode 통합: 에디터 안에서 Claude Code의 분석 능력을 MCP로 호출
- AI 오케스트레이션: LangChain이나 자체 제작 AI 파이프라인에서 Claude Code를 하나의 에이전트로 통합

따라하기

1단계: claude mcp serve의 기본 기동

Claude Code를 MCP 서버로 기동합니다.

claude mcp serve

기대되는 동작:

서버가 기동하고, stdin/stdout으로 MCP 프로토콜의 메시지를 대기하는 상태가 됩니다.

stdio 트랜스포트로 동작하므로, 표준 입출력 경유로 통신합니다.

주의: claude mcp serve는 포어그라운드에서 동작합니다. 별도의 터미널을 열어 작업을 계속하세요. 서버를 정지하려면 Ctrl+C를 사용합니다.

터미널 운용 방침:

2단계: 서버로서 제공되는 툴의 확인

claude mcp serve로 기동된 Claude Code는, 다음과 같은 기능을 MCP 툴로서 제공합니다.

파일의 읽기·쓰기

코드 분석·생성

프로젝트 구조의 이해