Справочник

Справочник CLI

Флаги командной строки всех редакций, переменные окружения и примеры команд.

Поведение командной строки (v2.18.0)

Справка --help платных бинарников (mcp-1c-advanced, mcp-1c-pro) при выводе в терминал открывается постранично (через $PAGER, по умолчанию less -R); в пайпах и CI выводится обычным сплошным текстом, детерминированно для скриптов.

При опечатке в команде или неизвестном флаге печатается короткая подсказка вместо полного списка флагов: «Введена неправильная команда. Запустите mcp-1c-advanced --help для получения списка команд».

Флаги Открытой версии mcp-1c

Совет: Флаги-переключатели со значением выключено включаются добавлением самого флага (например, --enable-semantic), без значения. Указывать true или false не нужно: например, --enable-semantic true вызовет ошибку.

Флаг	По умолчанию	Описание
`--base <URL>`	`http://localhost:8080/hs/mcp-1c`	URL HTTP-сервиса 1С. Env: `MCP_1C_BASE_URL`
`--user <имя>`	-	Пользователь HTTP-сервиса. Env: `MCP_1C_USER`
`--password <пароль>`	-	Пароль HTTP-сервиса. Env: `MCP_1C_PASSWORD`
`--max-response-size <МиБ>`	`128`	Максимальный размер ответа 1С в мебибайтах (MiB). Более крупный ответ отклоняется с понятной ошибкой. Увеличьте лимит для больших баз с расширениями. Env: `MCP_1C_MAX_RESPONSE_SIZE`
`--request-timeout <сек>`	`300`	Таймаут HTTP-запроса к 1С в секундах. Увеличьте, если передача очень большого ответа (например, расширений крупной базы) не успевает завершиться. Env: `MCP_1C_REQUEST_TIMEOUT`
`--dump <путь>`	-	Путь к выгрузке конфигурации (DumpConfigToFiles). Включает `code_search`
`--reindex`	выключено	Принудительная перестройка поискового индекса (игнорирует кэш)
`--install <путь>`	-	Установить расширение в базу 1С по указанному пути
`--server`	выключено	Режим клиент-серверной базы: `--install` принимает строку `сервер\база`
`--platform <путь>`	авто	Путь к исполняемому файлу платформы 1С (автоопределение, если не указан)
`--platform-version <версия>`	авто	Версия платформы 1С (например 8.3.13), определяется автоматически из пути. Минимум: 8.3.10
`--db-user <имя>`	-	Пользователь базы 1С для DESIGNER (режим `--install`)
`--db-password <пароль>`	-	Пароль базы 1С для DESIGNER (режим `--install`)
`--cache-dir <путь>`	авто	Каталог для кэша индекса и логов (по умолчанию системный каталог кэша). Env: `MCP_1C_CACHE_DIR`
`--quiet`	выключено	Подавить весь вывод в stderr даже в терминале. Имеет приоритет над `--verbose`. Также включается через env `MCP_1C_NO_TTY=1`
`--verbose`	выключено	Принудительный подробный вывод в stderr, даже когда stdin подключён к пайпу (полезно для отладки MCP-клиента). Переопределяется флагом `--quiet`
`--debug`	выключено	Подробное логирование в файл (~/.cache/mcp-1c/server.log). В режиме терминала также отключает индикатор прогресса

Флаги Расширенной версии mcp-1c-advanced

Включает все флаги Открытой версии, плюс следующие:

Флаг	По умолчанию	Описание
Мультибазовость
`--base NAME=URL`	-	Подключение базы с именем (повторяемый). Или просто URL для single-base режима
`--auth NAME=USER:PASS`	-	Учетные данные для именованной базы (повторяемый)
`--dump NAME=PATH`	-	Путь к выгрузке для именованной базы (повторяемый)
`--reindex NAME`	-	Перестроить индекс для именованной базы (повторяемый)
`--default-base <NAME>`	первая	Имя базы по умолчанию (если не указано -- первая `--base`)
Long Polling
`--listen <addr>`	-	Запустить HTTP-сервер для long polling (например, `:9090`)
`--poll-user <имя>`	-	Basic auth логин для polling-эндпоинта
`--poll-password <пароль>`	-	Basic auth пароль для polling-эндпоинта
`--poll-timeout <dur>`	`30s`	Таймаут ожидания ответа от 1С в polling-режиме
`--polling-extension-timeout <dur>`	`60s`	Бюджет загрузки расширений .cfe (GET /extensions) в polling-режиме. Отделён от `--poll-timeout`, чтобы крупный набор расширений не обрывался преждевременно (env: `MCP_1C_POLLING_EXTENSION_TIMEOUT`) (v2.23.0)
Polling-клиент (установка в 1С)
`--install-polling <путь>`	-	Установить polling-клиент в базу 1С. С `--server` поддерживает удалённую установку в клиент-серверную базу
`--export-polling <файл>`	-	Экспортировать код polling-клиента в BSL-файл
`--poll-server-url <URL>`	`http://localhost:9090`	URL Go-сервера для настроек polling-клиента
Лицензирование
`--activate <ключ>`	-	Активировать лицензию на данной машине
`--deactivate`	выключено	Деактивировать лицензию (освободить слот устройства)
`--license-status`	выключено	Показать статус лицензии (ключ, срок, издание)
Синтаксис
`--update-syntax`	выключено	Разобрать .hbk файлы платформы и сохранить данные синтаксиса в кэш JSON
`--debug`	выключено	Подробное логирование в файл (~/.cache/mcp-1c-advanced/server.log)
Информация
`--version`	выключено	Вывести версию бинарника и атрибуцию (BSL-LS) и выйти

Флаги Профессиональной версии mcp-1c-pro

Включает все флаги Расширенной версии, плюс следующие:

Флаг	По умолчанию	Описание
Семантический поиск
`--enable-semantic`	выключено	Включить векторный поиск (строит индекс, требует больше RAM)
Граф зависимостей
`--enable-depgraph`	выключено	Включить анализ графа зависимостей
`--build-depgraph`	выключено	Построить кэш графа зависимостей и выйти
Массовый анализ
`--enable-bulkanalysis`	выключено	Включить массовый анализ кода
`--build-bulkanalysis`	выключено	Построить кэш массового анализа и выйти
`--bulkanalysis-workers <N>`	`0`	Размер пула воркеров для массового анализа. `0` включает авто-подбор по размеру дампа (рекомендуется); значение больше нуля задаёт число явно (зажимается до количества ядер CPU). Доступно с v2.14.2
`--vendor-baseline <путь>`	-	Путь к чистому дампу вендора для фильтрации только доработанных модулей
CI/CD интеграция
`--ci`	выключено	CI режим: JSON вывод в stdout, код возврата по quality gates
`--json`	выключено	Вывести полные результаты анализа как JSON
`--fail-on-errors <N>`	`-1`	Код возврата 1 если количество ошибок превышает порог
`--fail-on-debt-score <N>`	`-1`	Код возврата 1 если техдолг модуля превышает порог
Обновление типовых конфигураций
`--update-helper`	выключено	Запустить сравнение конфигураций и выйти. Two-way если --vendor-old не указан, three-way иначе. При ответе свыше 1 MiB (env `MCP_UPDATE_HELPER_BUDGET_BYTES`) сервер сохраняет артефакт в локальный кэш и возвращает manifest `{path, size_bytes, sha256, mime_type}`, а AI-клиент читает файл напрямую
`--vendor-old <путь>`	-	Путь к дампу старой типовой (не указывать для two-way diff)
`--vendor-new <путь>`	-	Путь к дампу новой типовой (или конфигурация B для two-way)
`--output <путь>`	stdout	Путь к файлу результатов
`--format <формат>`	markdown	Формат отчета: markdown, text, json, html, pdf
`--report <путь>`	-	Путь к файлу отчета (для --build-bulkanalysis)
Архитектурная визуализация
`--build-archviz`	выключено	Запустить генерацию Mermaid-диаграмм и выйти
`--arch-viz <режим>`	`subsystems`	Режим: `subsystems`, `doc-reg`, `bp` или `all`
`--output-format <формат>`	`mermaid`	Формат вывода: `mermaid`, `svg` или `json`
`--output-dir <путь>`	-	Каталог для записи файлов (обязателен при `--arch-viz all`)
`--filter-subsystem <имя>`	-	Ограничить рамки одной подсистемой (рекурсивно)
`--filter-category <тип>`	-	Ограничить тип объектов (Документ, РегистрНакопления и т. п.)
`--max-nodes <N>`	`100`	Максимум узлов на одной диаграмме
`--show-handlers`	`true`	Показывать BSL-обработчики на диаграммах бизнес-процессов
Автогенерация документации
`--build-autodoc`	выключено	Запустить генерацию Markdown-документации и выйти
`--autodoc-out <путь>`	`docs/auto`	Каталог для autodoc Markdown-файлов
`--autodoc-provider <имя>`	-	LLM-провайдер: `yandexgpt` или `gigachat`
`--autodoc-model <имя>`	-	Модель провайдера (например, `yandexgpt-lite`)
`--autodoc-kinds <список>`	`all`	Виды объектов через запятую: `all` или подмножество `Document,Catalog,Report,DataProcessor`
`--autodoc-regen`	выключено	Игнорировать кэш и перегенерировать все объекты
`--autodoc-concurrency <N>`	`4`	Размер пула воркеров для autodoc
`--autodoc-max-input-tokens <N>`	`6000`	Лимит входных токенов на объект (модуль усекается)
`--autodoc-rps <N>`	`5.0`	Лимит запросов в секунду к LLM-провайдеру
Генерация тестов
`--build-testgen`	выключено	Запустить разовую генерацию тестов и выйти
`--enable-testgen`	выключено	Включить testgen в режиме MCP-сервера
`--testgen-output <путь>`	`<dump>/.testgen-output`	Каталог для записи тестовых файлов
`--testgen-framework <имя>`	`auto`	Фреймворк: `yaxunit`, `vanessa`, `both` или `auto`
`--testgen-rules <список>`	-	Подмножество правил TG001..TG020 через запятую
`--testgen-regen`	выключено	Игнорировать кэш и перегенерировать все тесты
`--testgen-taint-regressions`	выключено	Эмитировать Vanessa-регрессии по taint-находкам (правило TG020)
`--testgen-include-bsp`	выключено	Генерировать тесты для модулей БСП/SSL
`--testgen-concurrency <N>`	`min(CPU, 8)`	Число параллельных воркеров
`--testgen-llm-disable`	выключено	Отключить обогащение через LLM (работает без API-ключей)
`--testgen-emit-sarif <путь>`	-	Путь для SARIF 2.1.0 отчёта по testgen
`--testgen-audit-trail <путь>`	`<dump>/.testgen-audit.log`	Путь к audit log testgen
`--testgen-vendor-baseline <путь>`	-	Путь к vendor-baseline дампу для фильтрации стандартных модулей
Генерация .epf обработок
`--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`
`--epfgen-emit-tests`	выключено	Эмитировать sibling YAxUnit-тесты через testgen API
`--epfgen-suggest-attrs`	выключено	LLM-подсказки имён реквизитов (требует config-aware + LLM)
`--epfgen-concurrency <N>`	`min(CPU, 8)`	Число параллельных воркеров
`--epfgen-llm-disable`	выключено	Отключить обогащение через LLM (работает без API-ключей)
`--epfgen-emit-sarif <путь>`	-	Путь для SARIF 2.1.0 отчёта
`--epfgen-audit-trail <путь>`	-	Путь к epfgen audit log
`--epfgen-platform-version <версия>`	`8.3.10`	Целевая версия 1С (контролирует версию формата MDClasses XML)
Навигация по типовым конфигурациям
`--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 <N>`	`min(CPU, 8)`	Размер пула воркеров (значение `0` означает auto)
`--typicalconfigs-emit-sarif <путь>`	-	Путь для SARIF 2.1.0 отчёта
`--typicalconfigs-audit-trail <путь>`	-	Путь к audit log по операциям typicalconfigs
`--typicalconfigs-max-subsystems <N>`	`500`	Cap для очень больших дампов; подсистемы свыше cap получают статус `truncated`
`--typicalconfigs-platform-version <версия>`	`8.3.10`	Целевая версия 1С
`--debug`	выключено	Подробное логирование в файл (~/.cache/mcp-1c-pro/server.log)
CFEDiff: diff расширений (подкоманда `review`)
`review <base.cfe> <head.cfe>`	-	Подкоманда: сравнить два `.cfe`. Exit code: `0` no diff, `1` diff found, `2` error
`--format <формат>`	`markdown`	Формат вывода: `markdown`, `json` или `text`
`-o, --output <файл>`	stdout	Путь к файлу с отчётом
`--ignore-*`	-	11 фильтров технического шума: trailing whitespace, line endings, BOM, UUID-порядок и т. д. (полный список через `review --help`)
`--no-watermark`	выключено	Убрать watermark Trial (только для verified-paid лицензий)
`--diagnostic`	выключено	Добавить диагностический zip-пакет (для тикетов поддержки)
`--bug-report`	выключено	PII-safe `tar.gz` для GitHub-issue submission
`--enable-ibcmd`	выключено	Опциональная best-effort валидация через ibcmd (8.3.27+). Сейчас всегда даёт информационное предупреждение, не блокирует diff (см. раздел CFEDiff)
Лимиты ответов (env)
`MCP_ARCHVIZ_BUDGET_BYTES`	`1048576 (1 MiB)`	Бюджет ответа archviz в байтах; при превышении включается manifest fallback
`MCP_AUTODOC_BUDGET_BYTES`	`1048576 (1 MiB)`	Бюджет ответа autodoc в байтах
`MCP_UPDATE_HELPER_BUDGET_BYTES`	`1048576 (1 MiB)`	Бюджет ответа update_helper в байтах
`MCP_AUTODOC_RATE_LIMIT`	`10/60s`	Лимит вызовов autodoc формата `<count>/<seconds>s` (защита от исчерпания LLM-кредитов)

Примеры команд

# Минимальный запуск (все по умолчанию)
mcp-1c

# С аутентификацией и выгрузкой
mcp-1c --base http://server:8080/erp/hs/mcp-1c \
  --user Admin --password secret \
  --dump /dumps/erp

# Установка в клиент-серверную базу с нестандартной платформой
mcp-1c --install "srv-1c\buh_prod" --server \
  --platform "C:\Program Files\1cv8\8.3.25.1000\bin\1cv8.exe" \
  --db-user Admin --db-password pass

# Advanced: мультибазовость с polling
mcp-1c-advanced \
  --base dev=http://localhost:8080/hs/mcp-1c \
  --base staging=poll:// \
  --auth dev=Admin:dev123 \
  --dump dev=/dumps/dev \
  --listen :9090 \
  --poll-user agent --poll-password secret \
  --default-base dev

# Advanced: обновить данные синтакс-помощника
mcp-1c-advanced --update-syntax

# Advanced: управление лицензией
mcp-1c-advanced --activate "MCP-XXXX-XXXX-XXXX-XXXX"    # или mcp-1c-pro
mcp-1c-advanced --license-status                     # или mcp-1c-pro
mcp-1c-advanced --deactivate                         # или mcp-1c-pro

Профессиональная: построение кэша

# Построить граф зависимостей
mcp-1c-pro --dump /path/to/dump --build-depgraph

# Построить полный анализ (антипаттерны + безопасность + метрики)
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis

# Анализ только доработанных модулей (без типовых)
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis --vendor-baseline /path/to/vendor

# CI/CD: quality gates
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis --ci --fail-on-errors 10 --fail-on-debt-score 70

# HTML отчет
mcp-1c-pro --dump /path/to/dump --build-bulkanalysis --report report.html --format html

# Сравнение конфигураций (3-way diff)
mcp-1c-pro --update-helper --dump /path/to/custom --vendor-old /path/to/old-vendor --vendor-new /path/to/new-vendor

# Запуск MCP сервера с семантическим поиском и графом
mcp-1c-pro --dump /path/to/dump --enable-semantic --enable-depgraph

Профессиональная: визуализация, документация, тесты

# Архитектурные диаграммы (subsystems / doc-reg / bp / all)
mcp-1c-pro --dump /path/to/dump --build-archviz --arch-viz all --output-dir ./diagrams

# Markdown-документация по объектам через YandexGPT
mcp-1c-pro --dump /path/to/dump --build-autodoc \
  --autodoc-out ./docs/auto --autodoc-provider yandexgpt

# Генерация unit-тестов (YAxUnit + Vanessa)
mcp-1c-pro --dump /path/to/dump --build-testgen \
  --testgen-framework auto --testgen-output ./tests \
  --testgen-taint-regressions

# Designer-compatible .epf бандлы с упаковкой
mcp-1c-pro --build-epfgen --epfgen-spec ./bundles.yaml --epfgen-pack

# Индексация типовой конфигурации (БП, ЗУП, УТ, Розница, КА, ERP)
mcp-1c-pro --build-typicalconfigs \
  --typicalconfigs-dump-path ./dump \
  --typicalconfigs-output ./typicalconfigs-output \
  --typicalconfigs-llm-disable

# MCP-сервер с включёнными новыми инструментами
mcp-1c-pro --dump /path/to/dump \
  --enable-testgen --enable-epfgen --enable-typicalconfigs

Профессиональная: CFEDiff

# Сравнить две версии расширения, вывод в файл
mcp-1c-pro review base.cfe head.cfe --format markdown -o diff.md
echo "exit code: $?"  # 0 = no diff, 1 = diff found, 2 = error

# JSON-вывод для парсинга в CI
mcp-1c-pro review base.cfe head.cfe --format json -o diff.json

# Без watermark Trial (для verified-paid лицензий)
mcp-1c-pro review base.cfe head.cfe --no-watermark -o diff.md

# Диагностический пакет для тикета поддержки
mcp-1c-pro review base.cfe head.cfe --diagnostic -o diff.md

Назад Инструменты Профессиональной версии Далее Платформы, лицензирование и FAQ