Concord MCP – AI 코딩 에이전트를 위한 공유 작업 상태

정의 – 여러 AI 기반 코딩 어시스턴트(Claude Code, Codex, Cursor, Gemini CLI, Grok Build, Goose, GitHub Copilot CLI 등)가 동일한 코드베이스에서 작업하는 동안 서로 통신할 수 있게 해주는 오픈 소스, 로컬 우선 조정 계층입니다. 로컬 SQLite DB를 백엔드로 하는 작은 MCP(Message-Passing Control Protocol) 서버를 실행하고 도구 세트(start_work, inspect_work, update_work, transfer_work, finish_work)와 친숙한 CLI를 제공합니다.

중요성 – 공유 계층이 없으면 각 어시스턴트는 격리되어 작동하여 중복 편집, 숨겨진 충돌, 컨텍스트 손실로 이어집니다. Concord는 에이전트가 파일을 주장하고, 편집 전에 중복을 감지하고, 프롬프트/응답을 교환하고, 작업을 인계하고, 나중에 검토할 증거를 첨부할 수 있는 공통 "작업 공간"을 제공합니다.

빠른 시작 (README에서)

# 전역 CLI 패키지 설치
npm install -g @concord-ai/concord-mcp

# 에이전트가 공유하려는 리포지토리로 이동
cd /path/to/your/repo

# 로컬 Concord 작업 공간 설정 및 MCP 서버 등록
concord setup

concord setup 은 숨겨진 .concord/ 디렉토리를 만들고, 지원되는 각 에이전트에 대한 MCP 구성 파일을 작성하고, (선택적으로) 에이전트가 서버에 도달할 수 있는 작은 "어댑터" 바이너리를 설치합니다. 안전하게 다시 실행할 수 있으며 사용자가 작업하는 모든 리포지토리에 Concord를 등록하는 전역 모드도 지원합니다.

핵심 개념 및 도구

도구	기능
`start_work`	에이전트가 존재를 알리고, 파일/모듈을 주장하고, 기존 주장에 대해 경고를 받습니다.
`inspect_work`	현재 작업 공간 상태를 읽고, 존재하는 에이전트를 나열하고, 오래된 주장을 표시하거나 지속적인 프롬프트/응답 스레드를 가져옵니다.
`update_work`	다른 에이전트에게 프롬프트를 보내거나 보류 중인 메시지에 응답합니다.
`transfer_work`	작업을 제공, 수락, 거부 또는 재할당합니다 – 인계의 기초입니다.
`finish_work`	작업을 완료로 표시하고 증거를 첨부합니다 (예: `HANDOFF.md`, `REVIEW_PACKET.md`).

모든 작업은 버전으로 보호됩니다. 동일한 작업 버전에 대한 동시 업데이트는 직렬화되고 모든 변경 사항은 추가 전용 감사 로그에 저장됩니다.

지원되는 에이전트 (README 기준)

Claude Code
Codex
Cursor
Gemini CLI
Grok Build
Goose
Google Antigravity
GitHub Copilot CLI
기타 MCP 지원 코딩 어시스턴트 (일반 MCP 도구 사용)

각 에이전트에는 Concord 어댑터가 에이전트 구성에 필요한 지침 파일을 주입하는 방법을 설명하는 짧은 통합 가이드 (예: docs/claude-code.md)가 있습니다.

일반적인 워크플로우

