@concord-ai/concord-mcp

中文文档
0.21.0发布于 2026/11/09MITES Module构建来源已验证近 30 天下载 3987

通过MCP为编码代理进行跨harness通信并共享工作状态.

中文使用文档
文档目录13 节
  1. 看它有用吗
  2. 快开始
  3. 支助代理人
  4. 通讯是起点
  5. 工具
  6. 你得到的东西
  7. 国 际
  8. 升级
  9. 这是不是
  10. 捐款
  11. 恒星历史
  12. 隐私和遥测
  13. 许可证

Concord MCP — shared work-state for coding agents

协和 MCP

让克洛德代码(Claude Code),克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.

AI编码代理的开源,本地第一通信和协调层. 在代理编辑前发现重叠的工作, 共享决定,并通过一个 MCP 服务器将任务与证据交接.

npm version npm downloads CI Node.js version MIT License

演示 • 妇女 快开始 • 妇女 支助代理人 • 妇女 网站 • 妇女 捐款

看它有用吗

两个不同的特工可以互相发现 交流信息, 并且将工作分割开来,没有人类的接力背景:

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 代码 QQ 代码演示 来看两个 代理通过实时即时/重播解决重叠索赔,建立可玩性 应用,转让所有权,并将结果交给独立审查员.

快开始

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

节点.js? 在 macOS 或 Linux 上, 安装自定义的构建 :

curl -fsSL https://getconcord.ai/install.sh | sh

它将自己的节点运行时间捆绑在下面 ~/.concord/standalone 将 concord 财务报告和审定财务报表 concord-mcp 内装发射器 ~/.local/bin (与 CONCORD_INSTALL_DIR 编号 : CONCORD_BIN_DIR; 用 CONCORD_VERSION) (中文(简体) ).

重新启动您的代理客户端,然后要求其中两个在同一个仓库工作. Concord 给他们一个共享的工作空间,并提供了可用的会话 直接提示和答复.

什麽 concord setup 变动

concord setup 创建本地 .concord/ 工作空间, 注册 MCP 服务器 克劳德、克索尔、双子座、格罗克和克多克克斯.mcp.json, (中文(简体) ), .cursor/mcp.json, (中文(简体) ), .gemini/settings.json, (中文(简体) ), .grok/config.toml,以及 ~/.codex/config.toml) (中文(简体) ). 对于 鹅,它登记 concord-relay 扩展 鹅的 config.yaml 当检测到。 对于 反重力写着 .agents/mcp_config.json, (中文(简体) ), .agents/hooks.json,以及 .agents/rules/concord.md它也写着 Concord 的工具指令输入您的客户端配置(CLAUDE.md, (中文(简体) ), AGENTS.md, (中文(简体) ), .codex/, (中文(简体) ), .cursor/rules/) (中文(简体) ). 它合并到现有的配置中而不是替换 它又安全地重新运行.

设置还检测到支持的客户端并试图安装其全球协和器 独立适配器. 使用 --no-adapters 跳过该步骤或 --require-adapters 在管理下的安装中,这些装置应会因退化的支助而失效. 过 --no-mcp 在管理 MCP 时只写工作空间和指令 登记自己.

随着全球模式的开启(见下文),设置将离开寄存器的指令和 仅MCP文件, 因为用户级注册已经覆盖它们; 通过 --repo-files 写他们反正, 举例来说, 给他们一个团队.

在仓库中使用协和符 您尚未设置

你第一次跑的时候 concord setup 它通过交互方式询问您的代理商 在设置从未运行(默认是)的寄存器中使用协和符。  答案保存在 ~/.concord/config.json· ; concord setup --global 或者说 --no-global 改变它.

随着全局模式的开启,协和会在每个安装的用户一级自行登记 代理和在用户指令文件中添加一个简短的 Concord 部分 (单位:千美元)~/.claude/CLAUDE.md, (中文(简体) ), ~/.codex/AGENTS.md, (中文(简体) ), ~/.gemini/GEMINI.md鹅的 .goosehints, (中文(简体) ), ~/.copilot/copilot-instructions.md; Cursor 从它的全局会话钩获得). 没什么 他们的工作被保存在 ~/.concord/global.db, (中文(简体) ), 每个寄存器有一个项目, 以其 git 远程命名为 Concord Cloud 命名它 . 任何寄存器库以外的会话共享 general 项目。 一个仓库你 摆平了一切 .concord/· ; concord setup 写着 全局模式打开时没有指令或MCP文件,除非您通过 --repo-files关闭全局模式可以完全删除它添加的内容.

