concord-mcp

작동 확인

서로 다른 하네스에 있는 두 에이전트가 서로를 발견하고, 메시지를 교환하고, 사람이 그 사이에서 컨텍스트를 전달하지 않고도 작업을 분담할 수 있습니다:

Claude Code → Concord   Claim src/app/page.tsx
Codex       → Concord   Claim src/app/page.tsx
Concord     → Codex     Overlap: Claude Code already owns this file
Codex       → Claude    I'll take src/app/api instead. Does that work?
Claude      → Codex     Yes. I'll keep the page and use your API contract.

실제 Claude Code ↔ Codex 데모를 실행하여 두 에이전트가 실시간 프롬프트/응답을 통해 중복 클레임을 해결하고, 플레이 가능한 앱을 만들고, 소유권을 이전하고, 결과를 독립적인 검토자에게 넘기는 과정을 지켜보세요.

Related MCP server: ccg-mcp-tool

빠른 시작

npm install -g @concord-ai/concord-mcp
cd /path/to/your/repository
concord setup

에이전트 클라이언트를 다시 시작한 다음, 두 에이전트에게 같은 저장소에서 작업하도록 요청하세요. Concord는 그들에게 공유 작업 공간을 제공하고, 도달 가능한 세션을 직접 프롬프트와 응답에 사용할 수 있게 합니다.

concord setup은 로컬 .concord/ 작업 공간을 만들고, Claude, Cursor, Gemini, Grok, Codex용 MCP 서버를 등록하며(.mcp.json, .cursor/mcp.json, .gemini/settings.json, .grok/config.toml, ~/.codex/config.toml), Concord의 도구 지침을 클라이언트 구성(CLAUDE.md, AGENTS.md, .codex/, .cursor/rules/)에 작성합니다. 기존 구성을 대체하지 않고 병합하며, 다시 실행해도 안전합니다.

설정은 또한 지원되는 클라이언트를 감지하고 해당 전역 Concord 어댑터를 독립적으로 설치하려고 시도합니다. 이 단계를 건너뛰려면 --no-adapters를 사용하거나, 지원이 저하된 경우 실패해야 하는 관리형 설치에서는 --require-adapters를 사용하세요. MCP 등록을 직접 관리하면서 작업 공간과 지침만 작성하려면 --no-mcp를 전달하세요.

지원 에이전트

보편적인 /concord 슬래시 명령은 없습니다 — 명령은 클라이언트별로 다릅니다. Concord는 MCP 도구와 설치된 지침을 통해 모든 MCP 지원 클라이언트에서 작동합니다.

실시간 전달은 수신 하네스와 세션 상태에 따라 달라집니다. concord adapters status를 실행하여 설치된 에이전트 중 어떤 것이 도달 가능한지, 메시지가 어떻게 전달될지 확인하세요.

커뮤니케이션이 출발점입니다

메시징은 에이전트가 대화를 시작하게 합니다. Concord의 공유 작업 상태는 메시지가 전달된 후에도 결과적인 협업을 안정적으로 유지합니다.

Concord는 또 다른 자율 에이전트나 오케스트레이터가 아닙니다. 에이전트 주변의 공유 레이어입니다: 존재, 메시징, 작업 메모리, 소유권, 인계, 검토 상태를 하나의 작은 MCP 서버로 제공합니다.

도구

쓰기 작업은 agent_id를 허용하며, 작업만으로도 존재를 활성 상태로 유지합니다. inspect_work는 누가 여기 있는지 보여주고 오래된 클레임을 표시합니다 — 소유 에이전트가 인계 없이 사라진 활성 클레임.

에이전트 간 실시간 통신을 위해 concord setup을 실행한 다음 기존 클라이언트 세션을 한 번 다시 시작하세요. 프롬프트는 update_work를 operation: "prompt", 대상 to_agent_id, 내용, idempotency_key와 함께 사용합니다. 응답은 operation: "reply"와 reply_to_message_id를 사용합니다. 영수증을 제공하는 어댑터는 바쁜 턴을 조정하거나 유휴 턴을 시작합니다. 훅 전용 통합은 지속적인 풀 메시지를 남기고 결과에 그 제한을 명시합니다. 명명된 에이전트에 도달 가능한 엔드포인트가 없으면 전달은 즉시 실패합니다. Concord는 조용히 경로를 변경하지 않습니다.

concord adapters status는 각 하네스를 별도로 보고합니다. 모니터/컨트롤러 종류, 확인된 도달 가능성, 필요한 조치, 버전 프로브 결과를 포함합니다. concord adapters install, doctor, uninstall은 저장소 설정 외부에서 동일한 전역 수명 주기를 제공합니다.

Concord는 저장소 작업 공간을 자동으로 해석합니다. 작업은 workspace_id와 저장소 루트를 반환하므로 클라이언트가 잘못 라우팅된 호출을 감지할 수 있습니다. 하나의 서버가 여러 루트를 조정할 때 id를 명시적으로 전달할 수 있습니다.

수명 주기 변경 작업은 작업의 단조 version을 expected_version으로 사용합니다. 두 에이전트가 같은 버전에 대해 작업하면 첫 번째 전환만 성공합니다. 할당은 명명된 에이전트가 transfer_work를 action: "accept"로 사용할 때까지 작업을 assigned 상태로 유지합니다. 인계 제안도 수신자가 수락할 때까지 소유권을 보낸 사람에게 유지합니다. 모든 소유권 변경은 추가 전용 감사 기록에 보존됩니다.

제공되는 것

