1c-platform-tools-mcp

name	1c-platform-tools-mcp
description	Инструменты MCP для команд 1C: Platform Tools (1C: Platform Tools MCP). Используй, когда нужно выполнить загрузку/выгрузку конфигурации, расширений, сборку EPF/ERF, запуск Конфигуратора/Предприятия, установку зависимостей — через MCP вместо палитры команд.

MCP: инструменты 1c-platform-tools

Если пользователь называет инструмент по имени (например «через run_designer», «вызови run_designer») — сразу вызови этот MCP-инструмент с projectPath корня workspace. Не заходи сначала в скилл и не обходи все JSON в папке MCP: открой дескриптор нужного инструмента и выполни вызов. Таблицы ниже — когда задача сформулирована без имени инструмента.

Если у тебя подключён сервер mcp-1c-platform-tools, используй его инструменты для операций с платформой 1С. Результат выполнения команды расширения придёт в ответе инструмента.

Параметр projectPath

Корень проекта 1С (каталог с packagedef и env.json). Если пользователь указал путь — используй его; если в VS Code открыт один проект, параметр можно не передавать: расширение возьмёт открытую папку.

Параметр wait

• wait: true (по умолчанию) — синхронное выполнение; в ответе { success, exitCode, stdout, stderr, tests?, artifact? }. Прогоны тестов возвращают счётчики по отчёту.
• wait: false — команда уходит в терминал VS Code, ответ без stdout/exitCode. Нужен, когда пользователь смотрит ход выполнения сам.

Возвращают результат синхронно: конфигурация (loadIncFromSrc — с параметром sha; кроме loadFromFiles), расширения (кроме loadFromFiles), ИБ (кроме loadFromDt), внешние EPF/ERF, тесты (кроме allure), epf_run, test_configure (с параметром frameworks), сборка и разбор.

Исход не возвращают (ответ подтверждает только запуск): run_*, server_*, debug_*, launch_*, deps_*, syntaxCheck_refresh, syntaxCheck_clear, oscript_run, components_update, loadFromDt, objlist, allure, clearCache. У таких инструментов это написано в описании.

Состояние окружения: env_status

Read-only инструмент env_status возвращает JSON: активный профиль, файл настроек и признак его существования, схему (v2/v3), версию vanessa-runner, временные параметры (пароль замаскирован) и итоговую строку подключения. Вызывай его перед операциями, когда важно, в каком окружении они выполнятся.

Явно переданные settingsFile/ibConnection имеют приоритет над временными параметрами профиля; применение или отбрасывание временных параметров отражается строками [контекст] ... в stdout результата.

Прочие параметры MCP

Параметры объявлены у тех инструментов, к которым применимы: sha есть только у инкрементальной загрузки, frameworks — только у настройки тестов. Если параметра нет в схеме инструмента, он этой команде не нужен.

• settingsFile — файл настроек vanessa-runner относительно projectPath; перекрывает активный профиль для конкретного вызова (например, tools/vrunner.init.json для init-сценариев).
• ibConnection — явная строка подключения к ИБ, перекрывает значение файла настроек.
• pathsOverride — переопределение каталогов src/cf, src/cfe, src/epf, src/erf, build/out.

Дополнительные параметры операций

Те же значения можно передать объектом первым аргументом команды расширения (Execute Command), если MCP недоступен:

• sha — инкрементальная загрузка cf_loadInc (пустая строка — полная загрузка);
• extensions — явный список расширений для cfe_*;
• profile — переключение профиля: env_selectProfile { profile: "test" };
• frameworks — настройка тестов: test_configure { frameworks: ["vanessa"] };
• execute, command — запуск EPF в Предприятии: epf_run { execute: "путь.epf", command: "строка /C" }.

Команды не открывают окон при агентном вызове: если данных не хватает, вернётся структурированная ошибка с подсказкой.

Неуспешный результат

Упавшие тесты, ошибки синтаксического контроля и ненулевой код возврата приходят с признаком ошибки: считать такой вызов выполненным нельзя. test_syntaxCheck возвращает список ошибок с путём к файлу модуля и текстом сообщения — правь по нему исходники, не разбирая stdout. Длинный вывод обрезается до хвоста, полный лог остаётся в панели расширения.

Как формируются имена инструментов

Имена генерируются из command ID расширения: убирается префикс 1c-platform-tools., точки заменяются на _, длинные слова сокращаются (dependencies → deps, Processors → Procs, loadIncrementFromSrc → loadIncFromSrc и др.). Полный список возвращается сервером при подключении.

Конфигурация

Задача	Инструмент MCP
Загрузить из исходников	cf_load
Обновить конфигурацию БД	infobase_updateDb
Загрузить изменения (git diff)	cf_loadInc
Загрузить из objlist.txt	cf_loadByList
Загрузить из 1Cv8.cf	cf_loadFile
Выгрузить в исходники	cf_dump
Выгрузить изменения	cf_dumpInc
Выгрузить в 1Cv8.cf	cf_unload
Собрать 1Cv8.cf	cf_compile
Разобрать 1Cv8.cf	cf_decompile

Расширения

Задача	Инструмент MCP
Загрузить из исходников	cfe_load
Загрузить из objlist.txt	cfe_loadByList
Загрузить из *.cfe	cfe_loadFile
Выгрузить в исходники	cfe_dump
Выгрузить в *.cfe	cfe_unload
Собрать *.cfe	cfe_compile
Разобрать *.cfe	cfe_decompile

Тестовые расширения (tests/cfe): test_loadExts, test_dumpExts, test_buildExts, test_decompileExts — параметр extensions работает так же.

Внешние обработки и отчёты

Задача	Инструмент MCP
Собрать обработки	epf_compileProc
Разобрать обработки	epf_decompileProc
Собрать отчёты	epf_compileReport
Разобрать отчёты	epf_decompileReport
Удалить кэш	epf_clearCache

Информационные базы, зависимости, запуск и др.

Остальные команды расширения также доступны как инструменты MCP (имена формируются по тому же принципу). Полный список инструментов возвращается сервером при подключении.

Примеры

• Вызови cf_load с projectPath = корень проекта 1С — загрузка конфигурации из исходников и обновление БД.
• Вызови cf_load, затем infobase_updateDb: загрузка не трогает конфигурацию БД, пока не передан updateDb: true.
• Вызови run_designer с projectPath — запуск Конфигуратора (если пользователь просит открыть конфигуратор).
• Вызови deps_install с projectPath — установка зависимостей packagedef/vrunner.

Правило

Для автоматизации (загрузка конфигурации, выгрузка, сборка обработок и т.д.) предпочитай инструменты MCP вместо Execute Command редактора — так агент получает структурированный ответ и не зависит от палитры. Всегда передавай projectPath.