Агент спрашивает.
База отвечает.
ones-mcp — служба Windows, которая подключает AI-ассистентов и MCP-клиентов (Claude, Cursor и другие) к информационным базам 1С:Предприятие 8.3.
Работает на любой базе без доработки конфигурации и без установки расширений. Запросы — только на чтение.
Схема работы
Агент задаёт вопрос — ones-mcp выполняет запрос в базе 1С:Предприятие 8.3 и возвращает результат агенту.
Как это выглядит
Достаточно одного подключения в Cherry Studio — и ваш агент анализирует данные из базы 1С:Предприятие 8.3.
http://127.0.0.1:3298/mcp — и пользователь 1С:Предприятие 8.3 в заголовке. Нажмите на изображение, чтобы открыть на весь экран.Три инструмента
Сервер публикует по протоколу MCP ровно три инструмента. run_query выполняет запрос на языке запросов 1С:Предприятие 8.3 (ВЫБРАТЬ) и возвращает строки результата в JSON — базу он не записывает и не изменяет.
- list_bases Информационные базы, найденные на компьютере: id, имя, строка соединения, версия платформы. 3 базы · .v8i
- list_platforms Установленные платформы 1С:Предприятие 8.3: имя, версия, путь к исполняемому файлу 1cv8.exe. 8.3.156.4677 · 64 бит
- run_query Выполняет запрос на языке запросов 1С:Предприятие 8.3 и возвращает строки результата. rows · rowCount · truncated · durationMs
Параметры run_query
| query | Текст запроса на языке запросов 1С:Предприятие 8.3 (обязателен). Пример: ВЫБРАТЬ | 10 КАК Кол_Позиций | ИЗ | Справочник.Номенклатура |
|---|---|
| base | id или имя базы из list_bases. Если ни база, ни строка соединения не заданы — сервер вернёт вопрос о выборе базы и список доступных баз; клиент уточнит у пользователя и повторит запрос. |
| limit | Сколько строк вернуть. По умолчанию — 1000; при обрезке в ответе будет truncated=true. |
Подключение — три шага
Вся настройка происходит вокруг строки соединения и учётной записи 1С:Предприятие 8.3 — в базе ничего не меняется. Если чего-то не хватает, сервер сам объяснит, что именно и где задать.
-
Установите службу
Запустите
setupOnesMCP.exeот имени администратора и задайте параметры на странице конфигурации. Инсталлятор создаст службу «MCP-сервер для 1С:Предприятие» с автозапуском и перезапуском при сбое. Права администратора нужны только на этом шаге. -
Добавьте сервер в MCP-клиент
Один блок конфигурации — и инструменты появятся у агента.
-
Скажите, от чьего имени работать
Задайте строку соединения, пользователя и пароль 1С:Предприятие 8.3 заголовками
X-Mcp1c-*. Платформу и таймаут можно не указывать: по умолчанию — самая свежая платформа и 300 секунд.
Что нужно для работы
- 1С:Предприятие 8.3 — платформа установлена на сервере, где запущена служба ones-mcp.
- Доступная информационная база — файл или серверная база, до которой есть строка соединения.
- Пользователь 1С:Предприятие 8.3 с правами чтения на нужные объекты и правом запускать внешнюю обработку.
Одно условие в клиенте 1С:Предприятие 8.3
У пользователя должно быть снято ограничение «Защита от опасных действий» — иначе внешняя обработка, через которую выполняется запрос, не запустится. Это настройка пользователя, а не базы.
При ошибочных учётных данных сервер не молчит: в ответе — подробная подсказка, где задать пользователя, что он должен существовать в ИБ и как проверить вход через обычный клиент 1С:Предприятие 8.3.
Частые вопросы
Почему «без доработки и без расширений»?
Типовые коннекторы к 1С:Предприятие 8.3 требуют поставить расширение или дополнение конфигурации, добавить реквизиты и регистры либо развернуть на базе сторонние компоненты. ones-mcp работает как любой клиент 1С:Предприятие 8.3: указывает базу по строке соединения, подставляет пользователя и выполняет запрос на языке запросов. Поэтому конфигурацию базы не трогают — ни в одном объекте, — и одинаково работает на ERP, Бухгалтерии, УТ, ЗУП, КА и любой другой базе 8.3.
Сервер может что-то изменить в моей базе?
Нет. run_query выполняет только запросы на чтение (ВЫБРАТЬ): сервер не записывает и не изменяет данные. Пользователь 1С:Предприятие 8.3 при этом должен иметь лишь права чтения на объекты, к которым обращается запрос.
Как выполняется запрос?
Встроенная в пакет внешняя обработка копируется во временный файл, текст запроса — в отдельный файл, и клиент 1С:Предприятие 8.3 запускается в режиме предприятия. Обработка выполняет запрос и возвращает результат локальному приёмнику службы. Всё происходит на машине, где установлена 1С:Предприятие 8.3; пароль 1С:Предприятие 8.3 в логи не записывается.
Какие агенты поддерживаются?
Любой MCP-клиент: Claude Desktop, Cursor, Cherry Studio, VS Code, Windsurf и собственные агенты. Подключение — по Streamable HTTP к службе. Привязки к одному вендору нет.
Ограничения
Только 1С:Предприятие 8.3. Запрос выполняется только на сервере или компьютере, где установлена 1С:Предприятие 8.3 и служба ones-mcp. По умолчанию служба слушает localhost — публикуя адрес наружу, помните: любой подключившийся клиент выполняет произвольные (только на чтение) запросы от имени заданного пользователя 1С:Предприятие 8.3.
Скачать установщик
Оставьте имя и контакт — после отправки формы откроется setupOnesMCP.exe. По оставленным контактам напомним про обновления и поможем с настройкой.
- Служба Windows с автозапуском и перезапуском при сбое
- Удаление —
uninstall.exeв каталоге установки - База не меняется: запросы только на чтение
Скачать установщик
Оставьте контакты — и после отправки формы получите ссылку на скачивание.
Техническая поддержка
Вопросы по подключению, настройке или работе сервера — поможем. Отсканируйте QR-код камерой телефона, у вас откроется чат в MAX.