SQLite는 로컬 진실의 원천이며, 작업이 발생하는 저장소의 루트에 있는 .concord/에 보관됩니다. MCP 서버는 CONCORD_REPO_ROOT가 설정된 경우 그 루트를 해석하고, 그 다음 Claude Code의 CLAUDE_PROJECT_DIR(Claude Code가 자동으로 설정, 사용자 범위 서버에서도), 그 다음 작업 디렉토리를 사용합니다 — 따라서 한 저장소의 모든 에이전트가 하나의 저장소를 공유합니다. 서버가 저장소 내부에 없는 작업 디렉토리에서 실행될 때 CONCORD_REPO_ROOT를 설정하세요.

연결된 Git 워크트리는 Git의 commondir 메타데이터를 따라 기본 체크아웃으로 이동하므로, 기본 체크아웃과 모든 연결된 워크트리는 의도적으로 하나의 Concord 데이터베이스와 작업 공간 id를 공유합니다.

명시적 작업 공간 선택을 제한하려면 CONCORD_ALLOWED_ROOTS를 허용된 저장소 루트의 경로 구분 목록으로 설정하세요. 허용 목록이 없어도 디코딩된 루트는 존재하고 디렉토리여야 합니다.

concord setup은 저장소의 .gitignore에 .concord/를 추가하므로 생성된 작업 공간은 기본적으로 로컬로 유지됩니다. PR에서 선택한 아티팩트를 원하는 팀은 해당 규칙을 제거하거나 사람이 읽을 수 있는 파일을 강제로 추가할 수 있습니다:

.concord/
├── concord.db          local source of truth
├── HANDOFF.md          human-readable handoff
├── REVIEW_PACKET.md    review-ready evidence
└── WORK_STATE.json     generated export (optional)

CLI

Concord는 타입이 지정된 MCP 도구와 일반 CLI를 모두 지원합니다. MCP 지원 에이전트는 도구를 직접 호출할 수 있습니다. 인간과 CLI 지향 에이전트는 concord 명령을 통해 동일한 공유 작업 공간을 사용할 수 있습니다.

concord setup                # set up local state, instructions, and MCP clients
concord status               # roster, active work, overlaps, stale claims, review-ready
concord dashboard            # live, keyboard-driven view of agents, tasks, alerts, and activity
concord who                  # which agents are present and what they are working on
concord tasks                # list all tracked tasks
concord handoff <task-id>    # print the latest handoff
concord review-packet <id>   # print the latest review packet
concord export markdown      # regenerate .concord/ artifacts
concord doctor               # workspace checks + per-task tool adoption
concord adapters status      # global harness delivery capability matrix

concord --repo ../project status        # select by repository path from anywhere
concord --workspace ws_... status       # select an id returned by a Concord operation

--repo와 --workspace는 전역 상호 배타적 옵션입니다. CLI는 MCP와 동일한 CONCORD_REPO_ROOT → CLAUDE_PROJECT_DIR → 작업 디렉토리 우선순위와 동일한 연결된 워크트리 정규화를 사용합니다.

concord dashboard는 읽기 전용, 전체 화면 로컬 TUI입니다. 공유 SQLite 작업 공간에서 매초 새로 고쳐지며 에이전트, 작업, 알림, 컨텍스트, 타임라인을 고정된 터미널 뷰포트에 유지합니다. Tab으로 창을 전환하고, j/k 또는 화살표 키로 작업을 선택하고, /로 필터링하고, ?로 도움말을 보며, q로 종료합니다.

업그레이드

npm install -g @concord-ai/concord-mcp@latest
concord --version

Concord는 매일 확인하고 CLI, MCP 도구, 대시보드에서 사용 가능한 업데이트를 표시합니다. concord setup은 확인 후 업데이트를 설치할 수 있으며, CONCORD_NO_UPDATE_CHECK=1은 확인을 비활성화합니다.

이것이 무엇인지 / 아닌지

동일한 로컬 체크아웃을 사용하는 코딩 에이전트를 위한 공유 작업 상태 및 작업 메모리. 아닌 것: 오케스트레이터, 코드 검토자, 호스팅 동기화 서비스, 메모리 벡터 DB, 자율 코딩 에이전트.

참조: 왜 마크다운만 사용하지 않나요?

기여

CONTRIBUTING.md와 CLAUDE.md를 참조하세요. 이 저장소는 엄격한 타입(any 없음, 타입 캐스트 없음)과 모듈식입니다. 좋은 첫 이슈는 good first issue로 표시되어 있습니다.

스타 기록

개인정보 및 원격 측정

Concord는 제품 및 조정 원격 측정 데이터를 getconcord.ai로 전송합니다. 여기에는 무작위 설치/호출 식별자, 설치별 비가역적 워크스페이스 및 작업 흐름 가명, Concord/Node/플랫폼 버전, 정규화된 클라이언트 메타데이터, 작업 이름·결과·기간, 집계된 중복/편집 가드 결과, 메시지 전달 단계 및 지연 시간, 작업 수명 주기 전환 및 경과 시간, 그리고 명시적으로 보고된 승인·통합·인적 개입·재작업 결과가 포함됩니다.

Concord는 코드, 원시 파일 또는 저장소 경로, 원격 저장소, 사용자 이름, 원시 작업 또는 에이전트 식별자, 메시지 식별자 또는 내용, 명령 인수, 도구 입력/출력, 작업 내용을 절대 전송하지 않습니다. 수신 서버는 요청 IP 주소를 저장하고 국가 코드를 파생/저장합니다. 이러한 서버 측 필드에는 현재 자동 만료가 없습니다. 원격 측정을 비활성화하려면 CONCORD_TELEMETRY_DISABLED=1(또는 DO_NOT_TRACK=1)을 설정하세요. 전송은 최선의 노력(best effort)으로 이루어지며 Concord 작업이 실패하게 만들 수 없습니다.

라이선스

MIT