1C-ai-mcp: MCP-мост к 1С:Напарнику
1C-ai-mcp
MCP-сервер, который открывает облачного ассистента 1С:Напарник (1C.ai) и локальный BSL Language Server агентам в Cursor и других IDE
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- rename_symbol и format_bsl_code изменяют исходный код проекта
- Токен ONEC_AI_TOKEN и содержимое кода уходят во внешний облачный сервис 1С.ai
Установка
Ручная установка
git clone https://github.com/novoros-id/1C-ai-mcp.git && cd 1C-ai-mcp && pip install -r requirements.txtПосле установки зависимостей нужно создать .env с ONEC_AI_TOKEN.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает облачный сервис 1С:Напарник (1C.ai) в MCP-инструменты ask_1C_expert и explain_1C_syntax для вопросов по платформе, а локальный bsl-language-server встраивает как audit_code_expert, check_bsl_standards, format_bsl_code, get_code_completions и rename_symbol для статического анализа, форматирования и переименования символов в BSL-коде. Отдельно есть pack_project и analyze_project для упаковки проекта в контекст через Repomix, git_analyze_diff и git_conflict_helper для коммитов и мержей, debug_version_compare и generate_method_docs. При старте сервер сам определяет наличие Java и Node.js, недостающие инструменты (аудит, упаковка) автоматически отключаются, а BSL Language Server может фоново обновляться с GitHub. Для облачных инструментов нужен токен ONEC_AI_TOKEN, получаемый на code.1c.ai через учетную запись 1С:ИТС.
Для кого. Для 1С-разработчиков в Cursor или другой IDE на базе VS Code, которые хотят сочетать облачные подсказки 1С:Напарника со статическим анализом BSL в одном MCP-сервере.
Подходит, если
- Уже есть доступ к 1С:Напарнику и токен ONEC_AI_TOKEN
- Нужен гибридный аудит кода: BSL Language Server плюс объяснение ИИ
- Нужны форматирование, автодополнение и безопасный рефакторинг BSL прямо через MCP
Не подходит, если
- Нет учетной записи 1С:ИТС для получения токена 1C.ai
- Нет возможности установить Java и Node.js в окружении: часть инструментов отключится
- Нужен полностью локальный сервер без обращения к облачному сервису 1С
Пример запроса к агенту
Проведи гибридный аудит модуля ОбщийМодуль1.bsl и объясни, что не так с найденными нарушениями стандартовОграничения
Ключевые инструменты ask_1C_expert и explain_1C_syntax зависят от облачного сервиса 1C.ai и требуют платного или пробного токена, привязанного к 1С:ИТС. Аудит через BSL Language Server требует Java 11+, упаковка проекта через Repomix требует Node.js и npm, без них соответствующие инструменты отключаются без падения сервера. rename_symbol меняет исходный код и ссылки на него, стоит проверять результат перед коммитом.
Как отключить. Остановите MCP-сервер и удалите его из конфигурации MCP клиента, а токен ONEC_AI_TOKEN уберите из .env.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ONEC_AI_TOKEN обязательная, секрет | Токен доступа к облачному сервису 1C.ai, выпускается в личном кабинете code.1c.ai по учетной записи 1С:ИТС. |
| CODEBASE_OUTPUT_NAME | Имя файла, в который Codebase Manager упаковывает проект, необязательная настройка. |
Проверка безопасности
- rename_symbol и format_bsl_code изменяют исходный код проекта
- Токен ONEC_AI_TOKEN и содержимое кода уходят во внешний облачный сервис 1С.ai
Коротко о README
README подробно описывает четыре слоя функциональности (1С:Напарник, BSL-анализатор, Codebase Manager, git-интеграция), технические решения вроде стратегии Triple-Nest для API 1C.ai и SSE-парсинга, установку через pip и auto_setup.py, получение токена на code.1c.ai, системные требования (Java 11+, Node.js, Python 3.10+) и полный список из десяти MCP-инструментов с описанием.
Частые вопросы
Что если нет Java или Node.js?
Сервер продолжит работать, но инструменты аудита и упаковки проекта автоматически отключатся.
Где взять токен ONEC_AI_TOKEN?
На code.1c.ai после входа через учетную запись 1С:ИТС, в панели управления.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything