Документация MCP-1C

Дерево метаданных конфигурации

Список всех объектов конфигурации по категориям: справочники, документы, регистры, перечисления, обработки и т.д. Без фильтра возвращает сводку (категории и количество), с фильтром — полный перечень объектов категории. Вызывается первым при работе с незнакомой конфигурацией.

Параметры:

• filter (необязательный) - категория для фильтрации: Справочники, Документы, РегистрыНакопления, ОбщиеМодули и др.

Реквизиты и структура объекта

Реквизиты, табличные части, измерения, ресурсы, значения перечисления и типы полей объекта метаданных. Возвращает точные имена реквизитов, табличных частей и значений перечислений для запросов и кода. Для Enum дополнительно возвращается список значений перечисления.

Параметры:

• object_type (обязательный) - тип объекта: Catalog, Document, Enum, InformationRegister, AccumulationRegister и др.
• object_name (обязательный) - имя объекта, например РеализацияТоваровУслуг

Выполнить запрос к данным

Выполняет запрос на языке 1С (только ВЫБРАТЬ/SELECT — безопасно для рабочих баз) и возвращает данные: элементы справочников, документы, остатки, обороты, сведения из регистров. Поддерживает параметры через &Имя.

Параметры:

• query (обязательный) - текст запроса (только ВЫБРАТЬ/SELECT)
• limit (необязательный) - максимум строк результата (по умолчанию 100, максимум 1000)
• parameters (необязательный) - параметры запроса в виде пар ключ-значение (имя без амперсанда)

Проверка синтаксиса запроса

Проверяет синтаксис запроса 1С без выполнения и находит ошибки в ВЫБРАТЬ/SELECT. Рекомендуется вызывать перед execute_query.

Параметры:

• query (обязательный) - текст запроса для проверки

Поиск по коду модулей

Полнотекстовый поиск по коду всех модулей конфигурации. Три режима: smart (полнотекстовый с ранжированием BM25, по умолчанию), regex (регулярные выражения), exact (точная подстрока). Поддерживает BSL-синонимы: поиск по английским именам находит русские и наоборот.

Параметры:

• query (обязательный) - поисковый запрос
• mode (необязательный) - smart, regex или exact
• category (необязательный) - фильтр по типу метаданных (Документ, ОбщийМодуль)
• module (необязательный) - фильтр по типу модуля (МодульОбъекта, МодульМенеджера)
• limit (необязательный) - максимум результатов (по умолчанию 50, максимум 500)

Требует: --dump (путь к выгрузке конфигурации DumpConfigToFiles)

Структура формы объекта

Структура управляемой формы: элементы интерфейса, команды, кнопки и обработчики событий. Состав элементов и обработчики берутся из Form.xml выгрузки конфигурации; без --dump возвращаются только имя и заголовок формы.

Параметры:

• object_type (обязательный) - тип объекта: Document, Catalog, DataProcessor и др.
• object_name (обязательный) - имя объекта метаданных
• form_name (необязательный) - имя формы (без него возвращается первая найденная)

Полная структура требует: --dump

Журнал регистрации

Чтение журнала регистрации 1С — лог ошибок, действий пользователей и системных событий. Фильтрация по дате, уровню важности и пользователю.

Параметры (все необязательные):

• start_date, end_date - период в формате ISO 8601
• level - уровень важности: Ошибка, Предупреждение, Информация, Примечание
• user - имя пользователя 1С для фильтрации
• limit - максимум записей (по умолчанию 50, максимум 500)

Информация о конфигурации

Общая информация о базе 1С: название конфигурации, версия, поставщик, версия платформы, режим работы (файловый / клиент-серверный). Полезно вызвать первым делом, чтобы понять, с какой конфигурацией работаете. Параметров нет.

Справочник функций языка 1С

Справка по 180 встроенным функциям, методам типов и объектным паттернам языка 1С (BSL): строки, числа, даты, коллекции, файлы, HTTP, XML/JSON, транзакции, методы ТаблицаЗначений/Массив/Структура/Соответствие/Запрос и др. Возвращает синтаксис, параметры и пример использования.

Параметры:

• query (обязательный) - название функции на русском или английском, например СтрНайти или StrFind

