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，以便在支持降级时失败。传递 --no-mcp 仅写入工作区和说明，同时自行管理 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。如果两个代理对同一版本进行操作，只有第一个转换会成功。分配将工作保留在 assigned 状态，直到指定代理使用 transfer_work 且 action: "accept"；交接提议同样将所有权保留在发送方，直到接收方接受。每次所有权变更都会保留在仅追加的审计历史中。

你会得到什么

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 会将 .concord/ 添加到仓库的 .gitignore 中，因此生成的工作区默认保持本地。希望在 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)

命令行

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 可禁用检查。

这是什么 / 不是什么

为使用同一本地检出的编码代理提供共享工作状态和任务记忆。不是编排器、代码审查器、托管同步服务、记忆向量数据库或自主编码代理。

另请参阅：为什么不仅仅使用 Markdown？

贡献

参见 CONTRIBUTING.md 和 CLAUDE.md。此仓库严格类型化（无 any，无类型转换）且模块化。好的入门问题标记为 good first issue。

Star 历史

隐私与遥测

Concord 会将产品和协调遥测数据发送至 getconcord.ai。这些数据包括随机的安装/调用标识符；不可逆的按安装工作区和任务流假名；Concord/Node/平台版本；标准化客户端元数据；操作名称、结果和持续时间；聚合的重叠/编辑保护结果；消息投递阶段和延迟；任务生命周期转换和耗时；以及明确上报的验收、集成、人工干预和返工结果。

Concord 绝不会发送代码、原始文件或仓库路径、远程地址、用户名、原始任务或代理标识符、消息标识符或内容、命令参数、工具输入/输出或任务内容。接收服务器会存储请求 IP 地址，并推导/存储国家代码。这些服务器端字段目前没有自动过期机制。设置 CONCORD_TELEMETRY_DISABLED=1（或 DO_NOT_TRACK=1）可禁用遥测。投递为尽力而为，绝不会导致 Concord 操作失败。

许可证

MIT