concord-mcp

Verlo en acción

Dos agentes en entornos diferentes pueden descubrirse, intercambiar mensajes y dividir el trabajo sin que un humano tenga que transmitir el contexto entre ellos:

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.

Ejecuta la demo real de Claude Code ↔ Codex para ver cómo ambos agentes resuelven una reclamación superpuesta mediante un prompt/respuesta en vivo, crean una aplicación jugable, transfieren la propiedad y entregan el resultado a un revisor independiente.

Related MCP server: ccg-mcp-tool

Inicio rápido

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

Reinicia tus clientes de agente y pide a dos de ellos que trabajen en el mismo repositorio. Concord les proporciona un espacio de trabajo compartido y hace que las sesiones alcanzables estén disponibles para prompts y respuestas directos.

concord setup crea el espacio de trabajo local .concord/, registra el servidor MCP para Claude, Cursor, Gemini, Grok y Codex (.mcp.json, .cursor/mcp.json, .gemini/settings.json, .grok/config.toml y ~/.codex/config.toml) y escribe las instrucciones de las herramientas de Concord en las configuraciones de tus clientes (CLAUDE.md, AGENTS.md, .codex/, .cursor/rules/). Se fusiona con la configuración existente en lugar de reemplazarla y es seguro volver a ejecutarlo.

El setup también detecta clientes compatibles e intenta instalar sus adaptadores globales de Concord de forma independiente. Usa --no-adapters para omitir ese paso o --require-adapters en instalaciones gestionadas que deberían fallar si el soporte está degradado. Pasa --no-mcp para escribir solo el espacio de trabajo y las instrucciones mientras gestionas el registro de MCP por tu cuenta.

Agentes compatibles

No existe un comando universal /concord — los comandos son específicos de cada cliente. Concord funciona a través de las herramientas MCP más las instrucciones instaladas en cualquier cliente compatible con MCP.

La entrega en vivo depende del entorno receptor y del estado de la sesión. Ejecuta concord adapters status para ver qué agentes instalados son alcanzables y cómo se entregarán los mensajes.

La comunicación es el punto de partida

Los mensajes hacen que los agentes hablen. El estado de trabajo compartido de Concord mantiene la colaboración resultante fiable después de que el mensaje se entregue.

Concord no es otro agente autónomo ni orquestador. Es la capa compartida alrededor de tus agentes: presencia, mensajería, memoria de tareas, propiedad, transferencias y estado de revisión a través de un pequeño servidor MCP.

Las herramientas

Las escrituras aceptan un agent_id, que mantiene la presencia activa simplemente trabajando. inspect_work muestra quién está aquí y marca reclamaciones obsoletas — una reclamación activa cuyo agente propietario se ha ido sin transferirla.

Para la comunicación en vivo entre agentes, ejecuta concord setup y luego reinicia las sesiones de cliente existentes una vez. Un prompt usa update_work con operation: "prompt", el to_agent_id de destino, el contenido y una idempotency_key; una respuesta usa operation: "reply" y reply_to_message_id. Un adaptador con confirmación de entrega dirige un turno ocupado o inicia un turno inactivo. Las integraciones solo con hooks dejan un mensaje de extracción duradero y limitan esa limitación en el resultado. La entrega falla inmediatamente cuando el agente nombrado no tiene un endpoint alcanzable; Concord no lo redirige silenciosamente.

concord adapters status informa de cada entorno por separado, incluyendo su tipo de monitor/controlador, alcanzabilidad verificada, acción requerida y resultado de la sonda de versión. concord adapters install, doctor y uninstall proporcionan el mismo ciclo de vida global fuera de la configuración del repositorio.

Concord resuelve el espacio de trabajo del repositorio automáticamente. Las operaciones devuelven su workspace_id y la raíz del repositorio para que un cliente pueda detectar una llamada mal enrutada; el id se puede pasar explícitamente cuando un servidor coordina múltiples raíces.

Las operaciones que cambian el ciclo de vida usan la version monotónica de la tarea como expected_version. Si dos agentes actúan sobre la misma versión, solo la primera transición tiene éxito. La asignación deja el trabajo en assigned hasta que el agente nombrado use transfer_work con action: "accept"; una oferta de transferencia también mantiene la propiedad con el remitente hasta que el destinatario la acepta. Cada cambio de propiedad se conserva en un historial de auditoría de solo añadir.

