Back to blog

Comment Mia fonctionne avec Drupal : Guide de configuration pratique

fr • 7/7/2026

Un guide étape par étape pour connecter Drupal à Mia via le serveur MCP officiel — installez le module, configurez le point de terminaison et laissez votre assistant IA gérer le contenu, les entités et les flux de travail directement depuis le chat.

Comment Mia fonctionne avec Drupal : Guide de configuration pratique

Comment Mia fonctionne avec Drupal : Guide de configuration pratique

Drupal est l'une des plateformes CMS les plus flexibles sur le web — et grâce au Model Context Protocol (MCP), il peut désormais fonctionner main dans la main avec Mia, votre secrétaire IA personnelle. Dans ce guide, nous vous présenterons la configuration complète : de l'installation du module serveur Drupal MCP à sa connexion avec votre chat Mia.

Au final, Mia sera capable de lire, créer, mettre à jour et gérer du contenu Drupal directement depuis votre conversation Telegram — sans tableaux de bord, sans changements de contexte.


Qu'est-ce que MCP et pourquoi devriez-vous vous en soucier ?

Le Model Context Protocol est une norme ouverte (introduite à l'origine par Anthropic et maintenant prise en charge par OpenAI et Google) qui permet aux agents IA de dialoguer avec des services externes via une interface structurée et sécurisée.

Un serveur MCP expose les outils et les données d'un système (Drupal, dans notre cas). Un client MCP (Mia) se connecte à ce serveur et utilise ces outils en votre nom.

Pour les propriétaires de sites Drupal, cela signifie que vous pouvez faire des choses comme :

  • Demander à Mia de créer ou de mettre à jour un article de blog
  • Rechercher des brouillons de contenu non publiés
  • Lister des termes de taxonomie, des utilisateurs ou des vues
  • Déclencher des flux de travail (modération, publication, planification)
  • Récupérer des rapports sur l'état et la santé du site

Le tout depuis un seul chat Telegram.


Prérequis

Avant de commencer, assurez-vous d'avoir :

  • Un site Drupal 10.x ou 11 (PHP 8.1+, configuration Composer standard)
  • Un accès administrateur pour installer des modules
  • Un compte Mia Handles avec au moins un plan Standard (les connexions MCP nécessitent un accès API)
  • Le SDK PHP MCP officiel installé globalement ou disponible via Composer

Étape 1 — Installer le module serveur MCP Drupal

Le module recommandé est mcp_server de Drupal.org — il est construit sur le modelcontextprotocol/php-sdk officiel (collaboration PHP Foundation + Symfony).

Depuis la racine de votre site, exécutez :

composer require drupal/mcp_server

Ensuite, activez-le via Drush ou l'interface utilisateur :

drush en mcp_server -y
drush cr

Alternativement, allez dans Extend → Install new module, téléchargez l'archive et activez.

Après l'activation, naviguez vers Configuration → Web services → MCP Server (/admin/config/services/mcp_server). Vous y trouverez :

  • Endpoint URL — l'URL publique du point de terminaison MCP (généralement https://yoursite.com/mcp)
  • Authentication — Basic auth, token, ou OAuth (recommandé : token)
  • Tools and resources — activez quelles capacités Drupal sont exposées (nœuds, utilisateurs, taxonomie, Views, etc.)

Générez un jeton API sécurisé et enregistrez-le — vous en aurez besoin dans Mia.


Étape 2 — Exposer le point de terminaison de manière sécurisée

Le point de terminaison MCP ne devrait être accessible que par les services que vous approuvez. Options typiques :

  • Liste blanche d'IP — restreindre l'accès à l'IP du backend de Mia
  • Authentification basée sur un jeton — chaque requête doit porter le jeton dans l'en-tête
  • Réseau privé / VPC — pour les configurations d'entreprise

Si votre site Drupal est derrière Cloudflare ou un autre WAF, assurez-vous que le chemin /mcp est autorisé avec les méthodes POST et GET, plus SSE si vous utilisez le streaming.


Étape 3 — Connecter le serveur Drupal dans Mia Handles

Maintenant, la partie amusante. Dans votre chat Mia :

  1. Ouvrez le miniapp Mia (appuyez sur votre photo de profil ou utilisez le menu)
  2. Allez dans Settings → Integrations → Add MCP server
  3. Remplissez le formulaire de connexion :
Server name:   Mon Site Drupal
Endpoint URL:  https://yoursite.com/mcp
Transport:     Streamable HTTP
Auth:          Bearer token
Token:         (collez votre jeton Drupal MCP)
  1. Appuyez sur Connect. Mia validera le point de terminaison, listera les outils disponibles et ajoutera le serveur à votre chat.

Vous pouvez également vous connecter en utilisant un transport SSE ou JSON POST — Mia prend en charge les trois.


Étape 4 — Tester la connexion

Une fois connecté, essayez une commande simple dans votre chat Mia :

"Liste les 5 derniers articles non publiés sur mon site Drupal"

Mia devrait renvoyer un résumé tiré directement de votre site Drupal. Si vous obtenez une erreur, vérifiez :

  • La validité du jeton dans les paramètres MCP de Drupal
  • L'URL du point de terminaison est-elle accessible depuis le backend de Mia (pare-feu, certificat SSL)
  • Les outils requis sont-ils activés côté Drupal

Ce que vous pouvez faire après la configuration

Voici quelques actions que Mia peut gérer pour vous une fois connectée :

  • Opérations de contenu — créer des brouillons, publier/dépublier, modifier en masse des champs
  • Taxonomie et références — ajouter des termes, réorganiser des vocabulaires
  • Gestion des utilisateurs — créer des comptes, réinitialiser des mots de passe, attribuer des rôles
  • Requêtes Views — récupérer des rapports structurés en Markdown ou JSON
  • Déclencheurs de flux de travail — déplacer du contenu à travers les états de modération
  • Publication programmée — mettre en file d'attente des articles pour des dates futures via les tâches ou le calendrier de Mia

Et comme Mia connaît déjà votre calendrier, vos tâches et vos fichiers, elle peut orchestrer le travail Drupal en parallèle du reste de votre journée — par exemple :

"Publie l'interview que j'ai fini d'enregistrer ce matin comme article sur mon site Drupal, et rappelle à l'éditeur de le réviser demain à 10h00."

Mia s'occupera des deux en une seule fois.


Dépannage

Symptôme Cause probable Correction
"Connection failed" Point de terminaison bloqué ou URL incorrecte Vérifier les règles de pare-feu et le certificat SSL
"No tools available" Module MCP désactivé ou aucun outil sélectionné Réactiver et sélectionner au moins un outil
"Unauthorized" Jeton invalide Régénérer le jeton dans l'administration Drupal et le mettre à jour dans Mia
Réponses lentes Exportations d'entités volumineuses Désactiver les outils inutilisés, activer la pagination

Lectures connexes

Le même modèle MCP fonctionne avec d'autres plateformes CMS. Consultez nos guides compagnons :

Vous pouvez connecter les trois plateformes au même chat Mia, et elle s'adressera à chacune par son nom.


Conclusion

Connecter Drupal à Mia via MCP transforme votre CMS d'un tableau de bord autonome en une extension conversationnelle de votre flux de travail quotidien. Une fois configuré, cela fonctionne tout simplement — silencieusement, en arrière-plan, chaque fois que vous en avez besoin.

Si vous avez des questions ou souhaitez de l'aide pour le configurer, demandez simplement à Mia directement dans le chat. Elle connaît déjà le protocole.