Перейти к содержимому

Разработчикам

Подключите своих ассистентов к тому же графу, что и ваши планы

Project Orchestrator открывает всё, что делает приложение, в виде инструментов MCP, REST API и двух потоков WebSocket. Сервер на Rust хранит код, планы, решения и заметки в графе Neo4j и в Meilisearch.

инструментов MCP
33
инструментов MCP
действий во всех
426
действий во всех
языков разбирается
17
языков разбирается
потока WebSocket
4
потока WebSocket

Ищете сам продукт? Вернитесь на главную страницу.

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

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

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

Подключение

Подключите PO к клиенту MCP

Приложение для компьютера или сервер должны быть запущены. Затем одна команда регистрирует PO в Claude Code, а для любого другого клиента MCP вы добавляете запись вручную.

Установите и запустите сервер

Серверу нужны Neo4j и Meilisearch. NATS необязателен. В репозитории есть docker-compose.yml для всех трёх.

orchestrator serve

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

Зарегистрируйте PO в Claude Code

Команда записывает запись MCP в режиме stdio с URL этого сервера и его секретом аутентификации и заранее одобряет инструменты.

orchestrator setup-claude

orchestrator setup-claude --port 8080

setup-claude также добавляет mcp__project-orchestrator__* в разрешённые инструменты в ~/.claude/settings.json, чтобы Claude Code не спрашивал подтверждения при каждом вызове.

Проверьте, что всё работает

В Claude Code выполните /mcp: project-orchestrator должен быть в списке. Затем попросите список проектов: Claude вызовет project(action: "list").

Claude Code

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

Любой клиент MCP, stdio

mcp_server — тонкий прокси: он говорит по MCP через stdio и передаёт каждый вызов в REST API. Сам к Neo4j он никогда не подключается. Задайте PO_AUTH_TOKEN или PO_JWT_SECRET, чтобы он сгенерировал токен при запуске.

~/.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>"      }    }  }}

Попробуйте: переключайтесь между stdio, Claude Code и сырым запросом HTTP, затем скопируйте блок

Инструменты MCP

33 инструмент, одна форма вызова

Каждый инструмент принимает параметр action и направляет его в одну операцию. Ищите по инструменту, действию или параметру, затем копируйте точный вызов.

Инструментов: 33

plan

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

Планирование и выполнение 27 действия

Пример вызова

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

Действия

ещё 21
Все примеры (4)

Параметры

plan_idproject_idtitledescriptionpriorityconstraintsstatussearchlimitoffsetsort_bysort_orderpriority_minpriority_maxcwdproject_slugtrigger_idtrigger_typeconfigcooldown_secsrun_idrun_idstask_idparent_session_idcustom_sectionsprovidermodeltask_class

Попробуйте: ищите инструмент, пользуйтесь стрелками в списке, откройте примеры и скопируйте любой вызов

Значения аргументов вроде <uuid> — заполнители. Названия действий и параметров прочитаны из исходного кода сервера.

Архитектура

Один сервер на Rust, три хранилища, любой клиент

Клиенты никогда не обращаются к базам напрямую. Они говорят с сервером, который разбирает код, отдаёт API и рассылает события.

Выберите компонент, чтобы увидеть его роль и потоки, которые к нему ведут, или пройдите запрос инструмента через систему.

Попробуйте: наведите или выберите компонент либо пройдите запрос шаг за шагом

Как они общаются

  • 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

Разбор кода

17 языков, разбор через tree-sitter

Каждый файл разбирается на функции, структуры, трейты, перечисления, импорты, блоки impl и рёбра вызовов, затем сохраняется в графе.

Языков: 17

Наведите, поставьте фокус или нажмите на язык, чтобы увидеть, какие символы PO извлекает из него.

Попробуйте: наведите или нажмите на язык

Из каждого файла: функции, структуры, трейты, перечисления, импорты, блоки impl, вызовы функций с оценкой уверенности.

Файлы JavaScript (.js, .jsx, .mjs, .cjs) читаются грамматикой TypeScript.

API и события

REST для состояния, WebSocket для изменений

Планы, код, заметки и всё остальное — обычный JSON по HTTP. Изменения приходят по WebSocket.

Основные конечные точки REST

Большинство маршрутов стоит за промежуточным слоем аутентификации. Если раздел auth не настроен, API открыт.

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

Потоки WebSocket

  • /ws/events

    Каждое создание, обновление, удаление, связывание, разрыв связи и смена статуса — одним событием JSON. Фильтруйте параметрами запроса entity_types, project_id и layers.

  • /ws/chat/{session_id}

    Разговор с ассистентом. Отправляются user_message, interrupt, permission_response, input_response, set_permission_mode и set_model (модель меняется сразу или при следующем возобновлении, если сессия простаивает). События чата принимаются и повторно передаются с last_event после переподключения.

  • /ws/run/{run_id}

    Один поток на запуск плана: события исполнителя (задача началась, волна началась...) плюс события чата каждой дочерней сессии.

Браузеры аутентифицируются через cookie или по одноразовому билету из POST /auth/ws-ticket, переданному в параметре ticket.

Поток событий в реальном времени, пример

Форма настоящая (CrudEvent на /ws/events). Сами события придуманы для иллюстрации.

Показано событий: 10, получено: 10

Сообщение /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>"}

Попробуйте: фильтруйте по типу, приостанавливайте поток и выбирайте событие, чтобы увидеть его сообщение

Расширение

Три способа настроить PO под себя

Все три доступны через те же инструменты MCP.

  • Протоколы

    Задайте конечный автомат с состояниями и переходами, запустите его и позвольте ассистентам продвигать его инструментом protocol.

  • Навыки

    Навыки — кластеры заметок и кода, которые возникают в ходе работы; инструмент skill активирует, экспортирует и импортирует их между проектами и экземплярами.

  • Федерация MCP

    mcp_federation подключает внешние серверы MCP через stdio, sse или streamable_http, чтобы их инструменты были доступны через PO.

Вклад в проект

Есть идея или нашли ошибку? Расскажите нам.

Project Orchestrator — открытый проект. Идеи и сообщения об ошибках оформляются как issue на GitHub, где их может прочитать любой.

Предложить функцию

Опишите проблему, которую нужно решить, и то, что вы делаете сейчас, чтобы обойтись без решения. Ясную проблему обсуждать проще, чем готовое решение.

Она оформляется как публичный issue на GitHub, где мейнтейнеры и другие пользователи могут её прочитать и дополнить.

Сообщить об ошибке

Расскажите, что вы сделали, чего ожидали и что произошло на самом деле. Чем точнее шаги, тем легче воспроизвести проблему.

Она оформляется как публичный issue на GitHub, где мейнтейнеры и другие пользователи могут её прочитать и дополнить.

Хороший отчёт содержит

  • Версию Project Orchestrator, которую вы запускаете, например тег релиза со страницы Releases.
  • Вашу операционную систему и её версию.
  • Шаги, которые привели к проблеме, по порядку, и то, что вы ожидали увидеть.
  • Точный текст ошибки или скриншот, если он есть.