Claude Peers MCP: Claude Code 인스턴스 간 실시간 협업의 시작

Claude Peers MCP 데모

개발자 Louis Arge가 흥미로운 프로젝트를 공개했습니다. Claude Peers MCP는 여러 Claude Code 인스턴스가 서로 직접 대화할 수 있게 해주는 MCP 서버입니다.

한 에이전트는 API를 만들고, 다른 에이전트는 프론트를 개발하면서 인터페이스를 자동으로 맞춰가는 시나리오가 가능해집니다. 기존 “agent teams” 방식과 달리 사전 설정 없이도 자연스럽게 협업이 가능하다는 점이 특징입니다.

왜 주목해야 할까요?

지금까지 멀티 에이전트 협업은 두 가지 방식이 있었습니다.

오케스트레이터 방식 — 중앙에서 작업을 분배하고 조율
사전 정의된 팀 — 역할과 책임을 미리 설정

두 방식 모두 강력하지만, 설정 비용이 큽니다. 팀 구조를 정의하고, 역할을 할당하고, 통신 프로토콜을 설정해야 합니다.

Claude Peers MCP는 다른 접근을 취합니다. **“그냥 서로 말하게 하자”**는 것입니다.

아키텍처 다이어그램

핵심 컨셉: Ad-hoc 에이전트 통신

Claude Peers MCP의 핵심은 **발견(Discovery)**과 실시간 메시징입니다.

발견

같은 머신에서 실행 중인 모든 Claude Code 세션을 자동으로 찾습니다. 각 세션은:

작업 디렉토리
Git 레포지토리
현재 작업 중인 내용 요약

을 공유합니다. 다른 에이전트가 list_peers를 호출하면 이 정보를 볼 수 있습니다.

실시간 메시징

메시지는 즉시 도착합니다. Claude Code의 channel 프로토콜을 사용해 메시지를 세션으로 푸시하기 때문입니다.

┌───────────────────────┐     ┌──────────────────────┐
│ Claude A              │     │ Claude B             │
│ "send a message to    │───> │                      │
│ peer xyz: what files  │     │ <message arrives     │
│ are you editing?"     │<─── │ instantly, Claude B  │
│                       │     │ responds"            │
└───────────────────────┘     └──────────────────────┘

아키텍처

시스템은 세 가지 컴포넌트로 구성됩니다:

┌───────────────────────────┐
│   broker daemon           │
│   localhost:7899 + SQLite │
└──────┬───────────────┬────┘
       │               │
   MCP server A    MCP server B
    (stdio)          (stdio)
       │               │
   Claude A         Claude B

컴포넌트	역할
Broker daemon	localhost:7899에서 실행, SQLite로 메시지와 피어 상태 관리
MCP server	각 Claude Code 세션마다 실행, 브로커에 등록하고 메시지 폴링
Channel	Claude Code 세션으로 메시지 푸시

브로커는 첫 세션 시작 시 자동으로 실행되며, 죽은 피어는 자동으로 정리됩니다. 모든 통신은 localhost만 사용합니다.

MCP 도구

Claude Peers MCP는 4개의 도구를 제공합니다:

도구	기능
`list_peers`	다른 Claude Code 인스턴스 목록 조회
`send_message`	특정 인스턴스에 메시지 전송
`set_summary`	작업 중인 내용 설명 (다른 피어에 표시)
`check_messages`	수동 메시지 확인 (채널 모드 미사용 시)

실제 사용 시나리오

API + 프론트 동시 개발

가장 매력적인 시나리오입니다.

Terminal 1 (API 개발):

cd ~/projects/my-api
claudepeers

Terminal 2 (프론트 개발):

cd ~/projects/my-frontend
claudepeers

이제 프론트 에이전트가 API 에이전트에게 물어볼 수 있습니다:

Send a message to peer api: "What's the endpoint for user authentication?"

