Полная инструкция: подключение и использование 1С MCP
для клиентов, подключающих свою базу 1С к Агенту BitrixGPT через приложение «1С MCP»
После выполнения всех шагов агент в чате Битрикс24 сможет находить контрагентов, проверять остатки, цены, заказы, оплаты и задолженность прямо в вашей базе 1С — без переключения между системами.
Шаг 1. Установить приложение в Битрикс24
- Откройте ваш портал Битрикс24.
- Перейдите в раздел Маркетплейс Битрикс24 и найдите приложение «1С MCP» (либо перейдите по прямой ссылке на карточку приложения, если мы её прислали).
- Нажмите «Установить» и подтвердите запрос доступа.
Приложение ничего не требует настраивать внутри самого Битрикс24 — вся настройка дальше происходит со стороны 1С и через форму подключения.
Шаг 2. Открыть доступ к базе 1С по OData
Этот шаг выполняет тот, кто администрирует вашу базу 1С (свой IT-специалист или франчайзи-партнёр). Занимает 5–10 минут, программирование не требуется.
2.1. Открыть настройки OData
В 1С (в веб-версии или в толстом клиенте) зайти в меню:
- Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData
В разных конфигурациях пункт меню может называться чуть иначе, например «Администрирование и НСИ → Синхронизация данных → …» или «Настройки → Синхронизация данных → …» — ищите по словам «синхронизация данных» или «OData».
Откроется обработка «Настройка автоматического REST-сервиса». Доступна она только пользователю с полными правами (обычно владелец базы/администратор).
2.2. Создать служебного пользователя
На вкладке «Авторизация» нажать на создание нового пользователя для OData.
- Не используйте для этого свой обычный логин — заведите отдельного технического пользователя.
- 1С сама назначит ему нужную роль (УдалённыйДоступOData) — это ограниченные права, без доступа администратора и без возможности зайти в 1С интерактивно.
- Придумайте пароль и сохраните его вместе с логином — они понадобятся на шаге 3.
2.3. Включить нужные объекты доступа
На вкладке «Состав» поставить галочки напротив следующих объектов. Ничего лишнего включать не нужно — сервис обращается только к перечисленному ниже.
| Раздел | Объект | Для чего нужен |
|---|
| Справочники | Контрагенты | Поиск клиента по ИНН/названию, задолженность |
| Справочники | Номенклатура | Поиск товара, цены, остатки |
| Справочники | Склады | Список складов |
| Документы | Заказ покупателя | Заказы: создание, список, состав, изменение |
| Документы | Платёжное поручение | Проверка оплаты по заказу |
| Документы | Счёт на оплату покупателю | Выставление счетов |
| Документы | Реализация товаров и услуг | Проверка отгрузки заказа |
| Регистры накопления | ТоварыНаСкладах | Остатки товара на складах |
| Регистры накопления | ВзаиморасчетыСКонтрагентами | Задолженность по контрагенту |
| Регистры сведений | ЦеныНоменклатуры | Актуальная цена товара |
Точные названия объектов в дереве настройки могут немного отличаться от типовых (зависит от конфигурации — УТ, КА, Фреш или доработанная база). Если нужного пункта нет в списке — либо в базе не используется этот раздел учёта, либо он называется иначе; в этом случае напишите нам, разберёмся.
После выбора объектов нажать «Записать и закрыть».
Шаг 3. Зарегистрировать базу и получить API-ключ
- Откройте страницу регистрации:
https://bizintegracia.webtm.ru/1c-mcp/register.php
- Заполните форму:
- Название — любое удобное для вас обозначение (например, название вашей компании).
- Адрес базы — адрес, по которому вы открываете ваш 1С в браузере (для 1С:Фреш — вида https://1cfresh.com/a/... или аналогичного облачного сервиса; для собственного сервера — адрес публикации базы).
- Логин / Пароль — данные служебного пользователя, созданного на шаге 2.2.
Нажмите кнопку подключения. Сервис сам проверит связь с вашей базой 1С.
Если всё верно — на экране появится API-ключ вида sk_1c_.... Скопируйте его целиком и сохраните в надёжном месте — он показывается только один раз, повторно посмотреть будет нельзя, придётся выпускать новый.
Если форма выдала ошибку при проверке подключения — чаще всего это значит, что логин/пароль введены неверно, либо адрес базы указан с ошибкой, либо ещё не выполнен шаг 2. Если всё введено правильно, но ошибка повторяется — напишите нам.
Шаг 4. Подключить сервис в чате с Агентом BitrixGPT
- Откройте в Битрикс24 чат с Агентом BitrixGPT.
- Под полем ввода сообщения найдите кнопку «Подключения».
- Выберите из списка сервис «1С MCP».
- Вставьте в появившееся поле API-ключ, полученный на шаге 3, и нажмите «Подключить».
Важно: выбор сервиса в «Подключениях» действует только в текущем чате. Если вы начнёте новый чат с агентом и он ответит, что «база 1С не подключена» — это не ошибка, а особенность интерфейса: просто заново выберите «1С MCP» в подключениях этого конкретного чата.
Как пользоваться агентом
Пишите агенту обычным языком — отдельных команд или синтаксиса запоминать не нужно, он сам поймёт, какое действие выполнить.
Примеры вопросов:
Контрагенты
- «Найди контрагента с ИНН *************»
- «Поищи контрагента с названием Балтика»
- «Какая у нас задолженность по контрагенту Балтика?»
Товары, остатки, цены
- «Какой остаток по артикулу 8940?»
- «Найди товар — фильтр масляный»
- «Какая сейчас цена на артикул 8940?»
- «Покажи список складов»
Заказы, оплата, отгрузка
- «Покажи заказы за последние 7 дней»
- «Какие заказы были у контрагента Балтика за последние 3 месяца?»
- «Что входит в заказ АСФР-000112?»
- «Оплачен ли заказ АСФР-000112?»
- «Отгружен ли заказ АСФР-000112?»
Действия, которые меняют данные в 1С
Создание заказа, выставление счёта, проведение и отмена проведения документа, изменение состава заказа — самое важное, что нужно знать сотрудникам: такие действия происходят в два шага.
- Вы просите, например: «Создай заказ для контрагента Балтика на 10 штук артикула 8940».
- Агент не создаёт заказ сразу — показывает предпросмотр: контрагент, товары, количество.
- Вы проверяете предпросмотр и явно подтверждаете: «Да, создавай» / «Подтверждаю».
- Только после этого заказ реально появляется в 1С.
Так же работают: изменение состава заказа, выставление счёта, проведение и отмена проведения документа. Это защита от случайных изменений в учётной системе — пока вы явно не подтвердите, в 1С ничего не меняется.
Отменить ошибочное действие — например, документ провели по ошибке — можно попросить: «Отмени проведение документа [номер]», агент так же сначала покажет предпросмотр.
Если что-то не работает
| Симптом | Вероятная причина |
|---|
| Ошибка при регистрации на шаге 3 | Неверный адрес/логин/пароль базы, либо ещё не выполнен шаг 2 |
| Агент пишет «база 1С не подключена» | В этом конкретном чате не выбрана «1С MCP» в подключениях — выберите заново (шаг 4) |
| Ошибка о том, что объект/сущность не найдена | В 1С не включён доступ к этому разделу учёта на шаге 2.3 — вернитесь в настройку и добавьте нужный пункт |
| Ошибка 401 при обращении к данным | Проверьте логин/пароль служебного пользователя и что он не заблокирован |
| Ошибка таймаута при подключении на шаге 4 | Обычно временная — повторите подключение через пару минут |
