1С + Cursor + MCP: полный цикл разработки без ручной работы в Конфигураторе

1С + Cursor + MCP: полный цикл разработки без ручной работы в Конфигураторе

Многие разработчики уже используют Cursor для работы с 1С, но сам процесс при этом часто остаётся наполовину ручным:

1. открыть Конфигуратор;

2. выгрузить конфигурацию в XML;

3. открыть проект в Cursor;

4. внести изменения;

5. снова открыть Конфигуратор;

6. загрузить конфигурацию из файлов;

7. обновить конфигурацию базы данных;

8. запустить 1С и проверить результат.

При этом большую часть этого цикла можно передать самому Cursor.

Ниже покажу, как связать Cursor с 1С через MCP так, чтобы агент мог самостоятельно получить актуальную конфигурацию из информационной базы, изменить BSL-код, загрузить конфигурацию обратно, обновить базу и запустить 1С:Предприятие.

Для примера используется обычная тестовая файловая база 1С.

Что будем использовать

Нам понадобятся:

• Cursor;

• платформа 1С;

• 1C: Platform Tools;

• 1C: Platform Tools MCP;

• Language 1C (BSL);

• OneScript;

• OPM;

• vanessa-runner.

Дополнительно можно установить:

• Metadata Viewer 1C;

• GitLens;

• Error Lens;

• PowerShell.

Ключевые компоненты здесь — 1C: Platform Tools и 1C: Platform Tools MCP.

Первый предоставляет инструменты для работы с проектом и информационной базой 1С, второй делает эти операции доступными AI-агенту Cursor.

1. Создаём проект

Создадим пустую папку, например:

D:\1С\Cursor\BSP

Открываем её в Cursor:

File U94; Open Folder

Далее вызываем палитру команд:

Ctrl + Shift + P

и выполняем инициализацию проекта через 1C: Platform Tools.

В корне должен появиться файл:

packagedef

Он нужен расширению для понимания, что текущая папка является проектом 1С.

2. Устанавливаем OneScript

Через раздел зависимостей 1C: Platform Tools устанавливаем OneScript.

После установки закрываем терминал Cursor и открываем новый.

Проверяем:

oscript -version

Затем:

opm --version

Если обе команды работают, можно переходить дальше.

3. Устанавливаем vanessa-runner

Для стабильной работы можно использовать ветку 2.x:

opm install vanessa-runner@2.6.1

Проверяем:

vrunner help

Если появляется предупреждение об отсутствии Vanessa-ADD, для нашей задачи его можно проигнорировать. Он нужен прежде всего для тестирования.

4. Создаём профиль подключения к базе

Вызываем:

Ctrl + Shift + P

и выбираем:

1C: Служебные файлы: Создать env.json

В корне проекта появится:

env.json

Для файловой базы строка подключения выглядит так:

{
  "default": {
    "--ibconnection": "/F\"D:\\1С\\Базы\\BSP\"",
    "--db-user": "",
    "--db-pwd": ""
  }
}

Для серверной базы:

{
  "default": {
    "--ibconnection": "/S\"srv-1c\\BSP_TEST\"",
    "--db-user": "Администратор",
    "--db-pwd": ""
  }
}

Важно: здесь используются учётные данные пользователя 1С, а не SQL Server.

Также стоит внимательно проверять пути, особенно если используются кириллические символы. Например:

1C

и

1С

выглядят практически одинаково, но в первом случае c латинская, а во втором c кириллическая.

5. Подключаем MCP

Теперь вызываем:

Ctrl + Shift + P

и выполняем:

1C: Platform Tools MCP: Настроить MCP для Cursor

После этого в проекте должен появиться:

.cursor\mcp.json

Перезагружаем окно Cursor:

Ctrl + Shift + P
Developer: Reload Window

Затем открываем:

Customize U94; MCPs

и убеждаемся, что:

mcp-1c-platform-tools

включён.

6. Проверяем связь с 1С

Теперь можно открыть Agent в Cursor и написать:

Используй mcp-1c-platform-tools.

Ничего не изменяй.

Покажи:
- текущий projectPath;
- активный профиль;
- строку подключения к информационной базе;
- каталог исходников конфигурации.

Если всё настроено правильно, агент должен увидеть текущий проект и информационную базу.

Например:

projectPath:
D:\1С\Cursor\BSP

ИБ:
/F"D:\1С\Базы\BSP"

Исходники:
D:\1С\Cursor\BSP\src\cf

На этом настройка завершена.

7. Теперь Cursor может сам пройти полный цикл

Для демонстрации возьмём простую задачу.

Пусть после запуска 1С:Предприятия появляется сообщение:

Эта конфигурация была изменена с помощью Cursor

Промпт:

Используй mcp-1c-platform-tools для текущего проекта 1С.