Анализ и проверка кода

Действия:

• action: "explain" - глубокий статический анализ кода BSL с 6 анализаторами: сложность, ошибки, стиль, производительность, безопасность, совместимость
• action: "check" - проверка кода BSL на типичные ошибки и антипаттерны
• action: "compatibility" - анализ совместимости с версиями платформы 1С, breaking changes, матрица совместимости

Генерация и оптимизация кода

Действия:

• action: "query" - генерация запросов 1С по текстовому описанию с учетом структуры конфигурации
• action: "print_form" - генерация кода печатных форм: шапка, табличная часть, итоги
• action: "async_convert" - преобразование синхронных вызовов BSL в асинхронные
• action: "optimize_query" - статический анализ запросов на 15 антипаттернов производительности

Поиск и чтение кода расширений

Расширенная версия автоматически обнаруживает установленные расширения конфигурации (.cfe) и включает их модули в code_search и code_read. Результаты расширений помечаются префиксом [Расш].

Массовый анализ кодовой базы 1С

Комплексный анализ всей кодовой базы: антипаттерны, дубли кода, мертвый код, аудит безопасности, метрики качества. Требует предварительного построения кэша командой --build-bulkanalysis.

Действия:

• action: "summary" - сводка по всей кодовой базе: количество модулей, находок по категориям, общий балл техдолга
• action: "findings" - антипаттерны и ошибки кода (30 правил): неоптимальные запросы, утечки ресурсов, устаревшие конструкции
• action: "duplicates" - дубли кода (MinHash + LSH): похожие фрагменты в разных модулях с процентом совпадения
• action: "deadcode" - мертвый код: неиспользуемые процедуры, переменные, параметры
• action: "security" - аудит безопасности BSL (11 правил SEC): SQL-инъекции, небезопасные вызовы, утечки данных
• action: "metrics" - метрики качества: LOC, цикломатическая сложность, глубина вложенности, балл техдолга (0-100)
• action: "trends" - динамика показателей между запусками анализа

Параметры:

• cvss_format - формат отчёта при action=findings + category=security: auto (по умолчанию, группировка по CVSS-критичности), grouped (всегда CVSS-группировка), flat (плоский список)

Требует: --dump + --build-bulkanalysis (предварительное построение кэша)

Граф зависимостей объектов

Визуализация связей между модулями конфигурации. Требует предварительного построения кэша командой --build-depgraph.

Параметры:

• object (обязательный) - имя объекта метаданных для анализа зависимостей
• direction - направление обхода: reverse (кто зависит от объекта), forward (от кого зависит объект), both
• depth - глубина обхода графа (1-3)
• format - формат вывода: text, json, mermaid

Требует: --dump + --build-depgraph (предварительное построение кэша)

Семантический поиск по коду

Поиск по смыслу, а не по тексту. Находит связанный код даже если названия отличаются. Требует флага --enable-semantic при запуске.

Режимы:

• mode: "semantic" - чистый векторный поиск (LSA, Randomized SVD)
• mode: "hybrid" - комбинация BM25 + векторный поиск для максимальной точности

Требует: --dump + --enable-semantic

Mermaid-диаграммы архитектуры конфигурации

Команда --build-archviz строит Mermaid-диаграммы трёх уровней архитектуры: иерархия подсистем и их вложенность, связи документов с регистрами накопления, сведений и бухгалтерии, бизнес-процессы с точками маршрута и BSL-обработчиками.

Опционально диаграммы экспортируются в SVG или JSON. Поддерживается фильтрация по конкретной подсистеме или категории объектов, ограничение количества узлов и пакетный экспорт всех режимов сразу.

Пример запуска:

mcp-1c-advanced --build-archviz \
  --arch-viz all \
  --output-dir ./diagrams \
  --dump /path/to/dump

Параметры:

• --build-archviz запустить генерацию диаграмм и выйти
• --arch-viz режим: subsystems, doc-reg, bp или all
• --output-format формат: mermaid, svg или json (по умолчанию mermaid)
• --output-dir каталог для записи файлов (обязателен при --arch-viz all)
• --filter-subsystem ограничить рамки одной подсистемой (рекурсивно по вложенным)
• --filter-category ограничить тип объектов (Документ, РегистрНакопления и т. п.)
• --max-nodes максимум узлов на диаграмме (по умолчанию 100)
• --show-handlers показывать BSL-обработчики на диаграммах бизнес-процессов (по умолчанию включено)