설정 – 리포지토리(또는 전역)에서 concord setup 을 실행합니다. .concord/ 폴더에는 이제 concord.db (SQLite 소스 오브 트루스)와 몇 가지 사람이 읽을 수 있는 아티팩트가 포함됩니다.
주장 – 에이전트 A가 start_work 를 호출하여 src/app/page.tsx 를 주장합니다. Concord가 주장을 기록합니다.
중복 감지 – 에이전트 B도 같은 파일을 원합니다. start_work 호출은 중복 경고를 반환합니다.
협상 – 에이전트 B는 update_work 를 operation: "prompt" 와 함께 사용하여 에이전트 A에게 다른 모듈을 가져가도록 요청합니다. 에이전트 A는 update_work 를 operation: "reply" 로 응답합니다.
인계 – 작업 분담이 정해지면 transfer_work 를 사용하여 새 모듈을 에이전트 B에게 공식적으로 할당합니다.
완료 – 작업이 완료된 후 finish_work 가 REVIEW_PACKET.md 를 저장하고 작업을 종료로 표시합니다.
검사 – 인간은 concord dashboard 또는 concord status 를 실행하여 누가 무엇을 작업 중인지, 오래된 주장, 검토 준비가 된 패킷을 볼 수 있습니다.

CLI 스냅샷 (선택된 명령)

concord status               # 에이전트, 작업, 중복 개요
concord dashboard            # 활동의 라이브 TUI 보기
concord who                  # 존재하는 에이전트와 현재 주장을 나열
concord tasks                # 추적된 모든 작업을 열거
concord handoff <task-id>    # 최신 핸드오프 문서 표시
concord review-packet <id>    # 작업에 대한 검토 패킷 표시
concord check <files...>     # 나열된 파일이 다른 활성 작업에 의해 주장된 경우 exit 1 (CI 훅에 유용)
concord adapters status      # 도달 가능한 어댑터가 설치된 에이전트 표시

CLI는 MCP 도구를 미러링하므로 스크립트나 다른 에이전트가 HTTP/JSON 또는 Node 패키지를 통해 동일한 작업을 호출할 수 있습니다.

지속성 및 작업 공간 레이아웃

.concord/
├─ .gitignore          # 모든 것을 캐치하여 작업 공간을 로컬로 유지
├─ concord.db          # SQLite DB – 단일 소스 오브 트루스
├─ HANDOFF.md         # 마지막 전송에 대한 사람이 읽을 수 있는 핸드오프 요약
├─ REVIEW_PACKET.md   # 검토자를 위한 증거 패키지
├─ events.jsonl       # 도구 이벤트의 시간순 로그 (줄당 하나의 JSON)
└─ WORK_STATE.json    # 현재 작업 상태의 내보낸 스냅샷

DB는 리포지토리 루트(또는 "전역 모드"의 경우 전역 위치)에 있습니다. 연결된 Git 워크트리는 동일한 DB를 공유하여 여러 체크아웃에서 일관된 조정을 보장합니다.

텔레메트리 및 개인정보 보호

Concord는 익명 사용 텔레메트리 를 getconcord.ai 로 보냅니다(설치 ID, 버전 번호, 작업 이름, 지연 시간 등) 그러나 소스 코드, 파일 경로, 원시 메시지 또는 개인 식별자를 전송하지 않습니다. 텔레메트리는 CONCORD_TELEMETRY_DISABLED=1 또는 DO_NOT_TRACK=1 로 비활성화할 수 있습니다.

이것은 아닙니다

자율 코딩 에이전트 또는 오케스트레이터가 아닙니다.
호스팅 동기화 서비스가 아닙니다. 모든 것이 로컬에서 실행됩니다.
LLM을 위한 벡터 저장소 또는 메모리 DB가 아닙니다.
코드 검토 도구를 대체하지 않습니다. 다운스트림 검토자를 위한 증거를 패키징할 뿐입니다.

라이선스

MIT (LICENSE 참조).

결론 – Concord MCP는 여러 AI 코딩 어시스턴트에게 공유되고 충돌 인식 작업 공간을 제공하는 가볍고 로컬 호스팅 조정 서버입니다. 에이전트가 작업을 주장하고, 중복을 감지하고, 프롬프트를 교환하고, 인간이 중개자 역할을 하지 않고도 작업을 인계할 수 있게 하면서 발생한 일에 대한 지속적이고 쿼리 가능한 기록을 유지합니다.

Get-Concord-AI/concord-mcp