Saltar al contenido

Para desarrolladores

Conecta tus agentes al mismo grafo que tus planes

Project Orchestrator expone todo lo que hace la aplicación como herramientas MCP, una API REST y dos flujos WebSocket. Un servidor en Rust guarda código, planes, decisiones y notas en un grafo de Neo4j y en Meilisearch.

herramientas MCP
33
herramientas MCP
acciones entre todas
426
acciones entre todas
lenguajes analizados
17
lenguajes analizados
flujos WebSocket
4
flujos WebSocket

¿Buscas el producto en sí? Vuelve a la página de inicio.

project(action: "sync", slug: "my-app")

code(
  action: "analyze_impact",
  target: "src/session.rs",
  project_slug: "my-app"
)

plan(action: "run", plan_id: "<uuid>")

Conectar

Conecta PO a un cliente MCP

La aplicación de escritorio o el servidor deben estar en marcha. Después, un comando registra PO en Claude Code, o añades la entrada a mano para cualquier otro cliente MCP.

Instala e inicia el servidor

El servidor necesita Neo4j y Meilisearch. NATS es opcional. El repositorio incluye un docker-compose.yml para los tres.

orchestrator serve

# needs Neo4j and Meilisearch: docker compose up -dbrew install this-rs/tap/project-orchestratororchestrator serve --port 8080

Registra PO en Claude Code

Esto escribe la entrada MCP en modo stdio, con la URL de este servidor y su secreto de autenticación, y preaprueba las herramientas.

orchestrator setup-claude

orchestrator setup-claude --port 8080

setup-claude también añade mcp__project-orchestrator__* a las herramientas permitidas de ~/.claude/settings.json, así que Claude Code no pregunta antes de cada llamada.

Comprueba que funciona

En Claude Code, ejecuta /mcp: project-orchestrator debería aparecer en la lista. Después pide la lista de proyectos: Claude llama a project(action: "list").

Claude Code

# in Claude Code/mcp# then ask: "List all registered projects"# Claude calls: project(action: "list")

Cualquier cliente MCP, stdio

mcp_server es un proxy ligero: habla MCP por stdio y reenvía cada llamada a la API REST. Nunca se conecta a Neo4j por sí mismo. Define PO_AUTH_TOKEN, o PO_JWT_SECRET para que genere un token al arrancar.

~/.claude/mcp.json

{  "mcpServers": {    "project-orchestrator": {      "command": "/path/to/mcp_server",      "env": {        "PO_SERVER_URL": "http://127.0.0.1:8080",        "PO_AUTH_TOKEN": "<jwt-session-token>"      }    }  }}

Pruébalo: cambia entre stdio, Claude Code y una petición HTTP directa, y luego copia el bloque

Herramientas MCP

33 herramientas, una sola forma de llamada

Cada herramienta recibe un parámetro action y lo dirige a una operación. Busca por herramienta, acción o parámetro, y copia la llamada exacta.

33 herramientas

plan

Plans with dependency graph, waves, critical path, and the autonomous runner.

Planificación y entrega 27 acciones

Llamada de ejemplo

plan(  action: "create",  title: "Migrate session store to Redis",  priority: 8)

Acciones

+21 más
Todos los ejemplos (4)

Parámetros

plan_idproject_idtitledescriptionpriorityconstraintsstatussearchlimitoffsetsort_bysort_orderpriority_minpriority_maxcwdproject_slugtrigger_idtrigger_typeconfigcooldown_secsrun_idrun_idstask_idparent_session_idcustom_sectionsprovidermodeltask_class

Pruébalo: busca una herramienta, usa las flechas en la lista, abre los ejemplos y copia cualquier llamada

Los valores de argumentos como <uuid> son marcadores de posición. Los nombres de acciones y parámetros se leen del código fuente del servidor.

Arquitectura

Un servidor en Rust, tres almacenes, cualquier cliente

Los clientes nunca tocan las bases de datos. Hablan con el servidor, que analiza el código, sirve la API y emite eventos en flujo.

Selecciona un componente para ver su papel y los flujos que llegan hasta él, o sigue una petición de herramienta por el sistema.

Pruébalo: pasa el cursor o selecciona un componente, o sigue una petición paso a paso

Cómo se comunican

  • MCP clients / mcp_serverstdio
  • MCP clients / orchestratorHTTP /mcp
  • mcp_server / orchestratorREST
  • Desktop app / orchestratorREST + WebSocket
  • WebSocket clients / orchestratorWebSocket
  • orchestrator / Neo4jbolt
  • orchestrator / MeilisearchHTTP
  • orchestrator / NATSNATS
  • orchestrator / ClaudeSDK

Análisis de código

17 lenguajes, analizados con tree-sitter

Cada archivo se analiza en funciones, structs, traits, enums, imports, bloques impl y aristas de llamada, y después se guarda en el grafo.

17 lenguajes

Pasa el cursor, enfoca o toca un lenguaje para ver qué tipo de símbolos extrae PO.

Pruébalo: pasa el cursor o toca un lenguaje

Por archivo: funciones, structs, traits, enums, imports, bloques impl, llamadas a funciones con una puntuación de confianza.

Los archivos JavaScript (.js, .jsx, .mjs, .cjs) se leen con la gramática de TypeScript.

API y eventos

REST para el estado, WebSockets para el cambio

Los planes, el código, las notas y el resto son JSON simple sobre HTTP. Los cambios se envían por WebSockets.

Principales endpoints REST

La mayoría de las rutas están tras el middleware de autenticación. Cuando no se configura ninguna sección de autenticación, la API está abierta.

GET/healthLiveness
GET/api/versionServer version
GET/api/projectsList projects (POST creates)
POST/api/projects/{slug}/syncParse a project into the graph
GET/api/plans/{plan_id}/wavesParallel waves of a plan
POST/api/plans/{plan_id}/runStart the runner on a plan
GET/api/code/searchSearch code
GET/api/code/impactImpact analysis
GET/api/notes/searchSearch notes
GET/api/decisions/searchSearch decisions
POST/api/reasonReasoning over the graph
POST/mcpMCP over Streamable HTTP

Flujos WebSocket

  • /ws/events

    Cada creación, actualización, eliminación, vinculación, desvinculación y cambio de estado, como un evento JSON. Filtra con los parámetros de consulta entity_types, project_id y layers.

  • /ws/chat/{session_id}

    Conversación con el asistente. Envía user_message, interrupt, permission_response, input_response, set_permission_mode y set_model (el modelo cambia en vivo, o en la siguiente reanudación si la sesión está inactiva); recibe los eventos del chat, reproducidos desde last_event tras una reconexión.

  • /ws/run/{run_id}

    Un flujo para la ejecución de un plan: eventos del ejecutor (tarea iniciada, ola iniciada...) más los eventos de chat de cada sesión hija.

Los navegadores se autentican con una cookie, o con un ticket de un solo uso de POST /auth/ws-ticket pasado como parámetro ticket.

Flujo de eventos en directo, de muestra

La forma es la real (CrudEvent en /ws/events). Los eventos en sí son inventados para esta ilustración.

10 eventos mostrados, 10 recibidos

Un mensaje de /ws/events

/ws/events

{  "entity_type": "task",  "action": "status_changed",  "entity_id": "<uuid>",  "payload": { "old_status": "pending", "new_status": "in_progress" },  "timestamp": "2026-10-05T10:00:00Z",  "project_id": "<uuid>"}

Pruébalo: filtra por tipo, pausa el flujo, selecciona un evento para ver su mensaje

Extender

Tres formas de hacer tuyo PO

Las tres están disponibles mediante las mismas herramientas MCP.

  • Protocolos

    Define una máquina de estados finitos con estados y transiciones, inicia una ejecución y deja que los agentes la hagan avanzar con la herramienta protocol.

  • Habilidades

    Las habilidades son grupos de notas y código que surgen con el uso; la herramienta skill las activa, las exporta y las importa entre proyectos e instancias.

  • Federación MCP

    mcp_federation conecta servidores MCP externos por stdio, sse o streamable_http, para que sus herramientas sean accesibles a través de PO.

Contribuir

¿Tienes una idea o has encontrado un error? Cuéntanoslo.

Project Orchestrator es de código abierto. Las ideas y los informes de error se abren como incidencias en GitHub, donde cualquiera puede leerlas.

Pide una funcionalidad

Describe el problema que quieres resolver y lo que haces hoy para sortearlo. Un problema bien planteado se discute mejor que una solución ya terminada.

Se abre como incidencia pública en GitHub, donde los mantenedores y otros usuarios pueden leerla y añadir comentarios.

Informa de un error

Cuéntanos qué hiciste, qué esperabas y qué pasó en su lugar. Cuanto más exactos sean los pasos, más fácil será reproducir el problema.

Se abre como incidencia pública en GitHub, donde los mantenedores y otros usuarios pueden leerla y añadir comentarios.

Un buen informe incluye

  • La versión de Project Orchestrator que usas, por ejemplo la etiqueta de una versión en la página Releases.
  • Tu sistema operativo y su versión.
  • Los pasos que llevan al problema, en orden, y lo que esperabas en su lugar.
  • El mensaje de error exacto o una captura de pantalla, si la hay.