При ответе свыше 1 MiB (env MCP_ARCHVIZ_BUDGET_BYTES) сервер сохраняет артефакт в локальный кэш и возвращает manifest {path, size_bytes, sha256, mime_type} — AI-клиент читает файл напрямую.

Требует: --dump

Учётные данные YandexGPT или GigaChat для LLM-функций

Четыре функциональности Профессиональной редакции используют внешние LLM API для обогащения результатов: Автогенерация документации (--build-autodoc), Генерация тестов (--build-testgen), Генерация .epf обработок (--build-epfgen) и Навигация по типовым конфигурациям (--build-typicalconfigs).

Поддерживаются два провайдера: YandexGPT (по умолчанию, выбирается флагом --autodoc-provider yandexgpt) и GigaChat (--autodoc-provider gigachat). Учётные данные читаются из переменных окружения и должны быть заданы до запуска.

Переменные окружения:

# YandexGPT (по умолчанию)
export YANDEXGPT_API_KEY=AQVN...
export YANDEXGPT_FOLDER_ID=b1g...

# GigaChat
export GIGACHAT_CLIENT_ID=...
export GIGACHAT_CLIENT_SECRET=...

Где взять учётные данные:

• YandexGPT сервисный аккаунт Yandex Cloud с ролью ai.languageModels.user, API-ключ выпускается в консоли Yandex Cloud, идентификатор каталога указан там же на странице каталога
• GigaChat регистрация в портале разработчика Сбера, после этого выпускаются Client ID и Client Secret для авторизации

Если переменные не заданы, бинарник завершит работу с ошибкой вида --autodoc-provider=yandexgpt требует переменные окружения YANDEXGPT_API_KEY и YANDEXGPT_FOLDER_ID (или аналогично для GigaChat).

Запуск без LLM:

• --testgen-llm-disable генерация только скелетов YAxUnit/Vanessa без LLM-комментариев
• --epfgen-llm-disable генерация бандлов .epf без LLM-обогащения
• --typicalconfigs-llm-disable индексация подсистем без описаний (Markdown-файлы будут пустыми)
• У --build-autodoc отдельного флага отключения LLM нет: автогенерация документации полностью построена на ответах модели и без API-ключей не запускается

Markdown-описания объектов через YandexGPT или GigaChat

Команда --build-autodoc формирует отдельный Markdown-файл для каждого объекта конфигурации с описанием назначения, реквизитов, табличных частей и связей с другими объектами.

Поддерживаются провайдеры YandexGPT и GigaChat. Результаты кэшируются: повторный запуск регенерирует только изменившиеся объекты, если не задан --autodoc-regen.

Пример запуска:

mcp-1c-advanced --build-autodoc \
  --dump /path/to/dump \
  --autodoc-out ./docs/auto \
  --autodoc-provider yandexgpt

Параметры:

• --build-autodoc запустить генерацию документации и выйти
• --autodoc-out каталог для autodoc Markdown-файлов (по умолчанию docs/auto)
• --autodoc-provider LLM-провайдер: yandexgpt или gigachat
• --autodoc-model модель провайдера (например, yandexgpt-lite)
• --autodoc-kinds виды объектов через запятую: all либо Document,Catalog,AccumulationRegister,InformationRegister,Report,DataProcessor
• --autodoc-regen игнорировать кэш и перегенерировать все объекты
• --autodoc-concurrency размер пула воркеров (по умолчанию 4)
• --autodoc-max-input-tokens лимит входных токенов на объект (модуль усекается, по умолчанию 6000)
• --autodoc-rps лимит запросов в секунду к LLM-провайдеру (по умолчанию 5.0)

При ответе свыше 1 MiB (env MCP_AUTODOC_BUDGET_BYTES) сервер сохраняет артефакт в локальный кэш и возвращает manifest {path, size_bytes, sha256, mime_type} — AI-клиент читает файл напрямую.