协和云:不同机器上的特工

concord cloud login 把这台机器签到Concord Cloud并链接它。 A 类 连接的机器在每一个文件夹的云中工作,所以它的代理 任何机器上的探员 机器处于时没有仓库保存本地状态 链接;带有 git 远程存储器是远程项目, 一个没有 遥控器是它自己的一个项目 在这个机器上, 和任何外部 仓库是 general。 。 。 .

concord cloud unlink 将整台机器切换回本地协和器 保持登录,以及 concord cloud link 开机. concord cloud status 说哪些适用,和 concord doctor 检查链接, 并列出机器不再使用的本地状态, 并列出移动它的命令 在链接运行之前没有开始会话( 无删除) .

支助代理人

探员融合指南
克劳德代码设置和交付
代码设置和交付
光标设置和交付
双子座CLI设置和交付
Grok 构建设置和交付
鹅设置和交付
谷歌反重力设置和交付
GitHub 副驾驶 CLI设置和交付
开发CLI通过项目级别设置 concord setup
指针( Claude Code, Codex)设置和交付
任何其他 MCP 能力编码代理手动设置

没有普遍性 /concord slash命令——命令是针对客户端的. Concord 工作通过 MCP 工具加上安装在任意上的指示 MCP能力客户端.

现场直播取决于接收的绳索和会话状态. 运行 concord adapters status 以查看哪些安装的代理可以到达以及如何到达 将发送信件.

通讯是起点

消息会让特工说话 Concord的共享工作状态保留了结果 消息发送后进行可靠的合作.

无协和与协和
特工不能在另一把绳子里联络同伴代理直接发送可回复的提示到支持的客户端
编辑后代理发现相撞工作开始前代理索赔文件和模块
当会话结束时上下文会消失决定、假设和调查结果与任务有关
所有权由聊天历史所暗示转让和交割是明确和承认的
人类从树枝和树枝上重建进步审查包载有范围、测试、风险和出处

协和不是另一个自主的代理人或管弦乐家. 这是共享层 您的代理商: 存在、 信息、 任务记忆、 所有权、 交割、以及 通过一个小型的 MCP 服务器审查状态 .

工具

工具目的
start_work登记册的存在、索赔或接受一项任务,在编辑之前报告范围重叠
inspect_work读取工作空间/任务状态、代理收件箱/出件箱,或持久快件/复制线程
update_work记录任务上下文或立即提示/复制到另一个快速工作空间代理
transfer_work指定、接受、拒绝、发布、重新指定、提供交割或重开版本工作
finish_work记录证据和可选标记任务审查准备、完成或结束

写入接受一个 agent_id它通过工作来维持生存. inspect_work 显示 谁在这里 和旗帜 暂停索赔 - 活跃 声称拥有的代理人已经离开而未交出.

代理代理代理通信,运行 concord setup,然后重新启动已存在的 客户端会话一次。 即时使用 update_work 与 operation: "prompt",则 目标 to_agent_id,内容,以及 idempotency_key; 使用回复 operation: "reply" 财务报告和审定财务报表 reply_to_message_id。带有收据的适配器方向盘 忙转或开始闲转。 只靠钩子的整合留下了持久的拉力 在结果中说明这一限制。 立即交货失败 当指定代理人没有可达到的终点时; 协和不沉默 改道而来.

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_PROJECT_DIR (克劳德) 代码自动设定,即使是对一个用户范围服务器),然后它的工作 目录——所以一个repo中的每一个代理都共享一商店. 设定 CONCORD_REPO_ROOT 当运行服务器时, 它的工作目录不在 repo 内 .

链接 吉特的工作树跟随吉特 commondir 元数据到主检出, 所以主检查和所有链接的工作树 有意分享一个协和 数据库和工作空间 id.

限制明确的工作空间选择,设置 CONCORD_ALLOWED_ROOTS 改为 路径限制的允许寄存器根列表。 没有允许列表, 解码 根必须仍然存在并成为目录.

concord setup 写入 .concord/.gitignore 包含 *,因此生成 工作空间忽略自身, 不编辑仓库共享的本地化 .gitignore。在公关中需要选定文物的团队可以添加否定规则到 该文件( 设置保留已有规则, 只确保 * 全面控制)或 强制添加人类可读文件。 由Concord 0.10.5或 之前还有 .concord/ 根中的规则 .gitignore; 删除前 否定 .concord/.gitignore 可以生效.

