Единый MCP-шлюз для 1С с дашбордом
onec-mcp-universal
Docker-шлюз с одним адресом вместо нескольких MCP-подключений: данные 1С, навигация по BSL, поиск по ИТС через 1С:Напарник и веб-дашборд
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструмент write_bsl записывает BSL-код прямо в проект
- Дает доступ к данным, коду и журналу регистрации подключенных баз 1С, стоит начинать с тестовой базы
Установка
Ручная установка
cp .env.example .env && ./setup.shНачальная настройка на Linux или Windows перед запуском контейнеров.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Шлюз объединяет 47 MCP-инструментов и один ресурс под одним адресом http://localhost:8080/mcp вместо нескольких отдельных подключений. Каждый сеанс AI-ассистента работает со своей активной базой независимо благодаря per-session routing по заголовку Mcp-Session-Id. Инструменты покрывают запросы к данным 1С, выполнение кода, метаданные, журнал регистрации, права, навигацию и полнотекстовый поиск по BSL, запись BSL-модулей с переиндексацией, поиск по ИТС через API 1С:Напарника, анонимизацию персональных данных по 152-ФЗ, кеширование метаданных и профилирование запросов. Обработка MCPToolkit.epf в клиенте 1С подключает базу к шлюзу одной кнопкой, есть веб-дашборд для статуса и настроек и 72 скилла для Claude Code.
Для кого. Для 1С-разработчиков, которые хотят один MCP-шлюз на несколько баз и AI-ассистентов вместо отдельного подключения на каждую пару.
Подходит, если
- Нужно подключить несколько баз 1С к разным сеансам AI-ассистента одновременно
- Нужна запись BSL-кода прямо из агента с автопереиндексацией
- Нужна анонимизация персональных данных при работе с боевой базой
Не подходит, если
- Нужна одна простая интеграция без Docker и веб-дашборда
- Не готовы разворачивать несколько контейнеров: гейтвей, toolkit-прокси, platform-context, bsl-lsp
Пример запроса к агенту
Найди через onec-mcp-universal все документы с ошибкой проведения за вчера и покажи журнал регистрацииОграничения
Нужны Docker 24+ и Docker Compose v2, на Linux Ubuntu 22.04+ или Windows 10/11 с Docker Desktop. Часть образов внешние (roctup/1c-mcp-toolkit-proxy, alkoleft/mcp-bsl-platform-context), их развитие и поддержку контролирует не автор этого репозитория. Инструмент записи BSL-кода дает агенту право менять модули в проекте, учитывайте это при настройке доступа.
Как отключить. Остановите контейнеры командой docker compose down и удалите запись шлюза из конфигурации MCP-клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
Проверка безопасности
- Инструмент write_bsl записывает BSL-код прямо в проект
- Дает доступ к данным, коду и журналу регистрации подключенных баз 1С, стоит начинать с тестовой базы
Коротко о README
README подробно описывает архитектуру: шлюз onec-mcp-gw на Python, статические и динамические бэкенды по базам, модули анонимизации, кеша метаданных, профилировщика, поиска BSL и клиента 1С:Напарника. Дана таблица из 47 инструментов по категориям, требования к Docker, инструкции по Linux и Windows, подключение к Claude Code, Cursor и Windsurf, работа с несколькими базами и удаленное подключение шлюза на сервере 1С.
Частые вопросы
Можно ли подключить несколько баз одновременно?
Да, per-session routing разводит сеансы AI-ассистентов по разным базам независимо.
Как маскируются персональные данные?
Инструменты enable_anonymization и disable_anonymization включают маскировку ФИО, ИНН, СНИЛС, телефонов и email со стабильным hash-маппингом.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything