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.
