version: "1.0.2" 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), externalProcs_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 — инкрементальная загрузка configuration_loadIncFromSrc (пустая строка — полная загрузка);
• extensions — явный список расширений для extensions_*;
• profile — переключение профиля: env_selectProfile { profile: "test" };
• frameworks — настройка тестов: test_configure { frameworks: ["vanessa"] };
• execute, command — запуск EPF в Предприятии: externalProcs_run { execute: "путь.epf", command: "строка /C" }.

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

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

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

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

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

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

Расширения

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

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

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

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

Примеры

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

Правило

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