Лучший AI-компаньон для Bitrix CMS — руководство по настройке MCP

Лучший AI-компаньон для Bitrix CMS: подключите Mia через MCP

Диспетчер сайтов Bitrix обеспечивает работу миллионов корпоративных сайтов по всему миру — и с Model Context Protocol (MCP) он теперь напрямую разговаривает с Mia, вашим личным AI-секретарём. В этом руководстве мы пройдём полную настройку: от установки официального MCP-модуля до подключения его к вашему чату Mia.

После подключения вы можете попросить Mia управлять новостями, инфоблоками, пользователями, заказами и многим другим — всё из одного разговора в Telegram. Никаких вкладок браузера, никаких админ-панелей, никакого переключения контекста.

Что такое MCP и почему это важно?

Model Context Protocol — это открытый стандарт, который позволяет AI-агентам взаимодействовать с внешними сервисами через структурированный, безопасный интерфейс.

MCP сервер раскрывает возможности системы. MCP клиент (Mia) подключается к этому серверу и вызывает его возможности от вашего имени.

Для владельцев сайтов Bitrix это означает, что вы можете делать, например:

Попросить Mia публиковать новости или обновлять записи инфоблоков
Искать заказы, клиентов или товары по заданным критериям
Генерировать отчёты о продажах, трафике или эффективности контента
Создавать пользователей, назначать роли или управлять правами
Запрашивать аналитику или подтягивать показатели производительности

И всё — из одного чата в Telegram.

Предварительные требования

Перед началом убедитесь, что у вас есть:

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

Шаг 1 — Установите модуль hiweb.site_mcp

Рекомендуемый модуль — hiweb.site_mcp из Bitrix Marketplace. Он предоставляет официальную реализацию MCP-сервера для Bitrix.

Ссылка на маркетплейс: https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Примечание: страница маркетплейса сейчас находится в разработке, но скоро будет опубликована. Если модуль у вас уже есть — переходите к Шагу 2.

В вашей админ-панели Bitrix:

Перейдите в Настройки → Маркетплейс
Найдите hiweb.site_mcp или используйте прямую ссылку выше
Установите и активируйте модуль
После активации перейдите в Настройки → Настройки сайта → MCP Server

Там вы найдёте:

Endpoint URL — публичный URL для MCP endpoint (обычно https://yoursite.com/api/mcp/)
Аутентификация — настройка bearer token
Tools to expose — переключатели того, к каким возможностям Bitrix Mia сможет получать доступ (инфоблоки, новости, пользователи, заказы, аналитика и т. д.)

Шаг 2 — Сгенерируйте Bearer Token

Модуль Bitrix MCP использует аутентификацию Bearer token для безопасного доступа к API.

Перейдите в Настройки → Настройки сайта → MCP Server
Нажмите Generate Token или Create New Token
Укажите имя, например Mia MCP Integration
Установите срок действия токена (рекомендуется: без срока действия для использования в продакшене)
Скопируйте сгенерированный токен — вы увидите его только один раз

Этот токен становится учётными данными, которые Mia использует для подключения к вашему сайту Bitrix.

Шаг 3 — Безопасно откройте endpoint

MCP endpoint должен быть доступен только для сервисов, которым вы доверяете. Типичные варианты:

Bearer token auth — каждый запрос должен содержать заголовок Authorization с bearer token
IP allowlist — ограничьте путь MCP диапазоном IP, принадлежащим бэкенду Mia
Приватная сеть / VPC — для корпоративных сценариев

Если ваш сайт Bitrix находится за Cloudflare или другим WAF, убедитесь, что путь MCP разрешён через POST-методы. Сначала протестируйте endpoint с помощью curl (см. Шаг 5) перед подключением Mia.

Шаг 4 — Подключите сервер Bitrix в Mia Handles

Теперь самое интересное. В вашем чате Mia:

Откройте Mia miniapp (тапните по вашей фотографии профиля или используйте меню)
Перейдите в Settings → Tools → MCP Servers → Add (или отредактируйте существующий сервер)
Заполните форму подключения:

Server name:   My Bitrix Site
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (вставьте сгенерированный bearer token)

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

Нажмите Connect. Mia проверит endpoint, перечислит доступные инструменты и добавит сервер в ваш чат.

Шаг 5 — Проверьте подключение

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

"Покажи последние 5 новостей на моём сайте Bitrix"

Mia должна вернуть краткое резюме, подтянутое напрямую с вашего сайта. Если возникнет ошибка, проверьте:

Валидность bearer token и срок действия
Что модуль MCP активен и инструменты включены
Что Endpoint URL доступен с бэкенда Mia (фаервол, SSL-сертификат)
Что тип транспорта установлен в JSON POST (stateless)

Также вы можете протестировать вручную через curl:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -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 становится вашим co-pilot для Bitrix. Вот самые частые задачи, которые вы можете решать:

Операции с контентом — создавать, обновлять или публиковать новости и записи инфоблоков
Управление медиа — перечислять, загружать или заменять изображения в файлах
Управление пользователями — создавать аккаунты, сбрасывать пароли, назначать роли
Заказы & CRM — запрашивать заказы, клиентов, сделки или лиды
Аналитика — получать отчёты по трафику, метрики конверсии или сводки по продажам
Отложенная публикация — ставить контент в очередь на будущие даты через календарь Mia

И поскольку Mia уже знает ваш календарь, задачи и файлы, она может оркестрировать работу с Bitrix вместе с остальными делами в течение дня — например:

"Создай новость о запуске продукта, который я тебе отправил, запланируй её на среду в 14:00 и добавь задачу для маркетинговой команды, чтобы они её просмотрели."

Mia выполнит все три действия за один раз.

Устранение неполадок

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

WordPress и Drupal работают так же

Если вы также запускаете сайт на WordPress или Drupal, применяется тот же принцип. У каждого CMS есть свой MCP-адаптер, но сценарий подключения в Mia идентичен — установите модуль, раскройте endpoint, вставьте учётные данные в Mia. Вы даже можете подключить все три платформы к одному и тому же чату Mia, и она будет обращаться к каждой по имени.

Для остальных руководств смотрите:

Подведём итог

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

Если у вас есть вопросы или нужна помощь с настройкой, просто спросите Mia напрямую в чате. Она уже знает протокол.