Lo que obtienes

SQLite es la fuente de verdad local, almacenada en .concord/ en la raíz del repositorio donde se realiza el trabajo. El servidor MCP resuelve esa raíz desde CONCORD_REPO_ROOT si está definido, luego desde CLAUDE_PROJECT_DIR de Claude Code (que Claude Code establece automáticamente, incluso para un servidor con ámbito de usuario), y luego desde su directorio de trabajo — de modo que cada agente en un repositorio comparte un único almacén. Establece CONCORD_REPO_ROOT cuando ejecutes el servidor en un lugar donde su directorio de trabajo no esté dentro del repositorio.

Los worktrees de Git vinculados siguen los metadatos commondir de Git hasta el checkout principal, de modo que el checkout principal y todos los worktrees vinculados comparten intencionadamente una única base de datos y un único id de espacio de trabajo de Concord.

Para restringir la selección explícita de espacios de trabajo, establece CONCORD_ALLOWED_ROOTS a una lista de raíces de repositorio permitidas separadas por rutas. Sin una lista de permitidos, las raíces decodificadas deben existir y ser directorios.

concord setup añade .concord/ al .gitignore del repositorio, de modo que el espacio de trabajo generado permanezca local por defecto. Los equipos que quieran artefactos seleccionados en los PRs pueden eliminar esa regla o forzar la adición de los archivos legibles por humanos:

.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 admite tanto herramientas MCP tipadas como una CLI normal. Los agentes compatibles con MCP pueden llamar a las herramientas directamente; los humanos y los agentes orientados a CLI pueden trabajar con el mismo espacio de trabajo compartido a través de los comandos 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 y --workspace son opciones globales mutuamente excluyentes. La CLI usa la misma prioridad CONCORD_REPO_ROOT → CLAUDE_PROJECT_DIR → directorio de trabajo y la misma canonicalización de worktrees vinculados que MCP.

concord dashboard es una TUI local de pantalla completa de solo lectura. Se actualiza desde el espacio de trabajo SQLite compartido cada segundo mientras mantiene agentes, tareas, alertas, contexto y línea de tiempo dentro de un viewport de terminal fijo. Usa Tab para cambiar de panel, j/k o las teclas de flecha para seleccionar trabajo, / para filtrar, ? para ayuda y q para salir.

Actualización

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

Concord comprueba diariamente y muestra las actualizaciones disponibles en la CLI, las herramientas MCP y el dashboard; concord setup puede instalar una con confirmación, y CONCORD_NO_UPDATE_CHECK=1 desactiva las comprobaciones.

Qué es / qué no es

Estado de trabajo compartido y memoria de tareas para agentes de codificación que usan el mismo checkout local. No es un orquestador, revisor de código, servicio de sincronización alojado, base de datos vectorial de memoria ni un agente de codificación autónomo.

Ver también: ¿Por qué no usar simplemente markdown?

Contribuir

Consulta CONTRIBUTING.md y CLAUDE.md. Este repositorio está estrictamente tipado (sin any, sin typecasts) y es modular. Las buenas primeras tareas están etiquetadas como good first issue.

Historial de estrellas

Privacidad y telemetría

Concord envía telemetría de producto y coordinación a getconcord.ai. Incluye identificadores aleatorios de instalación/invocación; seudónimos irreversibles de espacio de trabajo y flujo de tareas por instalación; versiones de Concord/Node/plataforma; metadatos de cliente normalizados; nombres de operación, resultados y duraciones; resultados agregados de solapamiento/guardia de edición; etapas y latencias de entrega de mensajes; transiciones del ciclo de vida de tareas y tiempo transcurrido; y resultados de aceptación, integración, intervención humana y retrabajo notificados explícitamente.

Concord nunca envía código, rutas de archivo o repositorio sin procesar, remotos, nombres de usuario, identificadores de tarea o agente sin procesar, identificadores o contenido de mensajes, argumentos de comandos, entradas/salidas de herramientas ni contenido de tareas. El servidor receptor almacena la dirección IP de la solicitud y deriva/almacena un código de país. Esos campos del lado del servidor actualmente no tienen caducidad automática. Establece CONCORD_TELEMETRY_DISABLED=1 (o DO_NOT_TRACK=1) para desactivar la telemetría. La entrega es de mejor esfuerzo y nunca puede hacer fallar una operación de Concord.

Licencia

MIT