Современный 1С-разработчик все чаще сталкивается с задачей, которую нельзя решить одним макросом или типовым расширением. Нужно быстро разобраться в чужом коде, написать обработку под нестандартный запрос бизнеса или просто сэкономить время на рутинных операциях. И здесь на помощь приходят ИИ-инструменты. Но просто открыть ChatGPT и скопировать туда кусок кода - это прошлый век. Настоящий прорыв дает связка редактора Cursor и протокола MCP (Model Context Protocol) через утилиту 1С: Platform Tools. За 15 минут вы получаете среду, где ИИ-агент понимает структуру вашего проекта 1С, видит все модули, формы и запросы, а главное - может выполнять действия прямо в вашей конфигурации. Без копипаста, без потери контекста, без лишних движений.

В этой статье я расскажу, как настроить такую связку, какой нюанс с файлом packagedef критически важен для работы, и почему именно этот подход меняет правила игры для тех, кто пишет на 1С каждый день.

Что такое MCP и зачем он 1С-разработчику

MCP (Model Context Protocol) - это открытый протокол, который позволяет ИИ-ассистентам взаимодействовать с внешними инструментами и данными. Если говорить просто: вместо того чтобы вручную выдергивать куски кода из конфигурации и кидать их в чат с нейросетью, MCP дает ассистенту прямой доступ к вашему проекту. Он видит файлы, понимает их структуру, может читать метаданные и даже выполнять команды - например, запустить проверку синтаксиса или собрать расширение.

Для 1С-разработчика это означает следующее: вы работаете в Cursor (форк VS Code, заточенный под ИИ), подключаете MCP-сервер из состава 1С: Platform Tools, и ваш ассистент перестает быть просто «болталкой». Он становится полноценным участником процесса разработки. Вы пишете запрос на естественном языке - ассистент находит нужный модуль, анализирует его, предлагает изменения и даже может применить их через MCP-команды.

Ключевое преимущество - контекст. Когда вы спрашиваете «найди ошибку в расчете себестоимости», ассистент не гадает, что вы имели в виду. Он видит весь проект: структуру метаданных, зависимости между объектами, типовые запросы. Это радикально повышает качество ответов и сокращает время на уточняющие вопросы.

1С: Platform Tools - что входит и как установить

1С: Platform Tools - это набор утилит от фирмы «1С», который включает в себя средства для работы с конфигурациями через командную строку, анализа кода, сборки расширений и, что самое важное для нас, MCP-сервер. Этот набор распространяется через официальный сайт 1С и доступен для скачивания всем зарегистрированным пользователям платформы.

В состав входят:

Установка предельно проста. Скачайте дистрибутив с сайта 1С, запустите установщик и следуйте инструкциям. После установки в системной переменной PATH появляется путь к исполняемым файлам. Проверить можно через командную строку: выполните команду, которая вызывает справку по MCP-серверу (обычно это что-то вроде 1c-mcp --help). Если вы видите список доступных параметров - установка прошла успешно.

Настройка ИИ-агента в Cursor через MCP

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

Процесс настройки состоит из нескольких шагов.

Шаг 1. Подготовка проекта

Откройте в Cursor папку, которая содержит вашу конфигурацию 1С. Это может быть каталог с выгруженными файлами конфигурации (например, из EDT или через выгрузку из конфигуратора). Важно, чтобы в корне этой папки находился файл packagedef. О нем мы поговорим отдельно - это критический маркер, без которого MCP-сервер не поймет, что перед ним проект 1С.

Шаг 2. Запуск MCP-сервера

MCP-сервер запускается отдельно. В терминале Cursor выполните команду, которая запускает сервер с указанием пути к вашему проекту. Обычно это выглядит так:

1

1c-mcp start --project /путь/к/вашей/папке

После запуска сервер начинает слушать порт (по умолчанию 8080 или другой, указанный в настройках). В терминале появится сообщение о том, что сервер готов к работе. Не закрывайте это окно - пока сервер работает, Cursor может с ним общаться.

Шаг 3. Подключение к Cursor

В Cursor откройте настройки MCP. Обычно они находятся в разделе «AI» или «MCP Configuration». Там нужно указать адрес запущенного сервера - например, http://localhost:8080. Сохраните настройки и перезапустите Cursor (или перезагрузите окно редактора).

Шаг 4. Проверка связи

Откройте чат с ИИ-ассистентом (Ctrl+L или Cmd+L) и задайте простой вопрос: «Какие объекты есть в корне конфигурации?» Если все настроено правильно, ассистент ответит списком справочников, документов и других метаданных, которые он получил через MCP-сервер. Если ответа нет или ассистент говорит, что не видит проект, - проверьте, запущен ли сервер и правильно ли указан адрес.

После успешной проверки можно переходить к реальной работе. Теперь ассистент видит весь ваш код, может анализировать его, предлагать изменения и даже выполнять команды - например, запустить синтаксический контроль или собрать расширение.

Файл packagedef - главный маркер проекта 1С

Этот момент я хочу выделить отдельно, потому что без него вся настройка теряет смысл. Файл packagedef - это текстовый файл в формате JSON, который описывает структуру проекта 1С. Он содержит информацию о версии платформы, списке расширений, зависимостях и других параметрах. Для MCP-сервера этот файл является единственным способом понять, что папка, которую вы открыли, - это полноценный проект 1С, а не просто набор случайных файлов.

