Особенности подключения коннекторов

Некоторые коннекторы требуют дополнительных действий для подключения.

1С

Добавление коннектора 1C зависит от наличия MCP-сервера:
  • Если у вас нет собственного MCP-сервера — добавьте предустановленный коннектор.

    При этом подключение возможно только к одной базе 1C.
  • Если у вас есть собственный MCP-сервер — создайте собственные MCP-коннекторы. Подробнее.

    При этом необходимо на каждую базу 1C создать отдельный коннектор.
Пример подключения и авторизации в MCP-коннекторе 1C

Типовые проблемы при подключении 1С через MCP-сервер

Нажмите, чтобы раскрыть

Ниже приведены типовые проблемы, с которыми можно столкнуться при подключении 1С через MCP-сервер, их причины и способы решения.

Проблемы с режимом работы базы 1С
Проблема Причина Как диагностировать Решение

Невозможно опубликовать HTTP-сервис

База работает в файловом режиме (.1CD)

Предприятие → Администрирование → Параметры системы → Режим работы

Конвертировать базу в клиент-серверный вариант (SQL Server, PostgreSQL, Oracle)

Публикация завершается ошибкой

Отсутствует сервер 1С:Предприятия

При публикации требуется указание SQL-сервера

Установить сервер 1С или перенести базу на существующий сервер

Проблемы с версией платформы 1С
Проблема Причина Как диагностировать Решение

Нет пункта «Расширения конфигурации»

Версия платформы ниже 8.3.10

Предприятие → Сервис → О программе

Обновить платформу 1С до актуальной стабильной версии

Нет вкладки «HTTP-сервисы» при публикации

Версия платформы ниже 8.3.6

Конфигуратор → Администрирование → Публикация на веб-сервере

Обновить платформу 1С до версии 8.3.6 или выше

Расширение не работает корректно

Несовместимость версии расширения и платформы

Логи 1С, ошибки при вызове HTTP-сервиса

Обновить платформу и расширение до актуальных версий

Проблемы с веб-сервером
Проблема Причина Как диагностировать Решение

Ошибка публикации на веб-сервере

Веб-сервер (Apache/IIS) не установлен

В списке служб Windows нет Apache/IIS

Установить веб-сервер (см. инструкцию по установке Apache 2.4)

Веб-сервер не запускается

Конфликт портов, ошибка в конфигурации

Служба Apache/IIS не стартует, логи веб-сервера

Проверить логи, освободить порт 80/443, исправить конфиг

HTTP-сервис недоступен после публикации

Веб-сервер работает, но публикация не прошла

Браузер возвращает 404 на /hs/mcp/health

Перепубликовать базу от имени администратора, проверить имя публикации

Доступ только по HTTP, нет HTTPS

Не настроен SSL-сертификат

URL начинается с http://

Получить и установить SSL-сертификат, настроить HTTPS в веб-сервере

Проблемы с доступом из интернета
Проблема Причина Как диагностировать Решение

URL недоступен извне

Сервер в локальной сети без проброса портов

curl http://[сервер]/[база]/hs/mcp/health работает только внутри сети

Настроить проброс портов на роутере или reverse proxy (nginx/Apache)

Нет статического IP

Динамический IP у сервера

IP меняется после перезагрузки

Заказать статический IP у провайдера или использовать DynDNS

Блокировка фаерволом

Порт 80/443 закрыт

telnet [сервер] 80 не подключается

Открыть порт в фаерволе Windows/iptables

1С:Фреш (SaaS)

Платформа не позволяет публиковать свои HTTP-сервисы на внешнем веб-сервере

—

Уточнить у провайдера 1С:Фреш наличие API для интеграции; рассмотреть переезд на self-hosted

1С:Линк

Доступ только через прокси 1С

База размещена на 1С:Линк

Использовать API 1С:Линк или запросить публикацию через поддержку

Проблемы с расширением MCP-сервера
Проблема Причина Как диагностировать Решение

Расширение не подключается

Файл .cfe повреждён или несовместим

Ошибка при подключении в Конфигураторе

Скачать актуальную версию расширения, проверить совместимость

HTTP-сервис не появляется после подключения

Расширение не активировано, нет прав

В списке HTTP-сервисов нет mcp

Перезапустить 1С, проверить права пользователя на расширение