Сделай так, чтобы при запуске текущей тестовой базы в режиме 1С:Предприятие пользователю выводилось сообщение:

"Эта конфигурация была изменена с помощью Cursor"

Сам получи актуальную конфигурацию из текущей ИБ, найди подходящее место для этой доработки и внеси минимальное изменение.

Проверь только изменённый код. Полную синтаксическую проверку, полную проверку конфигурации и тестирование всей конфигурации не запускай.

После изменения загрузи конфигурацию обратно в текущую тестовую ИБ штатными средствами Platform Tools, дождись полного завершения загрузки и обновления конфигурации БД, затем запусти эту базу в режиме 1С:Предприятие.

Не запускай повторно уже выполняющуюся загрузку или обновление. Если возникнет ошибка — остановись и покажи её.

После этого агент самостоятельно:

1. получает актуальную конфигурацию из информационной базы;

2. находит нужный модуль;

3. изменяет BSL-код;

4. загружает конфигурацию обратно;

5. обновляет конфигурацию базы данных;

6. запускает 1С:Предприятие.

То есть Конфигуратор вручную открывать уже не требуется.

Что происходит под капотом

Схема выглядит примерно так:

Cursor Agent -> MCP -> 1C Platform Tools -> vanessa-runner -> 1С

Cursor не получает прямой произвольный доступ к базе.

Он вызывает подготовленные MCP-инструменты, а те уже используют штатные механизмы 1С и vanessa-runner.

Именно поэтому MCP здесь гораздо удобнее, чем заставлять модель самостоятельно собирать длинные команды PowerShell или 1cv8.exe.

Несколько проектов одновременно

Есть один важный нюанс.

1C: Platform Tools использует IPC-порт. По умолчанию:

40241

Если одновременно открыть несколько проектов 1С в разных окнах Cursor, каждому стоит назначить свой порт.

Например:

BSP   -> 40241
ZUP   -> 40242
ERP   -> 40243

В проекте создаём:

.vscode\settings.json

Например:

{
  "1c-platform-tools.ipc.enabled": true,
  "1c-platform-tools.ipc.port": 40242
}

И тот же порт должен быть указан в:

.cursor\mcp.json

через:

"ONEC_IPC_PORT": "40242"

Если порты не совпадают, MCP может подключиться к другому открытому проекту.

Почему не стоит запускать полную проверку большой конфигурации

На больших конфигурациях полная синтаксическая проверка может занимать десятки минут.

Для небольшого изменения одного BSL-модуля это часто избыточно.

Поэтому в промпте я явно указываю:

Проверь только изменённый код.
Полную проверку конфигурации не запускай.

То же относится к тестам всей конфигурации.

Для CI/CD, конечно, лучше выполнять полноценные проверки отдельно.

Не запускайте повторную загрузку

Ещё один нюанс, который обнаружился на практике.

Если загрузка конфигурации занимает долгое время, агент может решить, что операция зависла, и попытаться запустить её ещё раз.

Для одной и той же информационной базы это приведёт к ошибке блокировки:

Ошибка блокировки информационной базы для конфигурирования.
Возможно, информационная база уже открыта Конфигуратором.

Поэтому полезно прямо писать:

Не запускай повторно уже выполняющуюся загрузку или обновление.

А если нужен готовый CF?

Можно попросить Cursor дополнительно собрать .cf.

Например:

После завершения изменений собери итоговый .cf и сообщи полный путь к файлу.

Но на больших конфигурациях сборка .cf может занимать достаточно много времени, потому что формируется файл всей конфигурации, а не только изменённого объекта.

Можно ли подключить Cursor ещё и к данным?

Да.

1C: Platform Tools MCP в первую очередь решает задачу работы с конфигурацией и окружением.

Для анализа прикладных данных можно подключить дополнительный MCP, который предоставляет AI read-only доступ к языку запросов 1С.

Тогда можно писать, например:

Покажи список поставщиков из текущей базы.

или:

Найди документы этого контрагента за последний месяц.

или даже:

Найди причину расхождения суммы документа и движений по регистру.

Это уже отдельная интересная тема.

Что в итоге

После однократной настройки процесс разработки может выглядеть так:

описали задачу обычным текстом -> 
Cursor получил конфигурацию из ИБ -> 
нашёл нужный код -> 
внёс изменение -> 
загрузил обратно -> 
обновил базу -> 
запустил 1С

Самая важная мысль здесь не в том, что AI умеет написать несколько строк BSL.

Это он умел и раньше.

Главное изменение — AI получает возможность работать с самим циклом разработки 1С через контролируемые инструменты.

При этом я бы использовал такую схему только на dev/test-базах. Давать AI-агенту автоматическое обновление рабочей продуктивной базы — плохая идея.

Но для локальной разработки и тестовых контуров связка Cursor + MCP + Platform Tools уже позволяет убрать достаточно большой объём рутинных действий.