Pilotmcp

PilotMCP

MCP-сервер для работы с Pilot через Server API. Позволяет LLM-агентам подключаться к серверу Pilot, выполнять поиск, создавать и изменять объекты, работать с документами, историей изменений, правами доступа и чатами.

Документация: https://pilotopentools.github.io/PilotMCP/ · DeepWiki: https://deepwiki.com/PilotOpenTools/PilotMCP

Требования

• .NET 8.0
• Доступ к серверу Pilot

Установка

Подробнее об установке и настройке клиентов — в документации.

Готовые сборки (Windows x64) — на странице Releases:

Сервер также опубликован в официальном MCP Registry под именем io.github.PilotOpenTools/pilotmcp.

Выпуск релиза

Релиз собирается GitHub Actions по тегу вида vX.Y.Z (semver, допускается суффикс -beta.1):

git tag vX.Y.Z

git push origin vX.Y.Z

Workflow release.yml прогоняет unit-тесты, собирает zip-архивы и .mcpb, создаёт GitHub Release и публикует server.json в MCP Registry (вход по OIDC, секреты не нужны). Версия берётся из тега. Манифест бандла — mcpb/manifest.json. Вместо vX.Y.Z подставьте новую версию, которой ещё нет среди тегов. CHANGELOG в репозитории не ведётся: описание релиза GitHub создаёт автоматически (--generate-notes). Подробности, включая ограничения release.yml, — в docs/development.md.

На push в любую ветку и на pull request ci.yml собирает проект и прогоняет unit-тесты (на ветке с открытым PR он запускается дважды). Интеграционные тесты (Category=Integration) требуют живой сервер Pilot и запускаются локально: dotnet test PilotMCP.slnx с параметрами своего сервера: скопируйте шаблон PilotMCP.Tests/test.runsettings в PilotMCP.Tests/test.local.runsettings (он в .gitignore, подхватывается автоматически) и заполните.

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

Параметры подключения задаются через переменные окружения в конфигурации MCP-клиента:

Пример конфигурации (LM Studio, Ollama, Claude Code, Cursor и т.д.)

{

"mcpServers": { "pilot": { "command": "C:\\path\\to\\PilotMCP.exe", "env": { "PILOT_SERVER_URL": "http://localhost:5545/u_db_name", "PILOT_LOGIN": "username", "PILOT_PASSWORD": "password", "PILOT_DATABASE": "", "PILOT_LICENSE_TYPE": "103", "PILOT_READONLY": "false" } } } }

Надёжность записи

• Операции записи через Modifier/Backend (создание и изменение объектов, связей, задач, замечаний и т.д.) дожидаются ответа сервера (до 60 с). Отказ сервера возвращается как ошибка с его текстом; по таймауту сообщается, что результат неизвестен.
• При обрыве соединения PilotMCP переподключается и повторяет только читающие вызовы. Записи после таймаута или обрыва автоматически не повторяются, чтобы не создать дубликаты, — проверьте состояние и повторите вручную.
• Метаданные перечитываются, когда сервер сообщает об их изменении; параллельные изменения метаданных внутри одного процесса PilotMCP выполняются последовательно.

Режим только чтения

При PILOT_READONLY=true сервер сообщает модели об ограничениях через системный промпт при инициализации. Модель не будет пытаться выполнять операции записи и сразу сообщит пользователю об ограничении.

Заблокированы: CreateObject, SetAttribute, DeleteObject, RestoreObject, MoveObject, LockObject, UnlockObject, FreezeObject, UnfreezeObject, MakeSecret, MakePublic, DeleteFile, SetUserState, Subscribe, Unsubscribe, AnnotateText, CreateAnnotation, CreateMarkupAnnotation, SendMessage, EditMessage, ReplyMessage, CreateChat, UploadFile, InvokeCommand, CreateLink, DeleteRelation, AddAccessRecord, RemoveAllAccessRecords, UpdatePerson, ChangeSettings, CreateReport, UpdateReport, CreateTask, CreateWorkflow, AddSignatureRequest, CreateAutomationConfig, UpdateAutomationConfig, DeleteAutomationConfig, CreateType, UpdateType, DeleteType, AddTypeChildren, AddTypeAttribute, UpdateTypeAttribute, DeleteTypeAttribute, CreateUserState, UpdateUserState, DeleteUserState, CreateStateMachine, UpdateStateMachine, DeleteStateMachine, CreatePerson, UpdatePersonAdmin, DeletePerson, CreateOrgUnit, UpdateOrgUnit, DeleteOrgUnit, MoveOrgUnits, SetPersonOnPosition, RemovePersonFromPosition.

---

Архитектура

Bulk-инструменты (поиск, дочерние объекты и т.п.) записывают результаты во временные JSONL-файлы, а не возвращают данные напрямую в контекст. Это позволяет работать с тысячами объектов без перегрузки контекста модели.

Search("проект") → {resultFile: "tmp/search_x.jsonl", count: 8543}

↓ FilterObjects("tmp/search_x.jsonl", "typeName", "document") → tmp/filter_x.jsonl (85 записей) ↓ ExportCsv("tmp/filter_x.jsonl", "C:/result/docs.csv", "name,typeName,created")

Формат промежуточных файлов — JSONL (JSON Lines): один JSON-объект на строку.

---

Инструменты

Подключение

Объекты

Навигация и поиск

Пользователи и организация