Ошибка авторизации в HTTP-сервисе

Неверный логин/пароль, нет прав у пользователя

Браузер запрашивает пароль, затем возвращает 401/403

Создать отдельного пользователя 1С с правами на HTTP-сервис

{"status": "error"} вместо {"status": "ok"}

Ошибка внутри расширения

Логи 1С, журнал регистрации

Включить логирование в расширении, проверить логи

Часто задаваемые вопросы по коннектору 1С

Нажмите, чтобы раскрыть
Вопрос Комментарий Продукта

С какими конкретно конфигурациями 1С работает коннектор?

Коннектор к 1С унифицированный, работает с различными конфигурациями. Рекомендуемые версии, с которыми работает коннектор — 8.3.6+ (в более ранних версиях нет вкладки «HTTP-сервисы» при публикации и нет пункта «Расширения конфигурации»).

Работает ли он с доработанными конфигурациями?

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

Нужна ли публикация базы 1С наружу?

В виде поставки SaaS необходима публикация базы наружу — к базе должен быть выход в интернет, либо прописаны белые IP-адреса до Cowork.

Настройка в 1С (подробнее в предоставляемой инструкции):
  1. Подключите расширение mcp_dev.cfe и перезапустите 1С.

  2. Убедитесь, что установлен веб-сервер (при необходимости установите Apache 2.4).

  3. Запустите Конфигуратор 1С от имени администратора.

  4. Опубликуйте базу с опцией «Публиковать HTTP-сервисы расширений по умолчанию».

  5. Проверьте доступность по URL.

Настройка в Cowork:
  1. Введите полученный URL в поле «Публичный URL HTTP-сервиса 1С».

Через что идёт подключение: API, OData, расширение, обработка, веб-сервис?

Коннектор соответствует принципам стандарта MCP (спецификация): https://modelcontextprotocol.io/specification/2025-11-25

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

Кто настраивает права доступа к данным 1С?

Авторизация пользователя в коннектор происходит по кредам из 1С. Права доступа в коннектор 1С используются те, которые соответствуют 1С.

Можно ли ограничить доступ только чтением?

Пользователь может настроить доступ к конкретному инструменту коннектора (требовать подтверждение / не использовать / использовать). Т.е. можно ограничить запись, поставив к инструменту настройку «отключен» или «требует подтверждения» (будет запрашивать у пользователя действие по инструменту).

Можно ли разрешить создание черновиков, но запретить проведение?

Как таковых черновиков в 1С, насколько я знаю, нет. Если такой функционал существует в какой-то конфигурации, то можно задействовать через агента (не могу точно сказать).

Как обрабатывается сопоставление номенклатуры?

Информация используется из базы данных — фактически каждый текстовый запрос пользователя преобразуется в запрос к базе 1С через инструменты, написанные кодом 1С. Аналогия — это SQL-запросы.

Если необходимо сопоставить номенклатуру, то можно использовать дополнительно и внешнюю таблицу (не из 1С) для сравнения — таким образом будет использована информация из 1С и пользовательские данные.

Что происходит, если ИИ не уверен в совпадении позиции?

Как и человек, попробует сформировать гипотезу ответа и предоставить обоснования, если пользователь в явном виде не задал действия / границы размышления модели.

Можно ли подключить тестовую копию базы?

Да, можно — механизм описан в п. 1–5.

Подготовка к добавлению предустановленного коннектора 1C

1. Подключите расширение в базу

Для этого.
  1. Подключите расширение через «Управление расширениями конфигурации» в Предприятии или в Конфигураторе.

  2. Расширение — в файле mcp_dev.cfe (Чтобы скачать файл, откройте коннектор 1C в разделе button settings Администрирование → Коннекторы, нажмите button ellipsis vertical → Настроить, а затем Скачать файл расширения и инструкцию).

  3. Перезапустите сеанс, чтобы расширение применилось.

2. Опубликуйте HTTP-сервис

Требуется установленный веб-сервер. Если его ещё нет — смотри ниже главу установка веб-сервера Apache 2.4.

Запускайте Конфигуратор от имени администратора.
Для этого:
  1. Зайдите в Администрирование → Публикация на веб-сервере.

  2. Задайте имя публикации (оно станет именем базы в URL) и каталог публикации.

  3. На вкладке HTTP-сервисы включите флаг «Публиковать HTTP-сервисы расширений по умолчанию» (выбрать конкретный сервис расширения нельзя).

  4. Опубликовать.