API 에이전트가 응답하면, 프론트 에이전트는 그에 맞춰 코드를 작성합니다. 별도의 API 문서 없이도 인터페이스가 자동으로 맞춰집니다.

멀티 프로젝트 컨텍스트 공유

5개의 프로젝트에서 동시에 작업 중이라고 가정해봅시다. 각 프로젝트의 Claude가 서로 상태를 공유할 수 있습니다:

List all peers on this machine

결과:

Peer abc123: ~/projects/auth-service (working on JWT refresh)
Peer def456: ~/projects/payment-gateway (debugging webhook timeout)
Peer ghi789: ~/projects/frontend (implementing dashboard)

한 에이전트가 다른 에이전트에게 의존성 질문을 할 수 있습니다.

설치 및 실행

설치는 간단합니다:

# 클론
git clone https://github.com/louislva/claude-peers-mcp.git ~/claude-peers-mcp
cd ~/claude-peers-mcp
bun install

# MCP 등록 (전역)
claude mcp add --scope user --transport stdio claude-peers -- bun ~/claude-peers-mcp/server.ts

실행 시 채널 활성화가 필요합니다:

claude --dangerously-load-development-channels server:claude-peers

편의를 위해 alias를 설정하면 좋습니다:

alias claudepeers='claude --dangerously-load-development-channels server:claude-peers'

기존 Agent Teams와의 차이점

구분	Agent Teams	Claude Peers
설정	사전 설정 필요 (역할, 프로토콜)	Ad-hoc (설정 없음)
통신	오케스트레이터 경유	직접 P2P
유연성	고정 역할	동적 협업
진입 장벽	높음	낮음 (설치 후 바로 사용)
적합한 시나리오	복잡한 워크플로우	간단한 협업, 빠른 프로토타이핑

Agent Teams가 **“잘 짜인 조직”**이라면, Claude Peers는 **“옆자리 동료에게 말 걸기”**에 가깝습니다.

자동 요약 기능

OPENAI_API_KEY를 설정하면 각 인스턴스가 시작 시 자동으로 작업 요약을 생성합니다. GPT-5.4-nano를 사용하며 비용은 센트 단위입니다.

요약은 현재 디렉토리, Git 브랜치, 최근 파일을 기반으로 생성됩니다. API 키가 없으면 Claude가 직접 set_summary를 호출해 요약을 설정합니다.

CLI 도구

브로커와 피어를 CLI로 관리할 수도 있습니다:

cd ~/claude-peers-mcp

bun cli.ts status       # 브로커 상태 + 모든 피어
bun cli.ts peers        # 피어 목록
bun cli.ts send <id> <msg>  # 메시지 전송
bun cli.ts kill-broker  # 브로커 중지

요구 사항

Bun
Claude Code v2.1.80+
claude.ai 로그인 (채널 사용 — API 키 인증 불가)

마치며: 에이전트 협업의 새로운 패러다임

Claude Peers MCP는 멀티 에이전트 협업에 대한 새로운 접근을 보여줍니다.

복잡한 오케스트레이션 없이, 그냥 에이전트들이 서로 말하게 두는 것. 이 단순한 아이디어가 의외로 강력할 수 있습니다.

물론 복잡한 워크플로우에는 기존 Agent Teams 방식이 더 적합할 수 있습니다. 하지만 빠른 프로토타이핑, 간단한 협업, 혹은 “그냥 옆 에이전트한테 물어보고 싶을 때” — 이런 시나리오에서 Claude Peers MCP는 매력적인 도구입니다.

프로젝트가 방금 시작되어 아직 초기 단계지만, 342개의 스타가 빠르게 모이고 있는 것을 보면 커뮤니티의 관심이 큽니다. 앞으로 어떻게 발전할지 지켜볼 만합니다.

🔗 관련 정보

GitHub: https://github.com/louislva/claude-peers-mcp
Claude Code Channels 문서: https://code.claude.com/docs/en/channels-reference
개발자: Louis Arge