Если в корне вашего проекта нет packagedef, MCP-сервер выдаст ошибку или будет работать некорректно - например, не сможет определить, какие файлы относятся к метаданным, а какие нет. В результате ассистент будет видеть только текстовые файлы (например, .bsl), но не сможет связать их с конкретными объектами конфигурации.

Как создать packagedef, если его нет

Если вы работаете с проектом, который не был создан через EDT или не содержит packagedef, его нужно создать вручную. Это простой текстовый файл. Минимальное содержимое выглядит так:

1
2
3
4
5
6
7

{
  "version": "1.0",
  "platformVersion": "8.3.20",
  "name": "МояКонфигурация",
  "description": "Описание проекта",
  "extensions": []
}

Параметр platformVersion должен соответствовать версии платформы, на которой вы работаете. Параметр name может быть любым, но лучше использовать латиницу или транслит - это снижает риск проблем с кодировками. Параметр extensions - это список расширений, которые входят в проект. Если расширений нет, оставьте пустой массив.

После создания файла поместите его в корневую папку проекта и перезапустите MCP-сервер. Теперь сервер увидит проект и сможет корректно обрабатывать запросы.

Почему это важно для ИИ-агента

Без packagedef ассистент в Cursor будет слеп. Он сможет читать отдельные файлы, но не поймет, как они связаны между собой. Например, вы спрашиваете: «Найди все реквизиты справочника "Номенклатура"». Ассистент без packagedef может найти файл Справочник.Номенклатура.bsl, но не сможет определить, какие реквизиты объявлены в метаданных, потому что эта информация хранится не в коде, а в файлах .1c (бинарных или текстовых описаниях метаданных). MCP-сервер через packagedef знает, где искать эти файлы, и передает ассистенту полную структуру объекта.

Именно поэтому я настоятельно рекомендую всегда иметь packagedef в корне проекта, даже если вы не планируете использовать MCP. Этот файл - стандартный способ описания проекта 1С, и многие инструменты (EDT, сборщики, анализаторы) ориентируются на него.

Проверка работоспособности и первые результаты

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

Тест 1. Запрос на анализ модуля

Напишите в чат: «Покажи структуру модуля формы документа "ПоступлениеТоваров"». Ассистент должен выдать список процедур и функций, которые есть в этом модуле, с указанием строк. Если вместо этого он говорит, что не может найти такой объект, - проверьте, правильно ли указан путь к проекту и запущен ли MCP-сервер.

Тест 2. Запрос на поиск ошибки

Скопируйте в чат фрагмент кода с заведомой ошибкой (например, вызов несуществующей процедуры) и попросите найти проблему. Ассистент, имеющий доступ к полному проекту, сможет не только указать на ошибку, но и предложить исправление, основываясь на других модулях, где эта процедура определена.

Тест 3. Выполнение команды через MCP

Попросите ассистента выполнить синтаксический контроль всего проекта. Если MCP-сервер поддерживает такую команду, ассистент запустит проверку и вернет результат. Это уже не просто совет - это реальное действие в вашей среде разработки.

Тест 4. Генерация нового объекта

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

Типичные ошибки и их решение

Даже при четком следовании инструкции могут возникнуть проблемы. Вот самые частые из них.

Ошибка: MCP-сервер не запускается

Причины: отсутствует платформа 1С нужной версии, не установлен 1С: Platform Tools, или путь к проекту указан неверно. Проверьте, что платформа установлена и версия не ниже 8.3.20. Также убедитесь, что в папке проекта есть файл packagedef - без него сервер может отказаться запускаться.

Ошибка: Ассистент в Cursor не видит проект

Причины: неправильно указан адрес MCP-сервера в настройках Cursor, или сервер запущен на другом порту. Проверьте, какой порт слушает сервер (обычно это видно в терминале при запуске). В настройках Cursor укажите точный адрес, например http://localhost:8080. Если сервер запущен на том же компьютере, localhost - правильный адрес.

Ошибка: Ассистент видит только файлы, но не метаданные

Причины: отсутствует packagedef или он заполнен некорректно. Проверьте, что файл находится в корне проекта и содержит правильную версию платформы. Если вы используете расширения, они должны быть перечислены в параметре extensions.

Ошибка: Ассистент не может выполнить команду

Причины: MCP-сервер может не поддерживать все команды, которые вы запрашиваете. Например, не все версии 1С: Platform Tools умеют создавать новые объекты. Проверьте документацию к вашей версии утилиты. Если команда не поддерживается, ассистент сообщит об этом.

Итоги и дальнейшие шаги

Связка Cursor и MCP через 1С: Platform Tools - это не просто игрушка, а реальный инструмент, который ускоряет разработку в разы. За 15 минут вы получаете среду, где ИИ-ассистент понимает ваш проект на уровне метаданных, может анализировать код, искать ошибки и даже выполнять действия. Ключевой момент - не забыть про файл packagedef. Без него вся магия не работает.

Что дальше? Попробуйте использовать эту связку в реальных задачах. Начните с малого: пусть ассистент поможет вам отрефакторить старый модуль или найти дублирующийся код. Постепенно вы привыкнете к тому, что сложные запросы обрабатываются за секунды, а не за часы. И когда в следующий раз коллега спросит, как вы успеваете делать так много, просто скажите: «У меня есть ассистент, который видит весь проект».

Теперь ваша очередь. Откройте Cursor, установите 1С: Platform Tools, создайте packagedef, запустите MCP-сервер и начните работать по-новому. 15 минут - и ваше рабочее место станет идеальным.