3. Проверьте работоспособность

Откройте в браузере (подставьте сервер и имя базы):

http://[сервер]/[база]/hs/mcp/health

После ввода логина/пароля 1С должен вернуться {"status": "ok"}.

Дополнительно: установка веб-сервера Apache 2.4

Для этого:
  1. Скачайте дистрибутив: https://www.apachelounge.com/download/

  2. Распакуйте (например, в C:\Apache24).

  3. Зарегистрируйте службу — в папке Apache24\bin от имени администратора:

    httpd.exe -k install
  4. Запустите службу (в оснастке services.msc или httpd.exe -k start).

Добавление предустановленного коннектора 1C

Если вы сделали все подготовительные действия, можете приступать к подключению предустановленного коннектора 1C.

Для добавления коннектора:
  1. В разделе button settings Администрирование → Коннекторы, откройте коннектор 1C и нажмите button ellipsis vertical → button sliders vertical Настроить.

  2. Укажите:

    • Название.

    • Описание — коротко опишите возможности и инструменты коннектора, какие основные задачи он решает. По этим клюевым фразам ИИ-агент будет понимать, что необходимо подключить данный коннектор. Например, Добавь событие в календарь — для коннектора календаря. Описание отображается в карточке коннектора.

    • Публичный URL HTTP сервис 1C — вставьте URL опубликованной базы 1C.

    • Тип аутентификации — выберите тип аутентификации, используемый в вашей 1C.

    • Инструкция авторизации — Укажите инструкцию-подсказку по авторизации в коннекторе. Инструкция будет видна пользователям при наведении на иконку информации button info рядом с кнопкой авторизации в коннекторе.

  3. Нажмите Добавить или Добавить и войти в аккаунт, чтобы добавить и одновременно авторизоваться в коннекторе.

Calendly

Для работы требуется оплаченная подписка сервиса.

iiko

Для работы требуется оплаченная подписка сервиса.

InSales

Для работы требуется оплаченная подписка сервиса.

Mail.ru

Для создания пароля коннектора:
  1. Войдите в свою почту Mail.ru через браузер на вашем устройстве.

  2. Откройте Настройки → Все настройки → Безопасность.

  3. Найдите раздел Пароли для внешних приложений и нажмите Добавить.

  4. Придумайте название для пароля (например, GigaCowork), чтобы потом понять, для чего он.

  5. Подтвердите ваш основной пароль от аккаунта Mail.ru.

  6. Mail.ru сгенерирует пароль — сразу скопируйте его, он показывается только один раз.

Для работы требуется оплаченная подписка сервиса.

MPSTATS

Для работы требуется оплаченная подписка сервиса.

Mindbox

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

Шаг 1. Перейдите в раздел «Кампании»

  • Откройте Mindbox

  • Перейдите в раздел Кампании

Шаг 2. Создайте операцию

  1. Нажмите «Создать кампанию» → «Операция»

  2. Выберите папку, где будет храниться операция

  3. Нажмите «Создать»

Шаг 3. Настройте параметры операции

Выберите точку интеграции

  • Сайт, лендинг, касса, мобильное приложение

  • Можно выбрать несколько точек с одинаковыми настройками

Выберите тип операции

Тип Описание

Стандартная

Обычная скорость обработки (для большинства задач)

Приоритетная

Мгновенная обработка (для авторизации, регистрации, начисления баллов)

Дополнительные флаги (по необходимости)

  • «Запускает транзакционный сценарий»

  • «Операция требует передачи deviceUUID»

  • «Операция требует передачи секретного сервисного ключа»

  • «Операция возвращает валидационные ошибки»

Шаг 4. Настройте шаги операции

Шаги делятся на категории:
  • Шаги для работы с клиентами.

  • Шаги-действия (зависимые шаги).

Шаги для работы с клиентами

Добавление в базу
Шаг Описание

Зарегистрировать

Регистрация в ЛК или программе лояльности

Создать и подписать на рассылки

Подписка через формы или web-push

Импортировать

Создать нового или обновить существующего

Работа с существующими клиентами
Для авторизованных клиентов (уверены в личности)
  • Получить существующего

  • Редактировать

  • Дополнить

Для неавторизованных клиентов (не уверены в личности)
  • Получить существующего

  • Редактировать (только зону/город)

  • Зарегистрировать или дополнить

Шаги-действия (зависимые шаги)

После выбора типа клиента становятся доступны:

  • Оформление заказа

  • Установка списка товаров (корзина, избранное)

  • Отправка Email или SMS

  • Выдача действий

  • Изменение баланса

Шаги связаны между собой. Например, шаг «Оформление заказа» доступен только после выбора клиента.

Шаг 5. Сохраните и получите документацию

  1. Нажмите «Добавить»

  2. Нажмите «Посмотреть описание» — система автоматически сгенерирует:

    • Описание вызова

    • Форматы передачи данных

    • Тело запроса

    • Примеры вызова и ответа

Шаг 6. Отладка и мониторинг

  • Мониторинг интеграции — список операций с количеством ошибок

  • Лог вызовов операций — детализация ошибочных вызовов

  • Включите флаги валидации для анализа ошибок в ответе

Применительно к коннектору в GigaCowork

Коннектор Mindbox, доступный для подключения, поддерживает следующие операции, которые должны быть предварительно настроены в Mindbox:

Инструмент коннектора Требуемая операция в Mindbox

Создать клиента (Sync/Async)

Операция с шагом «Зарегистрировать» или «Создать и подписать»

Обновить клиента

Операция с шагом «Редактировать клиента»

Получить информацию о клиенте

Операция с шагом «Получить существующего»

Создать/обновить заказ

Операция с шагами «Клиент» + «Оформление заказа»

Выдать действие

Операция с шагом «Выдача действий»

Отправить email-рассылку

Операция с шагом «Отправка Email»

Обновить статус линий заказа

Операция с шагом обновления статуса заказа

Получить ассортимент

Операция экспорта товаров

Перед подключением коннектора в GigaCowork убедитесь, что в Mindbox созданы соответствующие операции с нужными шагами для каждого инструмента, который планируете использовать.

ProgressMe

Для работы требуется оплаченная подписка сервиса.

Skillaz

Для работы требуется оплаченная подписка сервиса.

UIS

Для работы требуется оплаченная подписка сервиса.

Битрикс24

Пример авторизации

Для работы требуется оплаченная подписка сервиса BitrixGPT + Маркетплейс. Также необходимо установить в маркетплейсе Битрикс24 приложение Albato.

Мессенджер MAX

Для работы коннектора необходим верифицированный профиль организации в MAX, а также токен прошедшего модерацию бота в MAX.

Для создания бота и получения токена:
  1. Перейдите в личный кабинет мессенджера по адресу http://business.max.ru/self и выберите профиль вашей организации.

  2. Откройте раздел Чат-боты и нажмите Создать.

  3. Заполните данные бота:

    • Название.

    • Аватар.

    • Описание.

  4. Нажмите Создать и дождитесь прохождения модерации. После одобрения бот станет доступен пользователям.

    Для создания бота необходим верифицированный профиль организации. Каждая организация может создать до 5 ботов.
  5. После одобрения перейдите в Чат-боты → Интеграция, нажмите Получить токен и скопируйте его.

Почта России

Коннектор работает только с корпоративными аккаунтами Почты России.

Telegram

Обмен сообщений GigaCowork с Telegram осуществляется через специального бота. Для авторизации потребуется API-ключ существующего или нового бота.

Создание бота

Чтобы создать бота:
  1. Отправьте боту @BotFather команду /start.

  2. Для создания нового бота отправьте команду /newbot.

  3. Укажите имя бота — оно будет отображаться для всех пользователей.

  4. Укажите имя пользователя (username). Оно должно:

    • Начинаться с символа @.

    • Обязательно заканчиваться на bot. Пример: youNamebot или youName_bot.

  5. После создания бот предоставит API-ключ — скопируйте его.

Выбор существующего бота

  1. Отправьте боту @BotFather команду /mybots.

  2. Выберите нужного бота из списка.

  3. Запросите API-ключ для подключения.

Важные ограничения

Ограничения
Ограничение Описание

Бот должен быть в чате

Чтобы отправить сообщение в группу/канал, бот должен быть добавлен в этот чат как участник

Только цифровой ID

Все отправки работают только по цифровому ID чата/пользователя. Username (@name) не поддерживается