Требует: --dump + API-ключ выбранного LLM-провайдера (см. Настройка LLM провайдера)

Автоматическая генерация YAxUnit и Vanessa-тестов

Команда --build-testgen анализирует BSL-модули конфигурации и формирует scaffold-тесты YAxUnit для экспортированных процедур и функций (правила TG001-TG019), Vanessa .feature сценарии для taint-находок с критичностью CVSS не ниже Medium (правило TG020), а также файл manifest.json с итогами прогона.

Доступна как разовая генерация (--build-testgen) либо в режиме MCP-сервера (--enable-testgen) для интерактивных запросов от AI-ассистента.

Пример запуска:

mcp-1c-advanced --build-testgen \
  --dump /path/to/dump \
  --testgen-framework auto \
  --testgen-output ./tests

Параметры:

• --build-testgen запустить разовую генерацию тестов и выйти
• --enable-testgen включить testgen в режиме MCP-сервера
• --testgen-output каталог для записи тестовых файлов (по умолчанию <dump>/.testgen-output)
• --testgen-framework фреймворк: yaxunit, vanessa, both или auto (выбирается по типу объекта)
• --testgen-rules подмножество правил TG001..TG020 через запятую
• --testgen-regen игнорировать кэш и перегенерировать все тесты
• --testgen-taint-regressions эмитировать Vanessa-регрессии по taint-находкам (правило TG020)
• --testgen-include-bsp генерировать тесты для модулей БСП/SSL
• --testgen-concurrency число параллельных воркеров (по умолчанию min(CPU, 8))
• --testgen-llm-disable отключить обогащение через LLM (работает без API-ключей)
• --testgen-emit-sarif путь для SARIF 2.1.0 отчёта по testgen
• --testgen-audit-trail путь к audit log testgen (по умолчанию <dump>/.testgen-audit.log)
• --testgen-vendor-baseline путь к vendor-baseline дампу для фильтрации стандартных модулей

Требует: --dump + API-ключ LLM-провайдера или флаг --testgen-llm-disable (см. Настройка LLM провайдера)

Designer-compatible XML+BSL бандлы внешних обработок 1С

Команда --build-epfgen формирует Designer-compatible XML+BSL бандлы для всех 6 видов внешних обработок 1С: ПечатнаяФорма, ЗаполнениеОбъекта, СозданиеСвязанныхОбъектов, Отчет, ДополнительнаяОбработка, ДополнительныйОтчет. Каждый бандл соответствует БСП-контракту и готов к загрузке Конфигуратором.

Опционально формируются скрипты pack.cmd / pack.sh для сборки бинарного .epf. В config-aware режиме при наличии Configuration.xml LLM может предлагать имена реквизитов, согласованные с метаданными целевой конфигурации.

Доступна как разовая генерация (--build-epfgen) либо в режиме MCP-сервера (--enable-epfgen) для интерактивных запросов от AI-ассистента.

Пример запуска:

mcp-1c-advanced --build-epfgen \
  --epfgen-spec ./bundles.yaml \
  --epfgen-pack

Параметры:

• --build-epfgen запустить разовую генерацию бандлов и выйти
• --enable-epfgen включить epfgen в режиме MCP-сервера
• --epfgen-spec путь к YAML/JSON-файлу со списком бандлов (обязательный для --build-epfgen)
• --epfgen-output каталог для записи бандлов и manifest.json
• --epfgen-config-path путь к Configuration.xml для config-aware режима
• --epfgen-regen игнорировать кэш и перегенерировать все бандлы
• --epfgen-pack дополнительно генерировать pack.cmd / pack.sh для сборки .epf через Конфигуратор
• --epfgen-emit-tests эмитировать sibling YAxUnit-тесты через testgen API
• --epfgen-suggest-attrs LLM-подсказки имён реквизитов (требует config-aware + LLM)
• --epfgen-concurrency число параллельных воркеров (по умолчанию min(CPU, 8))
• --epfgen-llm-disable отключить обогащение через LLM (работает без API-ключей)
• --epfgen-emit-sarif путь для SARIF 2.1.0 отчёта
• --epfgen-audit-trail путь к epfgen audit log
• --epfgen-platform-version целевая версия 1С (по умолчанию 8.3.10); контролирует версию формата MDClasses XML

