ИИ для 1С: как нейросеть видит конфигурацию и пишет код на BSL
- ии
- нейросеть
- 1c
- ai
- bsl
ИИ для 1С через протокол MCP. Нейросеть читает метаданные конфигурации, ищет код по BSL и пишет запросы. Редакции, инструменты, подключение к Claude и Cursor.
TL;DR: ИИ для 1С работает по простой схеме: рассуждает и пишет код привычная нейросеть (Claude, Cursor), а доступ к вашей конфигурации ей даёт отдельный сервер MCP-1C. Сервер показывает модели метаданные базы, исходники на BSL и результаты запросов, а модель уже превращает это в готовый код и объяснения. Ниже разобрано, что нейросеть для 1С умеет сегодня, чем отличаются редакции и как подключить ИИ-агента к базе.
Что такое ИИ для 1С и как нейросеть вообще видит конфигурацию?
ИИ для 1С это связка из двух частей: AI-клиента с языковой моделью и MCP-сервера, который даёт этой модели контекст вашей базы. Между ними стоит открытый стандарт MCP (Model Context Protocol). По формулировке спецификации, это open-source стандарт для подключения AI-приложений к внешним системам, а официальная аналогия для него: порт USB-C для AI-приложений.
MCP устроен по схеме клиент-сервер. AI-приложение (например, Claude Code или Claude Desktop) выступает хостом и создаёт по одному MCP-клиенту на каждый сервер, а клиент держит выделенное соединение. В терминах спецификации: хост координирует один или несколько клиентов, клиент поддерживает соединение с сервером, а сервер предоставляет клиентам контекст.
Сервер отдаёт модели три вида примитивов: инструменты (Tools, исполняемые функции, которые ИИ вызывает, например запрос к базе), ресурсы (Resources, источники контекстных данных) и промпты (Prompts, переиспользуемые шаблоны взаимодействия). MCP-1C это как раз такой сервер для платформы 1С:Предприятие: он даёт AI-ассистентам доступ к метаданным базы, коду BSL, запросам и документации через протокол MCP. Написан на Go, один бинарник, без внешних зависимостей.
Что нейросеть даёт 1С-разработчику уже сейчас?
Прямо сейчас ИИ-агент для 1С читает структуру конфигурации, ищет нужный код, пишет и объясняет BSL, проверяет запросы и помогает с ревью. Всё это идёт через инструменты MCP-1C, а не через прямой доступ модели к базе.
| Возможность | Как работает через MCP-1C | Инструмент |
|---|---|---|
| Чтение метаданных конфигурации | модель получает дерево объектов и состав реквизитов | get_metadata_tree, get_object_structure |
| Поиск по коду BSL | полнотекстовый поиск, семантический в Профессиональной | search_code, code_search |
| Генерация и объяснение кода | модель пишет и разбирает BSL по полученному контексту | code_generate, code_analyze (Расширенная) |
| Ревью и анализ | BSL-линтер, оптимизатор запросов, проверка совместимости | инструменты Расширенной редакции |
| Генерация тестов | сценарии YAxUnit и Vanessa | инструменты Профессиональной редакции |
Базовый набор Открытой редакции это 9 инструментов: get_metadata_tree (дерево метаданных), get_object_structure (реквизиты, табличные части, измерения), execute_query (выполнение запросов 1С, только SELECT), validate_query (проверка синтаксиса без выполнения), search_code (полнотекстовый поиск по BSL на BM25), get_form_structure, get_event_log, get_configuration_info и bsl_syntax_help (180 встроенных функций BSL).
Какие редакции есть и что каждая добавляет для ИИ-сценариев?
Редакций четыре: Открытая, Расширенная, Профессиональная и Корпоративная (последняя в разработке). Каждая платная редакция добавляет инструменты, которые делают ответы нейросети точнее и шире по охвату.
| Редакция | Бинарник | Цена | Что добавляет для ИИ-сценариев |
|---|---|---|---|
| Открытая | mcp-1c | 0 ₽ | чтение метаданных, поиск по коду, запросы SELECT |
| Расширенная | mcp-1c-advanced | 1 990 ₽/мес | оптимизатор запросов, BSL-линтер, проверка совместимости, синтакс-справочник платформы |
| Профессиональная | mcp-1c-pro | 4 990 ₽/мес | массовый анализ, граф зависимостей, семантический поиск, ревью расширений, генерация тестов и доков |
| Корпоративная | в разработке | в разработке | многопользовательский режим на общем сервере |
Расширенная редакция добавляет оптимизатор запросов (15 антипаттернов), BSL-линтер (30 диагностик), полный синтакс-справочник платформы (около 10000 определений из .hbk-файлов), поиск с учётом русской морфологии, проверку совместимости версий (8.3.x и 8.5.x), поддержку расширений .cfe, работу с несколькими базами, песочницу кода, память по каждой базе, шаблоны, а также выведенную XSD-схему с проверкой XML.
Профессиональная редакция это надмножество Расширенной. Сверх неё она даёт массовый анализ всей кодовой базы (bulk_analyze, включая аудит безопасности с CVSS, CWE и OWASP и справочными ссылками на ГОСТ Р 57580.1 и приказ ФСТЭК N 21), граф зависимостей (dependency_graph), иерархию вызовов (call_hierarchy), семантический и векторный поиск по коду, ревью кода (review_extension, base_vs_ext, CFEDiff, опциональное второе мнение через ibcmd), визуализацию архитектуры в Mermaid, автогенерацию документации (YandexGPT, GigaChat), генерацию тестов YAxUnit и Vanessa, генерацию .epf, совместимых с Конфигуратором, и навигацию по типовым конфигурациям. Годовая оплата дешевле: Расширенная 19 900 ₽/год, Профессиональная 49 900 ₽/год (около 17% экономии). Подробное сравнение есть на странице тарифов.
Как подключить ИИ к базе 1С через Claude Code?
Подключение сводится к четырём шагам: скачать бинарник, опубликовать HTTP-сервис в 1С, добавить сервер командой claude mcp add и проверить список инструментов через /mcp.
| Шаг | Команда или действие |
|---|---|
| 1. Скачать бинарник нужной редакции | mcp-1c, mcp-1c-advanced или mcp-1c-pro |
| 2. Опубликовать HTTP-сервис в 1С | путь вида /hs/mcp-1c |
| 3. Добавить сервер в Claude Code | claude mcp add --transport stdio 1c -- mcp-1c-pro --base http://localhost:8080/hs/mcp-1c |
| 4. Проверить подключение | команда /mcp в Claude Code |
Рекомендуемый способ для Claude Code это команда claude mcp add. Её синтаксис: claude mcp add [options] <name> -- <command> [args...]. Двойное тире отделяет опции самого Claude Code от команды запуска сервера: всё, что идёт после --, передаётся серверу без изменений.
claude mcp add --transport stdio 1c -- mcp-1c-pro --base http://localhost:8080/hs/mcp-1c
Область видимости задаётся флагом --scope: local (по умолчанию, только вы в текущем проекте), project (общий через .mcp.json) и user (вы во всех проектах).
claude mcp add --scope user --transport stdio 1c -- mcp-1c-pro --base http://localhost:8080/hs/mcp-1c
То же самое можно прописать в файле конфигурации (~/.claude.json в Linux и macOS, %USERPROFILE%\.claude.json в Windows) в секции mcpServers:
{
"mcpServers": {
"1c": {
"command": "mcp-1c-pro",
"args": ["--base", "http://localhost:8080/hs/mcp-1c"]
}
}
}
Флаг --base это путь к опубликованному HTTP-сервису внутри 1С, а localhost:8080 здесь только пример, подставьте свой адрес. Доступ к этому HTTP-сервису может требовать флагов --user и --password; подробный разбор в руководстве по подключению к Claude Code и документации. Для Открытой редакции укажите mcp-1c, для Расширенной mcp-1c-advanced. В официальных примерах Claude Code транспорт stdio указывают явно флагом --transport stdio, поэтому он есть и в командах выше. Поддерживаются Claude Desktop, Cursor, VS Code (Continue, Cline), JetBrains и Claude Code, платформа 1С 8.3.x и 8.5.x (коммерческая и учебная), ОС Windows, macOS и Linux (amd64, arm64). Разбор настройки для другого клиента есть в заметке про подключение к Cursor.
Раньше для больших баз приходилось поднимать настройку MCP_TIMEOUT в Claude Code (значение в миллисекундах): она задаёт, сколько ждать запуска сервера. Начиная с версии 2.23.4 MCP-1C готов сразу и строит индекс в фоне, так что поднимать MCP_TIMEOUT для больших конфигураций больше не нужно. Синтаксис claude mcp add указан по официальной документации на дату публикации.
Что ИИ для 1С не делает и какие у него границы?
Нейросеть для 1С не заменяет разработчика и не правит базу сама: рассуждение живёт в клиенте, а сервер только подаёт контекст и инструменты. Спецификация MCP здесь однозначна: протокол отвечает только за обмен контекстом и не диктует, как AI-приложение использует языковую модель и управляет контекстом. То есть качество ответов задаёт модель в Claude или Cursor, а MCP-1C отвечает за факты о вашей базе.
Из этого следуют практические границы. Инструмент execute_query в Открытой редакции работает только на чтение (SELECT), а значит модель анализирует данные, но не пишет в боевую базу через этот инструмент. Правки в Конфигуратор и в работающую базу автоматически не вносятся: код, который сгенерировала нейросеть, вы переносите и проверяете сами. Это и есть честный режим работы: ИИ ускоряет рутину и подсказывает, а решение и ответственность остаются за разработчиком.
Нужен ли интернет и сколько человек обслуживает один процесс?
Сам сервер MCP-1C работает полностью локально, и интернет ему для работы не нужен. Сеть требуется только AI-клиенту (Claude, Cursor), чтобы достучаться до своей облачной модели. Расширенная и Профессиональная редакции дополнительно периодически проверяют лицензию через интернет.
По числу пользователей: транспорт stdio означает, что один запущенный процесс обслуживает ровно одного пользователя. Встроенный HTTP-сервер (флаг --listen) это только транспорт длинного опроса для 1С, а не многопользовательский MCP-сервер. Многопользовательский режим на общем сервере это задача Корпоративной редакции, которая пока в разработке.
Полный список инструментов и параметров запуска есть в документации, общий обзор продукта на главной странице, а пошаговый разбор самого протокола в заметке про MCP-сервер для 1С.