Права бота

В группах боту нужны права на отправку сообщений (проверьте настройки группы)

Пользователи пишут боту первыми

Бот не может написать пользователю первым — пользователь должен сначала запустить бота (/start)

Форматы ID:

Тип Формат ID Пример

Личный чат

Положительное число

123456789

Группа

Отрицательное число

-1001234567890

Супергруппа

Отрицательное число с -100

-1001234567890

Канал

Отрицательное число с -100

-1001234567890

Как получить ID чата/группы/пользователя

Способ 1: Через бота @userinfobot (для личных ID)

  1. Откройте @userinfobot в Telegram

  2. Нажмите /start

  3. Бот вернёт ваш цифровой ID

Способ 2: Через бота @getmyid_bot (для групп и каналов)

  1. Добавьте @getmyid_bot в нужную группу/канал

  2. Бот автоматически отправит сообщение с ID чата

  3. Скопируйте ID из сообщения (будет в формате -1001234567890)

  4. Удалите бота из чата после получения ID (опционально)

Способ 3: Через веб-версию Telegram

  1. Откройте https://web.telegram.org

  2. Перейдите в нужный чат/группу/канал

  3. Посмотрите на URL в адресной строке:

    1. Для личных чатов: …​/c/123456789/…​ → ID = 123456789

    2. Для групп/каналов: …​/c/-1001234567890/…​ → ID = -1001234567890

Способ 4: Через API (для разработчиков)

Метод: getUpdates
URL: https://api.telegram.org/bot<TOKEN>/getUpdates

Отправьте сообщение в чат с ботом, затем вызовите метод — в ответе будет chat.id

Способ 5: Добавить своего бота в группу

  1. Добавьте вашего бота в целевую группу/канал

  2. Отправьте любое сообщение в группу (упомяните бота или нет)

  3. Используйте метод getUpdates или посмотрите логи бота — там будет ID чата

  4. Важно: бот должен оставаться в группе для отправки сообщений

Доступные действия

Действие Описание

Отправить сообщение

Текстовое сообщение в чат/группу/канал

Ответить на сообщение

Reply на конкретное сообщение

Закрепить сообщение

Закрепить сообщение в чате

Удалить сообщение

Удалить сообщение из чата

Создать опрос

Голосование с вариантами ответов

Получить участника чата

Информация об участнике

Дать права администратора

Назначить админа в чате

Заблокировать участника

Забанить пользователя

Разблокировать участника

Разбанить пользователя

Примеры использования

Отправить сообщение в группу:
Требуемые данные:
- chat_id: -1001234567890 (цифровой ID группы)
- text: "Коллеги, напоминание о совещании в 15:00"

Важно:
- Бот должен быть добавлен в эту группу
- ID должен быть в формате с минусом для групп
Отправить сообщение пользователю:
Требуемые данные:
- chat_id: 123456789 (цифровой ID пользователя)
- text: "Здравствуйте! Ваша заявка обработана"

Важно:
- Пользователь должен сначала запустить бота (/start)
- Бот не может написать первым неизвестному пользователю
Создать опрос:
Требуемые данные:
- chat_id: -1001234567890
- question: "Выберите дату встречи"
- options: ["Понедельник", "Среда", "Пятница"]
- is_anonymous: false (опционально)

Частые ошибки

Ошибка Причина Решение

Chat not found

Неверный ID чата

Проверьте формат ID (с минусом для групп)

Bot is not a member

Бот не в чате

Добавьте бота в группу/канал

Bot can’t send messages

Нет прав у бота

Проверьте права бота в настройках группы

Blocked by user

Пользователь заблокировал бота

Свяжитесь другим способом

Bot was kicked

Бот удалён из чата

Добавьте бота повторно

Message not modified

Текст не изменился

Измените содержимое сообщения

Bad Request: chat_id is empty

Не указан ID

Передайте цифровой ID в параметрах

Яндекс Почта

Пример авторизации:
Для создания пароля коннектора:
  1. Войдите в аккаунт Яндекса на любом устройстве.

  2. Откройте Безопасность.

  3. Перейдите в Пароли приложений.

  4. Включите использование паролей приложений, если это еще не сделано.

  5. Нажмите Создать пароль приложения, выберите тип приложения и задайте название. Сразу скопируйте или запомните пароль: он показывается только один раз.