Современный 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С», а independent community-проект (публикуется на GitHub под ником разработчика yellow-hammer) с открытым исходным кодом по лицензии MIT. Отдельной страницы «Platform Tools» на сайте 1c.ru и кнопки «Скачать» там нет - инструмент существует как обычное расширение для VS Code / Cursor.

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

Установка выполняется через маркетплейс редактора, а не через отдельный инсталлятор. В Cursor (или VS Code) откройте панель расширений и установите два расширения: базовое «1C: Platform Tools» и отдельное «1C: Platform Tools MCP», которое отвечает за интеграцию с ИИ-агентом. Оба доступны в Open VSX Registry (маркетплейс, с которым работает Cursor) и в VS Code Marketplace; если нужен офлайн-вариант, .vsix-файлы можно скачать со страницы релизов проекта на GitHub. Никакого отдельного дистрибутива с сайта 1С здесь не требуется.

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

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

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

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

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

Шаг 2. Установка расширений

MCP-сервер отдельно запускать не нужно - это не самостоятельный процесс с CLI-командой, а часть расширения «1C: Platform Tools MCP». В панели расширений Cursor найдите и установите два пакета: «1C: Platform Tools» (базовые инструменты) и «1C: Platform Tools MCP» (мост к ИИ-агенту). После установки и открытия папки проекта с файлом packagedef в корне сервер запускается автоматически и общается с редактором через локальный канал (stdio/IPC) - без отдельного сетевого порта, который нужно было бы указывать вручную.

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

Откройте палитру команд Cursor (Ctrl+Shift+P) и выполните команду расширения «1C: Platform Tools MCP: Настроить MCP для Cursor». Она автоматически создаст (или обновит) файл .cursor/mcp.json в корне проекта с параметрами запуска сервера. После этого откройте настройки MCP в Cursor, включите появившийся сервер и перезапустите окно редактора.

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

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

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

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

Этот момент я хочу выделить отдельно, потому что без него вся настройка теряет смысл. И здесь важно сразу развеять частое заблуждение: packagedef - это не JSON, а скрипт на языке OneScript (том самом BSL-подобном языке, на котором построена вся экосистема консольных утилит 1С). Формат пришел из менеджера пакетов OneScript (opm), а расширение «1C: Platform Tools» использует его как маркер корня проекта: файл описывает имя пакета, версию, требуемую версию среды выполнения и зависимости.

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

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

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

1
2
3
4

Описание
  .Имя("МояКонфигурация")
  .Версия("1.0.0")
  .ВерсияСреды("8.3.20")

Метод .ВерсияСреды(...) указывает минимальную версию среды выполнения (для проекта 1С - версию платформы), с которой должен быть совместим проект. Метод .Имя(...) задает имя пакета - лучше использовать латиницу или транслит, это снижает риск проблем с кодировками. Если у проекта есть зависимости (например, используемые OneScript-библиотеки), их перечисляют через .ЗависитОт(...); если зависимостей нет, эту часть можно опустить.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Причины: не установлены расширения «1C: Platform Tools» / «1C: Platform Tools MCP», на машине отсутствует подходящая версия платформы 1С, или в открытой папке нет файла packagedef. Проверьте оба расширения в списке установленных, версию платформы 1С:Предприятие 8.3 (сверьтесь с требованиями в документации проекта на GitHub) и наличие packagedef в корне проекта.

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

Причины: файл .cursor/mcp.json не создан или содержит устаревшие параметры, либо сервер не включен в настройках MCP. Пересоздайте конфигурацию командой «1C: Platform Tools MCP: Настроить MCP для Cursor» из палитры команд, убедитесь, что сервер включен в списке MCP-серверов Cursor, и перезапустите окно редактора.

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

Причины: отсутствует packagedef или в нем указана неверная версия среды выполнения. Проверьте, что файл находится в корне проекта и что версия в .ВерсияСреды(...) соответствует установленной платформе.

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

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

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

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

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

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