Back to blog

Найкращий ШІ-помічник для Bitrix CMS: підключення Mia через MCP

uk • 7/7/2026

Перетворіть свій сайт на Bitrix на розмовний робочий простір. Цей посібник показує, як підключити Mia Handles до 1C-Bitrix за допомогою модуля hiweb.site_mcp — встановлення, налаштування bearer-авторизації та керування контентом прямо з Telegram.

Найкращий ШІ-помічник для Bitrix CMS: підключення Mia через MCP

Найкращий ШІ-помічник для Bitrix CMS: підключення Mia через MCP

Bitrix Site Manager забезпечує роботу мільйонів корпоративних сайтів у всьому світі — і завдяки Model Context Protocol (MCP) він тепер може напряму взаємодіяти з Mia, вашим особистим ШІ-секретарем. У цьому посібнику ми пройдемо повний шлях налаштування: від встановлення офіційного модуля MCP до підключення його до вашого чату з Mia.

Після підключення ви зможете просити Mia керувати новинами, інфоблоками, користувачами, замовленнями та іншим — і все це в рамках одного чату в Telegram. Жодних вкладок браузера, складних панелей адміністратора чи постійного перемикання контексту.

Що таке MCP і навіщо це вам?

Model Context Protocol — це відкритий стандарт, який дозволяє ШІ-агентам взаємодіяти з зовнішніми сервісами через структурований і безпечний інтерфейс.

MCP-сервер надає можливості системи. MCP-клієнт (Mia) підключається до цього сервера і викликає ці можливості від вашого імені.

Для власників сайтів на Bitrix це означає, що ви можете:

  • Просити Mia публікувати новини або оновлювати записи в інфоблоках
  • Шукати замовлення, клієнтів або товари за критеріями
  • Генерувати звіти про продажі, трафік або ефективність контенту
  • Створювати користувачів, призначати ролі або керувати правами доступу
  • Запитувати аналітику або отримувати дані про продуктивність

Все це — з одного чату в Telegram.

Що потрібно для початку

