Сервис доступа к данным 1С для внешних систем
Жёлтый мост
Практика · Программисту 1С

Cursor для 1С: подключить базу и проверять запросы на данных

ИИ Cursor для 1С пишет запросы и модули быстро, но без базы не видит ни реальных имен реквизитов, ни результата. Как настроить Cursor так, чтобы агент сам проверял запрос на копии базы, работал с несколькими базами и не спрашивал разрешения на каждый шаг.

Задача

ИИ Cursor для 1С берут ради скорости: открыл папку с выгруженной конфигурацией, описал доработку, агент пишет. Слабое место видно на первой же проверке. Запрос выглядит верно, но реквизит в вашей конфигурации называется иначе, а виртуальная таблица возвращает пусто, потому что агент не знает, как у вас заполнены данные.

Проверять приходится руками: скопировать текст в консоль запросов, запустить, вернуть ошибку в Cursor. Нужна настройка, при которой агент сам отправляет запрос в базу и видит ответ.

Как это решают обычно

Выгрузка конфигурации в папку проекта. Cursor индексирует файлы и находит процедуры по смыслу. Для понимания кода это очень удобно, но данных в выгрузке нет.

Правила проекта. В правилах Cursor описывают стандарты 1С, порядок имен, запрет запросов в цикле. Качество текста растет заметно, а проверить имя реквизита на живой базе правило не может.

Своя публикация базы для агента. HTTP-сервис или OData на копии базы дают полный контроль. Цена вопроса: веб-сервер, публикация, доступ снаружи и время администратора.

Как быстрее

Где что настраивается
Cursorагент, правила проекта, список MCP-серверов
MCP-сервер "baza-kopiya"адрес из кабинета для ключа копии
MCP-сервер "baza-rabochaya"адрес из кабинета для рабочей базы, только чтение
Обработка в 1Ссама ходит наружу по HTTPS, порты не открываются

Жёлтый мост подключается к Cursor как MCP-сервер. У агента появляются инструменты: query_1c для чтения языком запросов 1С, write_1c для изменения данных (если на ключе включена запись в ИИ-чатах) и, если к ключу приложена справка по структуре базы, search_sources и read_sources. Агент сначала смотрит имена в справке, затем выполняет запрос и получает строки или текст ошибки с местом. Подробно этот цикл описан в статье Разработка кода 1С с ИИ через Жёлтый мост.

Вопрос к агенту выглядит так: "Найди в справке, где хранятся продажи по менеджерам, напиши запрос за прошлый месяц, выполни его на baza-kopiya и покажи первые пять строк".

Что агент показывает в чате Cursor, данные условные
ШагРезультат
Справканашел регистр и имена ресурсов
Первый запускошибка: неверное имя поля в строке 4
Второй запуск5 строк, итог 2 310 400

Как это сделать

1. Создайте ключ на копию базы и запустите в ней обработку. Второй ключ, если нужен, создайте на рабочую базу в режиме "только чтение": его выбирают при создании ключа, по умолчанию стоит "чтение + запись".

2. Откройте настройки Cursor, раздел с MCP-серверами (в разных версиях он называется по-разному, например MCP или Tools & MCP), и добавьте новый сервер. Укажите адрес из кабинета; если Cursor откроет файл mcp.json, впишите адрес туда, как в пункте 3. Отдельная авторизация не нужна: ключ уже в адресе.

3. Либо положите в корень проекта файл .cursor/mcp.json. В нем раздел mcpServers, внутри по одному серверу на базу: имя, например baza-kopiya, и поле url с адресом из кабинета.

4. Дайте серверам понятные имена и напишите в правилах проекта, на какой базе проверять запросы и что запись на рабочей базе запрещена.

5. Если агент работает не через MCP, а по промту "Для IDE-агентов" командами curl, Cursor будет просить подтвердить каждую команду терминала. Нажимайте "Run" или добавьте curl в список разрешенных команд агента. С MCP этого вопроса нет.

Что знать заранее

Не уверены, как подключается именно ваша база - в 1С:Фреш, в аренде, своя серверная или файловая? Выберите свой случай на главной: покажем, что мешает и что меняет мост.

Проверьте на своей базе. Подключение занимает около пятнадцати минут: обработка из кабинета, ключ, готовый текст для ИИ. При регистрации даются три дня работы одной базы, карта не нужна.
Настроить у себя Другие задачи