Менеджер MCP-сессий клиентов 1С
v8-session-manager
Бинарник на Rust, который принимает подключения нескольких клиентов 1С по WebSocket и отдает единый MCP-эндпоинт для AI-агентов
- 10 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Открывает сетевые порты для WS и MCP HTTP
- Проксирует вызовы инструментов, которые выполняют код BSL в сессии 1С
Установка
- Работает в
- Сервисы
Ручная установка
cargo build --releaseСборка из исходников, бинарник появится в target/release.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Открывает сетевые порты для WS и MCP HTTP
- Проксирует вызовы инструментов, которые выполняют код BSL в сессии 1С
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервис работает как посредник между несколькими запущенными клиентами 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 и вызови нужный инструмент в сессии с базой ТестMCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
V8SM_CONFIG- Путь к YAML-конфигу, альтернатива флагу --config.
Ограничения
Менеджер сам по себе бесполезен без клиентов 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-клиента.
Частые вопросы
Менеджер сам запускает клиентов 1С?
Нет, он только принимает их подключения. Запуск клиентов 1С с нужными параметрами командной строки остается за внешним оркестратором или расширением.
Что произойдет, если два клиента опубликуют инструмент с одинаковым именем?
Если схема входных параметров совпадает, вызовы будут распределяться между сессиями по круговому принципу. Если схемы разные, инструмент скрывается из списка до устранения конфликта.
Обсуждение
Вопросов и отзывов пока нет.
Единый MCP-шлюз для 1С с дашбордом
onec-mcp-universal
Docker-шлюз с одним адресом вместо нескольких MCP-подключений: данные 1С, навигация по BSL, поиск по ИТС через 1С:Напарник и веб-дашборд
Нативный компонент, который поднимает полноценный MCP-сервер внутри 1С: инструменты, ресурсы, промпты пишутся на BSL, а протокол берет на себя DLL
MCP-сервер в клиенте 1С
1C Client MCP Server
Расширение 1С, которое поднимает MCP-сервер прямо внутри клиента 1С:Предприятия и позволяет описывать свои инструменты на BSL
1C Agent Platform: три MCP-сервера для 1С
1C Agent Platform
Платформа из трех MCP-серверов для чтения, записи и интеллектуальных операций с конфигурациями и инфобазами 1С:Предприятие, с bearer-аутентификацией по HTTP
MCP-шлюз на Go между агентом и HTTP-сервисом 1С: справочники, продажи, остатки, деньги и расчеты по нескольким базам
MCP-сервер внутри 1С
1c_mcp
Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL
Коротко о 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.