concord-mcp

In Aktion sehen

Zwei Agenten in verschiedenen Umgebungen können sich gegenseitig entdecken, Nachrichten austauschen und Arbeit aufteilen, ohne dass ein Mensch Kontext zwischen ihnen übermittelt:

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.

Führen Sie die echte Claude Code ↔ Codex Demo aus, um zu sehen, wie beide Agenten einen überlappenden Anspruch durch eine Live-Prompt/Antwort auflösen, eine spielbare App erstellen, das Eigentum übertragen und das Ergebnis einem unabhängigen Prüfer übergeben.

Related MCP server: ccg-mcp-tool

Schnellstart

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

Starten Sie Ihre Agent-Clients neu und bitten Sie dann zwei davon, im selben Repository zu arbeiten. Concord gibt ihnen einen gemeinsamen Arbeitsbereich und macht erreichbare Sitzungen für direkte Prompts und Antworten verfügbar.

concord setup erstellt den lokalen .concord/-Arbeitsbereich, registriert den MCP-Server für Claude, Cursor, Gemini, Grok und Codex (.mcp.json, .cursor/mcp.json, .gemini/settings.json, .grok/config.toml und ~/.codex/config.toml) und schreibt Concords Tool-Anweisungen in Ihre Client-Konfigurationen (CLAUDE.md, AGENTS.md, .codex/, .cursor/rules/). Es führt in bestehende Konfigurationen zusammen, anstatt sie zu ersetzen, und kann sicher erneut ausgeführt werden.

Das Setup erkennt außerdem unterstützte Clients und versucht, deren globale Concord-Adapter unabhängig zu installieren. Verwenden Sie --no-adapters, um diesen Schritt zu überspringen, oder --require-adapters in verwalteten Installationen, die bei eingeschränkter Unterstützung fehlschlagen sollen. Übergeben Sie --no-mcp, um nur den Arbeitsbereich und die Anweisungen zu schreiben, während Sie die MCP-Registrierung selbst verwalten.

Unterstützte Agenten

Es gibt keinen universellen /concord-Slash-Befehl – Befehle sind clientspezifisch. Concord funktioniert über MCP-Tools plus die installierten Anweisungen auf jedem MCP-fähigen Client.

Die Live-Zustellung hängt von der empfangenden Umgebung und dem Sitzungszustand ab. Führen Sie concord adapters status aus, um zu sehen, welche installierten Agenten erreichbar sind und wie Nachrichten zugestellt werden.

Kommunikation ist der Ausgangspunkt

Messaging bringt Agenten ins Gespräch. Concords gemeinsamer Arbeitszustand hält die resultierende Zusammenarbeit nach der Zustellung der Nachricht zuverlässig.

Concord ist kein weiterer autonomer Agent oder Orchestrator. Es ist die gemeinsame Ebene um Ihre Agenten: Präsenz, Messaging, Aufgaben-Gedächtnis, Eigentum, Übergaben und Überprüfungszustand über einen kleinen MCP-Server.

Die Tools

Schreibvorgänge akzeptieren eine agent_id, die die Präsenz allein durch Arbeiten am Leben hält. inspect_work zeigt wer hier ist und kennzeichnet veraltete Ansprüche – einen aktiven Anspruch, dessen besitzender Agent gegangen ist, ohne zu übergeben.

Für Live-Agent-zu-Agent-Kommunikation führen Sie concord setup aus und starten Sie dann bestehende Client-Sitzungen einmal neu. Ein Prompt verwendet update_work mit operation: "prompt", der Ziel-to_agent_id, Inhalt und einem idempotency_key; eine Antwort verwendet operation: "reply" und reply_to_message_id. Ein quittungsfähiger Adapter steuert einen beschäftigten Turn oder startet einen müßigen Turn. Nur-Hook-Integrationen hinterlassen eine dauerhafte Pull-Nachricht und geben diese Einschränkung im Ergebnis an. Die Zustellung schlägt sofort fehl, wenn der genannte Agent keinen erreichbaren Endpunkt hat; Concord leitet nicht stillschweigend um.

concord adapters status meldet jede Umgebung separat, einschließlich ihrer Monitor/Controller-Art, verifizierter Erreichbarkeit, erforderlicher Aktion und Versions- Sondierungsergebnis. concord adapters install, doctor und uninstall bieten den gleichen globalen Lebenszyklus außerhalb des Repository-Setups.

Concord löst den Repository-Arbeitsbereich automatisch auf. Operationen geben dessen workspace_id und Repository-Wurzel zurück, sodass ein Client einen fehlgeleiteten Aufruf erkennen kann; die ID kann explizit übergeben werden, wenn ein Server mehrere Wurzeln koordiniert.

Lebenszyklusändernde Operationen verwenden die monotone version der Aufgabe als expected_version. Wenn zwei Agenten auf derselben Version handeln, gelingt nur der erste Übergang. Die Zuweisung lässt die Arbeit in assigned, bis der genannte Agent transfer_work mit action: "accept" verwendet; ein Übergabeangebot behält ebenfalls das Eigentum beim Sender, bis der Empfänger akzeptiert. Jede Eigentumsänderung wird in einem append-only Audit-Verlauf aufbewahrt.

Was Sie bekommen

SQLite ist die lokale Quelle der Wahrheit, aufbewahrt im .concord/ an der Wurzel des Repos, in dem die Arbeit stattfindet. Der MCP-Server löst diese Wurzel aus CONCORD_REPO_ROOT auf, falls gesetzt, dann aus Claude Codes CLAUDE_PROJECT_DIR (das Claude Code automatisch setzt, auch für einen benutzerbezogenen Server), dann aus seinem Arbeitsverzeichnis – so teilen sich alle Agenten in einem Repo einen Speicher. Setzen Sie CONCORD_REPO_ROOT, wenn Sie den Server an einem Ort ausführen, dessen Arbeitsverzeichnis nicht im Repo liegt.

Verknüpfte Git-Worktrees folgen den commondir-Metadaten von Git zum primären Checkout, sodass der Haupt-Checkout und alle verknüpften Worktrees absichtlich eine Concord-Datenbank und Workspace-ID teilen.

Um die explizite Workspace-Auswahl einzuschränken, setzen Sie CONCORD_ALLOWED_ROOTS auf eine pfadgetrennte Liste erlaubter Repository-Wurzeln. Ohne Allowlist müssen dekodierte Wurzeln weiterhin existieren und Verzeichnisse sein.

concord setup fügt .concord/ zur .gitignore des Repositorys hinzu, sodass der generierte Arbeitsbereich standardmäßig lokal bleibt. Teams, die ausgewählte Artefakte in PRs wünschen, können diese Regel entfernen oder die menschenlesbaren Dateien per Force-Add hinzufügen:

.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 unterstützt sowohl typisierte MCP-Tools als auch eine reguläre CLI. MCP-fähige Agenten können die Tools direkt aufrufen; Menschen und CLI-orientierte Agenten können mit demselben gemeinsamen Arbeitsbereich über concord-Befehle arbeiten.

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 und --workspace sind globale, sich gegenseitig ausschließende Optionen. Die CLI verwendet dieselbe CONCORD_REPO_ROOT → CLAUDE_PROJECT_DIR → Arbeitsverzeichnis-Priorität und dieselbe verknüpfte Worktree-Kanonisierung wie MCP.

concord dashboard ist eine schreibgeschützte, Vollbild-lokale TUI. Sie aktualisiert sich jede Sekunde aus dem gemeinsamen SQLite-Arbeitsbereich und hält Agenten, Aufgaben, Warnungen, Kontext und Zeitachse in einem festen Terminal-Viewport. Verwenden Sie Tab, um Bereiche zu wechseln, j/k oder die Pfeiltasten, um Arbeit auszuwählen, / zum Filtern, ? für Hilfe und q zum Beenden.

Upgrade

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

Concord prüft täglich und zeigt verfügbare Updates in der CLI, den MCP-Tools und dem Dashboard an; concord setup kann eines mit Bestätigung installieren, und CONCORD_NO_UPDATE_CHECK=1 deaktiviert die Prüfungen.

Was dies ist / nicht ist

Gemeinsamer Arbeitszustand und Aufgaben-Gedächtnis für Coding-Agenten, die denselben lokalen Checkout verwenden. Kein Orchestrator, Code-Reviewer, gehosteter Sync-Dienst, Speicher- Vektor-DB oder autonomer Coding-Agent.

Siehe auch: Warum nicht einfach Markdown?

Mitwirken

Siehe CONTRIBUTING.md und CLAUDE.md. Dieses Repo ist streng typisiert (kein any, keine Typecasts) und modular. Gute erste Aufgaben sind mit good first issue gekennzeichnet.

Stern-Verlauf

Datenschutz & Telemetrie

Concord sendet Produkt- und Koordinationstelemetrie an getconcord.ai. Dazu gehören zufällige Installations-/Aufruf-Identifikatoren; irreversible Installations-, Workspace- und Task-Flow-Pseudonyme; Concord-/Node-/Plattform-Versionen; normalisierte Client- Metadaten; Operationsnamen, -ergebnisse und -dauern; aggregierte Überlappungs-/Bearbeitungsschutz- Ergebnisse; Nachrichtenzustellungsstufen und -latenzen; Task-Lebenszyklusübergänge und verstrichene Zeiten; sowie explizit gemeldete Akzeptanz-, Integrations-, menschliche Eingriffs- und Nacharbeitsergebnisse.

Concord sendet niemals Code, rohe Datei- oder Repository-Pfade, Remotes, Benutzernamen, rohe Task- oder Agenten-Identifikatoren, Nachrichten-IDs oder -inhalte, Befehlsargumente, Tool-Eingaben/-Ausgaben oder Task-Inhalte. Der empfangende Server speichert die Anfrage-IP-Adresse und leitet daraus ein Ländercode ab/speichert ihn. Diese serverseitigen Felder haben derzeit keinen automatischen Ablauf. Setzen Sie CONCORD_TELEMETRY_DISABLED=1 (oder DO_NOT_TRACK=1), um Telemetrie zu deaktivieren. Die Zustellung erfolgt nach bestem Bemühen und kann niemals dazu führen, dass eine Concord-Operation fehlschlägt.

Lizenz

MIT