.concord/
├── .gitignore          ignores the whole directory
├── concord.db          local source of truth
├── HANDOFF.md          human-readable handoff
├── REVIEW_PACKET.md    review-ready evidence
├── events.jsonl        chronological tool events, one JSON object per line
└── WORK_STATE.json     generated work-state export

国 际

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 check <files...>     # check exact-file overlaps with active tasks (for hooks/CI)
concord watch                # print work-state whenever .concord changes (Ctrl-C to stop)
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

在预承诺钩或 CI 中阻断相冲突的编辑, 运行 concord check src/file.ts (或 concord check --task <id> src/file.ts 以排除你自己的任务. 命令退出状态 1 当一个活动任务声称同一文件, 财务报告和审定财务报表 0 当没有重叠时。 Claude 代码 PreTool 使用钩处理退出代码 2 作为否定,所以使用 concord check src/file.ts || exit 2 钩上.

--repo 财务报告和审定财务报表 --workspace 是全球性的,相互排斥的选择。 使用CLI 软件 同样的 CONCORD_REPO_ROOT → CLAUDE_PROJECT_DIR − 工作-指导优先事项 和与MCP相同的连通-工作树条化.

concord dashboard 是一个只读的全屏本地TUI。 它从新鲜的 每秒共享 SQLite 工作空间,同时保留代理,任务,提醒, 上下文,以及固定终端取景口内的时间表。 使用 Tab 更改 窗关, j编号 :k 或选择工作的箭头键, / 要过滤, ? 寻求帮助, 财务报告和审定财务报表 q 放弃.

升级

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

重运行 curl … | sh 用于升级自装安装的安装器.

每天核对协和,在CLI、MCP工具以及 仪表板; concord setup 可在确认后安装一个(使用npm或安装器,以所用为准),以及 CONCORD_NO_UPDATE_CHECK=1 禁用检查.

这是不是

共享工作状态和任务内存,用于使用相同的本地编码代理 结账. 没有 一个管弦乐手,代码审查员,主机同步服务,内存 向量 DB, 或自动编码代理 .

另见: 为什么不用减价法呢?

捐款

见 CONTRIBUTING.md 财务报告和审定财务报表 CLAUDE.md这个 repo 严格输入( 无) any,没有打字机)和模块化. 初等问题 标签 good first issue。 。 。 .

恒星历史

Star History Chart

隐私和遥测

Concord将产品和协调遥测发送给 getconcord.ai它包括: 随机安装/调用标识符;每个安装工作空间不可逆转 和任务流程假名; 协和/节点/平台版本; 规范客户端 元数据; 操作名称、结果和持续时间; 总计重叠/编辑保障 结果;信息发送阶段和延迟;任务生命周期过渡和 - 明确报告接受, 融合、人道干预和再造成果.

Concord 从未发送代码、原始文件或寄存器路径、远程、用户名、原始 任务或代理标识符、消息标识符或内容、命令参数, 工具输入/输出,或任务内容。 接收服务器存储请求 IP 地址和生成/存储国家代码。 目前这些服务器侧字段 自动失效。 设定 CONCORD_TELEMETRY_DISABLED=1 (或 DO_NOT_TRACK=1) 使遥测功能失效。 交付是最好的努力,永远不会 使协和操作失败.

许可证

麻省理工学院

版本与发布记录

@concord-ai/concord-mcp 共发布 33 个版本,首次发布于 2026/07/17;过去 12 个月发布了 33 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.21.0latest2026/11/091 天前
0.20.02026/11/064 天前
0.19.02026/10/3011 天前
0.18.02026/10/2912 天前
0.17.12026/10/2813 天前
0.17.02026/10/2813 天前

关于 @concord-ai/concord-mcp 的常见问题

@concord-ai/concord-mcp 是什么?

通过MCP为编码代理进行跨harness通信并共享工作状态.

如何安装 @concord-ai/concord-mcp?

在项目目录运行 npm install @concord-ai/concord-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 concord、concord-mcp,可以用 npx concord 直接运行。

@concord-ai/concord-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/concord-ai__concord-mcp 是否存在。

@concord-ai/concord-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@concord-ai/concord-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@concord-ai/concord-mcp 可以商用吗?

@concord-ai/concord-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@concord-ai/concord-mcp 的下载量有多少?

根据 npm 官方下载统计,@concord-ai/concord-mcp 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,987 次,日均约 133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@concord-ai/concord-mcp 还在维护吗?

最新版本 0.21.0 发布于 2026/11/09(1 天前);至今共发布 33 个版本,其中过去 12 个月发布了 33 个;首次发布于 2026/07/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。