Как Mia работает с Drupal — Руководство по настройке (MCP-сервер)

Как Mia работает с Drupal: Практическое руководство по настройке

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

К концу этого руководства Mia сможет читать, создавать, обновлять и управлять контентом Drupal прямо из вашего Telegram-чата — без дашбордов и переключения контекста.

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

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

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

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

Попросить Mia создать или обновить пост в блоге
Найти черновики неопубликованного контента
Получить список терминов таксономии, пользователей или представлений (Views)
Запустить рабочие процессы (модерация, публикация, планирование)
Получить отчеты о состоянии работоспособности и статусе сайта

И все это — из одного Telegram-чата.

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

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

Сайт на Drupal 10.x или 11 (PHP 8.1+, стандартная установка Composer)
Права администратора для установки модулей
Аккаунт Mia Handles с планом не ниже Standard (для подключения MCP требуется доступ к API)
Глобально установленный PHP MCP SDK или доступный через Composer

Шаг 1 — Установка модуля Drupal MCP Server

Рекомендуемый модуль — mcp_server с Drupal.org. Он построен на основе официального modelcontextprotocol/php-sdk (совместная разработка PHP Foundation и Symfony).

Из корневой директории вашего сайта выполните:

composer require drupal/mcp_server

Затем включите его через Drush или пользовательский интерфейс:

drush en mcp_server -y
drush cr

В качестве альтернативы перейдите в Extend → Install new module, загрузите архив и включите модуль.

После включения перейдите в Configuration → Web services → MCP Server (/admin/config/services/mcp_server). Здесь вы найдете:

Endpoint URL — публичный URL для MCP-соединения (обычно https://yoursite.com/mcp)
Authentication — Basic auth, токен или OAuth (рекомендуется: токен)
Tools and resources — переключатели для определения того, какие возможности Drupal будут доступны (узлы, пользователи, таксономия, Views и т. д.)

Сгенерируйте безопасный API-токен и сохраните его — он понадобится вам в Mia.

Шаг 2 — Безопасное раскрытие конечной точки

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

IP-белый список — ограничение доступа по IP-адресу бэкэнда Mia
Аутентификация по токену — каждый запрос должен содержать токен в заголовке
Частная сеть / VPC — для корпоративных решений

Если ваш Drupal-сайт находится за Cloudflare или другим WAF, убедитесь, что путь /mcp разрешен для методов POST и GET, а также SSE, если вы используете стриминг.

Шаг 3 — Подключение Drupal-сервера в Mia Handles

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

Откройте мини-приложение Mia (нажмите на свое фото профиля или используйте меню)
Перейдите в Settings → Integrations → Add MCP server
Заполните форму подключения:

Server name:   My Drupal Site
Endpoint URL:  https://yoursite.com/mcp
Transport:     Streamable HTTP
Auth:          Bearer token
Token:         (вставьте ваш Drupal MCP токен)

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

Вы также можете подключиться, используя транспорт SSE или JSON POST — Mia поддерживает все три.

Шаг 4 — Проверка подключения

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

"List the last 5 unpublished articles on my Drupal site"

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

Действительность токена в настройках Drupal MCP
Доступность URL конечной точки с бэкэнда Mia (брандмауэр, SSL-сертификат)
Наличие необходимых инструментов, включенных на стороне Drupal

Что вы можете делать после настройки

Вот несколько примеров того, что Mia может сделать для вас после подключения:

Операции с контентом — создание черновиков, публикация/снятие с публикации, массовое редактирование полей
Таксономия и ссылки — добавление терминов, организация словарей
Управление пользователями — создание учетных записей, сброс паролей, назначение ролей
Запросы Views — получение структурированных отчетов в формате Markdown или JSON
Запуск рабочих процессов — перемещение контента между состояниями модерации
Планирование публикаций — постановка статей в очередь на будущие даты через задачи Mia или календарь

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

"Publish the interview I finished recording this morning as an article on my Drupal site, and remind the editor to review it tomorrow at 10:00."

Mia выполнит обе задачи одновременно.

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

Симптом	Вероятная причина	Исправление
"Connection failed"	Конечная точка заблокирована или неправильный URL	Проверьте правила брандмауэра и SSL-сертификат
"No tools available"	Модуль MCP отключен или не выбраны инструменты	Повторно включите и выберите хотя бы один инструмент
"Unauthorized"	Недействительный токен	Сгенерируйте новый токен в админке Drupal и обновите его в Mia
Медленные ответы	Экспорт больших сущностей	Отключите неиспользуемые инструменты, включите пагинацию

Связанные материалы

Тот же шаблон MCP работает и с другими CMS-платформами. Ознакомьтесь с нашими сопутствующими руководствами:

Как Mia работает с WordPress: Практическое руководство по настройке — охватывает плагин mcp-adapter, Application Passwords и специфичные для WordPress сценарии использования (медиа, комментарии, действия плагинов, запросы REST API).
Лучший AI-ассистент для Bitrix CMS: Подключите Mia через MCP — охватывает модуль hiweb.site_mcp, аутентификацию поBearer token, транспорт JSON POST и специфичные для Bitrix сценарии использования (инфоблоки, заказы, CRM).

Вы можете подключить все три платформы к одному и тому же чату Mia, и она будет обращаться к каждой по имени.

Заключение

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

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