Параметр rule_id (в YAML/JSON-спецификации бандла, а также в MCP-вызове epfgen.generate) принимает идентификаторы из набора EG001-EG020 (полный список встроенных правил).

Требует: --epfgen-spec для разовой генерации + API-ключ LLM-провайдера или флаг --epfgen-llm-disable (см. Настройка LLM провайдера)

Автоматическая классификация семейства типовой и индекс подсистема ↔ объект

Команда --build-typicalconfigs определяет семейство типовой конфигурации по сигнатурам метаданных и строит двусторонний индекс подсистема ↔ объект для AI-навигации. Поддерживается распознавание основных линеек: Бухгалтерия предприятия 3.0, Зарплата и управление персоналом 3.1, Управление торговлей 11, Розница, Комплексная автоматизация и ERP.

Объекты классифицируются по правилам TC001-TC020 на shared (БСП/SSL), bp_specific, zup_specific, ut_specific и retail_specific. Поверх классификации детектируются кастомные доработки заказчика поверх типовой конфигурации.

В результате формируется набор артефактов: index.json (подсистема → объекты), reverse.json (объект → подсистемы), manifest.json с метаданными о версии платформы и обнаруженном семействе, а также по одному .md файлу на каждую подсистему с LLM-обогащённым описанием.

В режиме MCP-сервера (--enable-typicalconfigs) AI-ассистент получает доступ к единому tool typicalconfigs с действиями detect (определить семейство), subsystems (список подсистем), lookup (найти объект по имени), reverse_lookup (из объекта в подсистемы) и extension_points (точки расширения).

Пример запуска (разовая индексация):

mcp-1c-advanced --build-typicalconfigs \
  --typicalconfigs-dump-path ./dump \
  --typicalconfigs-output ./typicalconfigs-output \
  --typicalconfigs-llm-disable

Пример запуска (MCP-сервер с включённой навигацией):

mcp-1c-advanced --enable-typicalconfigs \
  --base main=https://erp.example.com \
  --dump main=./dump

Параметры:

• --build-typicalconfigs запустить разовую индексацию и выйти
• --enable-typicalconfigs включить typicalconfigs в режиме MCP-сервера
• --typicalconfigs-output каталог для index.json, reverse.json, manifest.json и per-subsystem .md файлов
• --typicalconfigs-dump-path путь к dump-каталогу (обязателен при --build-typicalconfigs)
• --typicalconfigs-regen игнорировать кэш и регенерировать индекс
• --typicalconfigs-llm-disable отключить обогащение через LLM (описания подсистем останутся пустыми)
• --typicalconfigs-concurrency размер пула воркеров (по умолчанию min(CPU, 8), значение 0 означает auto)
• --typicalconfigs-emit-sarif путь для SARIF 2.1.0 отчёта
• --typicalconfigs-audit-trail путь к audit log по операциям typicalconfigs
• --typicalconfigs-max-subsystems cap для очень больших дампов (по умолчанию 500); подсистемы свыше cap получают статус truncated
• --typicalconfigs-platform-version целевая версия 1С (по умолчанию 8.3.10)

Требует: API-ключ LLM-провайдера или флаг --typicalconfigs-llm-disable (см. Настройка LLM провайдера)

Подавление проверок прагмами typconf:ignore

Чтобы выборочно отключить классификацию или проверки typicalconfigs на уровне отдельной строки или процедуры, используйте комментарии-прагмы в BSL-коде:

// Отключить проверку для конкретной строки:
ВыполнитьСлужебнуюЛогику(); // typconf:ignore

// Отключить проверки в пределах процедуры целиком:
Процедура КастомнаяОбработка() Экспорт
    // typconf:ignore
    // ...тело процедуры...
КонецПроцедуры

Прагма typconf:ignore действует только в области, где она объявлена (на текущей строке или в текущей процедуре) и не отключает классификацию объекта в целом.

Сравнение двух версий расширения .cfe с typed-разбором BSL, форм и метаданных

