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). Если пользователь указал путь — используй его; иначе корень текущего workspace (первая папка).

Параметр wait

• wait: false (по умолчанию) — команда в терминале VS Code, ответ MCP без stdout/exitCode.
• wait: true — синхронное выполнение vrunner; в ответе { success, exitCode, stdout, stderr, artifact? }. Для цикла «собрать → проверить → исправить».

Поддерживают wait: true: конфигурация (кроме loadIncFromSrc, loadFromFiles), расширения (кроме loadFromFiles), ИБ (кроме loadFromDt), внешние EPF/ERF, тесты (кроме allure), сборка/разбор алиасов.

Не поддерживают wait: true (нужен UI): run_*, metadata_*, projects_*, support_*, dependencies_* (кроме чистого vrunner), loadFromDt, loadIncFromSrc, objlist, allure, clearCache.

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

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

Операции с дополнительными аргументами — через Execute Command

Схема MCP этих аргументов не содержит; передавай их первым аргументом команды расширения (Execute Command / runCommands):

• инкрементальная загрузка: 1c-platform-tools.configuration.loadIncrementFromSrc с { "sha": "<SHA>", "wait": true };
• явный список расширений: команды 1c-platform-tools.extensions.* с { "extensions": ["Имя1"] };
• настройка тестов: 1c-platform-tools.testing.configure с { "frameworks": ["vanessa"], "wait": true };
• запуск EPF в Предприятии: 1c-platform-tools.enterprise.run с { "execute": "путь.epf", "command": "строка /C", "wait": true };
• переключение профиля: 1c-platform-tools.env.selectProfile со строкой (id профиля).

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

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

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

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

Задача	Инструмент MCP
Загрузить из исходников	configuration_loadFromSrc
Загрузить изменения (git diff)	configuration_loadIncFromSrc
Загрузить из objlist.txt	configuration_loadFromFiles
Загрузить из 1Cv8.cf	configuration_loadFromCf
Выгрузить в исходники	configuration_dumpToSrc
Выгрузить изменения	configuration_dumpIncToSrc
Выгрузить в 1Cv8.cf	configuration_dumpToCf
Собрать 1Cv8.cf	configuration_build
Разобрать 1Cv8.cf	configuration_decompile

Расширения

Задача	Инструмент MCP
Загрузить из исходников	extensions_loadFromSrc
Загрузить из objlist.txt	extensions_loadFromFiles
Загрузить из *.cfe	extensions_loadFromCfe
Выгрузить в исходники	extensions_dumpToSrc
Выгрузить в *.cfe	extensions_dumpToCfe
Собрать *.cfe	extensions_build

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

Задача	Инструмент MCP
Собрать обработку	externalProcs_build
Разобрать обработку	externalProcs_decompile
Собрать отчёт	externalReports_build
Разобрать отчёт	externalReports_decompile
Удалить кэш	externalFiles_clearCache

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

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

Примеры

• Вызови configuration_loadFromSrc с projectPath = корень проекта 1С — загрузка конфигурации из исходников.
• Вызови run_designer с projectPath — запуск Конфигуратора (если пользователь просит открыть конфигуратор).
• Вызови deps_install с projectPath — установка зависимостей packagedef/vrunner.

Правило

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