---
name: 1c-platform-tools-mcp
description: Инструменты MCP для команд 1C: Platform tools. Используй, когда нужно выполнить загрузку/выгрузку конфигурации, расширений, сборку 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 (первая папка).

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

Имена генерируются из 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`.