Перед початком переконайтеся, що у вас є:

  • Сайт на 1C-Bitrix (ліцензований, з можливістю встановлення модулів)
  • Права адміністратора для встановлення модулів та налаштування параметрів
  • Акаунт Mia Handles з тарифним планом не нижче Standard (для роботи MCP-підключень потрібен доступ до API)
  • SSL-сертифікат на вашому сайті Bitrix (для MCP-ендпоінту обов'язковим є HTTPS)

Крок 1 — Встановлення модуля hiweb.site_mcp

Рекомендованим модулем є hiweb.site_mcp з Маркетплейсу Bitrix. Він реалізує офіційний MCP-сервер для Bitrix.

Посилання на Маркетплейс: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Примітка: Сторінка на маркетплейсі зараз в розробці, але скоро буде опублікована. Якщо у вас вже є модуль, переходьте до Кроку 2.

В адміністративній панелі Bitrix:

  1. Перейдіть до Налаштування → Маркетплейс
  2. Знайдіть hiweb.site_mcp або використайте пряме посилання вище
  3. Встановіть та активуйте модуль
  4. Після активації перейдіть до Налаштування → Налаштування продукту → MCP Server

Там ви знайдете:

  • Endpoint URL — публічна адреса для MCP-ендпоінту (зазвичай https://yoursite.com/api/mcp/)
  • Authentication — налаштування bearer-токена
  • Tools to expose — вибір інструментів, до яких Mia матиме доступ (інфоблоки, новини, користувачі, замовлення, аналітика тощо)

Крок 2 — Генерація Bearer-токена

Модуль Bitrix MCP використовує аутентифікацію через Bearer-токен для безпечного API-доступу.

  1. Перейдіть до Налаштування → Налаштування продукту → MCP Server
  2. Натисніть Generate Token або Create New Token
  3. Назвіть токен, наприклад Mia MCP Integration
  4. Встановіть термін дії (рекомендовано: необмежений для продакшн-використання)
  5. Скопіюйте згенерований токен — ви побачите його лише один раз

Цей токен стане обліковими даними, які використовуватиме Mia для підключення до вашого сайту Bitrix.

Крок 3 — Безпечне налаштування ендпоінту

MCP-ендпоінт має бути доступним лише для сервісів, яким ви довіряєте. Типові варіанти:

  • Аутентифікація через Bearer-токен — кожен запит повинен містити заголовок Authorization з токеном
  • Білий список IP — обмежте доступ до шляху MCP лише для IP-діапазонуバックенду Mia
  • Приватна мережа / VPC — для корпоративних налаштувань

Якщо ваш сайт на Bitrix знаходиться за Cloudflare або іншим WAF, переконайтеся, що шлях MCP дозволено для методів POST. Перед підключенням Mia протестуйте ендпоінт за допомогою curl (див. Крок 5).

Крок 4 — Підключення Bitrix-сервера в Mia Handles

Тепер найцікавіше. У чаті з Mia:

  1. Відкрийте Mia miniapp (натисніть на фото профілю або використовуйте меню)
  2. Перейдіть до Settings → Tools → MCP Servers → Add (або відредагуйте існуючий сервер)
  3. Заповніть форму підключення:
Server name:   Мій сайт Bitrix
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (вставте згенерований bearer-токен)

Важливо: Оберіть JSON POST (stateless) як тип транспорту. НЕ використовуйте Streamable HTTP або SSE — модуль Bitrix MCP приймає лише запити POST JSON-RPC.

  1. Натисніть Connect. Mia перевірить ендпоінт, отримає список доступних інструментів і додасть сервер до вашого чату.

Крок 5 — Тестування підключення

Після підключення спробуйте просту команду в чаті з Mia:

"Список останніх 5 новин на моєму сайті Bitrix"

Mia має надати резюме, отримане безпосередньо з вашого сайту. Якщо виникла помилка, перевірте:

  • Валідність та термін дії токена (Bearer token)
  • Чи активовано модуль MCP та чи включені інструменти
  • Чи доступний ендпоінт з бакенду Mia (фаєрвол, SSL-сертифікат)
  • Чи обрано тип транспорту JSON POST (stateless)

Ви також можете протестувати вручну через curl:

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  "https://example.com/hiweb-site-mcp/"

Ви повинні отримати список JSON-інструментів у відповідь — це означає, що сервер працює.

Крок 6 — Що можна робити після налаштування

Після підключення Mia стане вашим ко-пілотом для Bitrix. Ось найпопулярніші сценарії:

  • Операції з контентом — створення, оновлення або публікація новин та записів інфоблоків
  • Керування медіа — перегляд, завантаження або заміна зображень у файлах
  • Керування користувачами — створення акаунтів, зміна паролів, призначення ролей
  • Замовлення та CRM — запити щодо замовлень, клієнтів, угод або лідів
  • Аналітика — отримання звітів про трафік, конверсію або підсумки продажів
  • Планування публікацій — додавання контенту в чергу на майбутнє через календар Mia

Оскільки Mia вже знає ваш календар, завдання та файли, вона може організовувати роботу в Bitrix разом з іншими справами, наприклад:

"Створи пост з новиною про запуск продукту, про який я казав, заплануй його на середу о 14:00 і додай завдання для відділу маркетингу на перевірку."

Mia виконає все це за один раз.

Усунення несправностей

Сиптом Ймовірна причина Рішення
"Connection failed" Ендпоінт заблоковано або невірна URL Перевірте фаєрвол та SSL-сертифікат
"No tools available" Модуль вимкнено або не обрано інструменти Увімкніть модуль та оберіть хоча б один інструмент
"Unauthorized" Невірний bearer-токен Перегенеруйте токен у налаштуваннях MCP та оновіть у Mia
"HTTP 404" Невірний шлях ендпоінту Перевірте налаштовану адресу URL в модулі
"Transport error" Невірний тип транспорту Використовуйте JSON POST (stateless), не SSE або Streamable
Повільні відповіді Забагато увімкнених інструментів Вимкніть зайві, увімкніть пагінацію

WordPress та Drupal працюють так само

Якщо у вас також є сайт на WordPress або Drupal, діє та сама схема. Кожна CMS має власний MCP-адаптер, але процес підключення в Mia ідентичний — встановлення модуля, відкриття ендпоінту, копіювання облікових даних у Mia. Ви навіть можете підключити всі три платформи до одного чату, і Mia розрізнятиме їх за іменами.

Інші посібники:

Підсумок

Підключення Bitrix до Mia через MCP перетворює вашу CMS з окремої панелі на розмовне доповнення до вашого щоденного робочого процесу. Після налаштування все просто працює — тихо, у фоновому режимі, саме тоді, коли це потрібно.

Якщо у вас виникли запитання або потрібна допомога з налаштуванням, просто запитайте Mia прямо в чаті. Вона вже знає протокол.