Замена ручному diff или git-diff бинарных .cfe (которые показывают только «файл изменён»). CFEDiff распаковывает оба расширения, разбирает структуру и выдаёт Markdown-отчёт с детальным сравнением BSL-кода, форм и метаданных.

Для кого:

• 1С-разработчики, работающие с расширениями типовых конфигураций (yaxunit, BIA-Standard и т. д.)
• DevOps-команды с CI/CD pipeline для расширений
• Team leads на code review для PR с изменениями .cfe

Способ 1. Через Claude Code (MCP-инструмент)

В режиме MCP-сервера действие code_review.review_extension принимает пути к двум .cfe и возвращает Markdown-отчёт прямо в чате.

Пример вызова:

{
  "action": "review_extension",
  "base_path": "/repo/master/MyExt.cfe",
  "head_path": "/repo/feature/MyExt.cfe",
  "format": "markdown"
}

Способ 2. CLI для CI и pre-commit

Подкоманда review бинарника mcp-1c-pro запускается из CI или git-hook:

mcp-1c-pro review base.cfe head.cfe --format markdown -o diff.md
echo "exit code: $?"  # 0 = no diff, 1 = diff found, 2 = error

Подходит для:

• pre-commit hook — блокирует PR, если BSL-diff превышает порог
• GitHub Actions / GitLab CI — оставляет рендер diff комментарием на PR
• daily backup-diff — что изменилось со вчера

Готовый шаблон GitHub Actions см. в docs/cfediff/example-workflow.yml репозитория mcp-1c-advanced.

Опциональные флаги

• --format markdown|json|text формат вывода (по умолчанию markdown)
• --ignore-* (11 флагов) фильтры технического шума: trailing whitespace, line endings, BOM, UUID-порядок и т. д.
• --no-watermark убрать водяной знак Trial (доступно только для verified-paid лицензий)
• --diagnostic добавить диагностический zip-пакет (для тикетов поддержки)
• --bug-report PII-safe tar.gz для GitHub-issue submission
• --enable-ibcmd экспериментальная валидация через ibcmd (8.3.27+, опционально)

Что внутри Markdown-отчёта

# CFEDiff
**Base:** path/to/base.cfe (SHA-256 ...)
**Head:** path/to/head.cfe (SHA-256 ...)

## Сводка
- Добавлено: 8 объектов
- Удалено:   1 объект
- Изменено:  9 объектов
- BSL-строк (+/-): 7065 / 238

## Изменённые объекты

### CommonModule РГП_ГлобальныйПоискВызовСервера
@@ -1,20 +1,122 @@
+// @skip-check bsl-legacy-check-pragma-for-unused-method - Баг ЕДТ
 #Область ОбработчикиСобытий
 ...

## Активные фильтры
- IgnoreTrailingWhitespace
- IgnoreLineEndings
...

Поддерживаемые форматы экспорта

CFEDiff умеет читать оба формата:

• Canonical Designer экспорт через 1С Designer DESIGNER /DumpCfg (8.3.x)
• ibcmd-Mac/Linux экспорт через ibcmd config export (8.3.27+)

Лицензирование

• Trial (14 дней) полный функционал + watermark с датой истечения лицензии
• Pro / verified-paid чистый вывод без watermark, флаг --no-watermark доступен
• Advanced (без Pro) запуск review вернёт subcommand requires Pro edition + exit 2

Текущие ограничения

• Structural diff форм для расширений, выгруженных через ibcmd config export, использует hash-fallback (изменилась форма / не изменилась). Детальный структурный diff форм работает на canonical-выгрузке из Designer.
• Опциональная ibcmd-валидация (флаг --enable-ibcmd, по умолчанию выключена) — это best-effort слой сверки через официальную CLI ibcmd. Сейчас она всегда завершается информационным предупреждением (IBCMD_NOT_AVAILABLE) и не выполняет canonical-сравнение через config export; результат diff от неё не зависит и не блокируется (exit code не меняется).
• Foreign-UUID naming некоторые ChildObjects (CommonModule, заимствованные из других расширений) отображаются как UUID, а не по имени.

Цена: см. тарифы для актуальной стоимости Pro-лицензии.

Подкоманда review. Требует Pro или Trial-лицензию.