Менеджер MCP-сессий клиентов 1С
v8-session-manager
Бинарник на Rust, который принимает подключения нескольких клиентов 1С по WebSocket и отдает единый MCP-эндпоинт для AI-агентов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Открывает сетевые порты для WS и MCP HTTP
- Проксирует вызовы инструментов, которые выполняют код BSL в сессии 1С
Установка
Ручная установка
cargo build --releaseСборка из исходников, бинарник появится в target/release.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервис работает как посредник между несколькими запущенными клиентами 1С и AI-агентом. Клиенты 1С с параметром запуска mcpMode=ws подключаются к менеджеру по WebSocket и публикуют свои MCP-инструменты, а агент видит их на одном MCP HTTP-эндпоинте через общий tools/list. На сессию заводится очередь вызовов FIFO, чтобы параллельные запросы агента не перемешались на стороне 1С, есть soft-reconnect по идентификатору клиента при обрыве связи и автоматическая очистка неактивных сессий. Сам менеджер клиентов 1С не запускает, это делает внешний оркестратор или BSL-расширение onec-client-mcp-devkit. Единственный встроенный инструмент менеджера, session_list, показывает активные сессии.
Для кого. Для 1С-разработчиков, которые уже используют onec-client-mcp-devkit и хотят дать агенту доступ сразу к нескольким запущенным клиентам 1С через одну точку входа.
Подходит, если
- Одновременно работает несколько сессий 1С (тестовая, под другой учеткой, несколько баз) и нужен один MCP-адрес для агента
- Нужна гарантия, что параллельные вызовы агента к одной сессии 1С выполняются по очереди
- Клиент 1С может переподключаться, а сессию и опубликованные инструменты нужно сохранить
Не подходит, если
- Работает только один клиент 1С и посредник не нужен
- Нет BSL-расширения на стороне 1С, которое публикует инструменты через session.register
- Нужен готовый бинарный релиз без сборки из исходников: релизы через GitHub Actions есть, но собственный опыт установки в README рассчитан на сборку cargo
Пример запроса к агенту
Покажи список активных сессий 1С через session_list и вызови нужный инструмент в сессии с базой ТестОграничения
Менеджер сам по себе бесполезен без клиентов 1С, которые публикуют инструменты через WS, то есть без onec-client-mcp-devkit или аналогичного расширения. Проект написан на Rust и требует сборки через cargo build --release. Формат публикации инструментов менялся между версиями (naming contract v2 от 2026-05-09 отменил префиксы по kind), поэтому старые интеграции могли сломаться. Аутентификация MCP HTTP через Bearer-токен опциональна и по умолчанию выключена.
Как отключить. Остановите systemd-сервис (systemctl disable --now v8-session-manager) или завершите процесс бинарника и удалите его из конфигурации MCP-клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| V8SM_CONFIG | Путь к YAML-конфигу, альтернатива флагу --config. |
Проверка безопасности
- Открывает сетевые порты для WS и MCP HTTP
- Проксирует вызовы инструментов, которые выполняют код BSL в сессии 1С
Коротко о README
README описывает бинарник на Rust с двумя транспортами: WebSocket для 1С-клиентов на порту 4000 и MCP HTTP для агентов на порту 4001, работающие поверх общего реестра сессий. Приведены архитектурная схема, список возможностей (FIFO по сессии, soft-reconnect, idle-sweeper, дедупликация инструментов), инструкции по сборке и установке как systemd-сервиса, таблица параметров запуска клиента 1С через /C и таблица настроек конфига v8project.yaml. Отдельно объясняется naming contract v2 для публикации инструментов и обязательные поля регистрации сессии. Проект указан как форк, отделенный от v8-runner, лицензия AGPL-3.0.
Частые вопросы
Менеджер сам запускает клиентов 1С?
Нет, он только принимает их подключения. Запуск клиентов 1С с нужными параметрами командной строки остается за внешним оркестратором или расширением.
Что произойдет, если два клиента опубликуют инструмент с одинаковым именем?
Если схема входных параметров совпадает, вызовы будут распределяться между сессиями по круговому принципу. Если схемы разные, инструмент скрывается из списка до устранения конфликта.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything