| 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.
