Meilleur compagnon IA pour le CMS Bitrix — Guide de configuration MCP

Meilleur compagnon IA pour le CMS Bitrix : connectez Mia via MCP

Bitrix Site Manager fait fonctionner des millions de sites d’entreprise dans le monde — et avec le Model Context Protocol (MCP), il parle désormais directement à Mia, votre secrétaire IA personnelle. Dans ce guide, nous allons passer en revue toute la configuration : de l’installation du module MCP officiel à sa connexion avec votre conversation Mia.

Une fois connecté, vous pouvez demander à Mia de gérer les actualités, les iblocks, les utilisateurs, les commandes, et bien plus — le tout depuis une seule conversation Telegram. Pas d’onglets de navigateur, pas de panneaux d’administration, pas de changement de contexte.

Qu’est-ce que le MCP et pourquoi s’en soucier ?

Le Model Context Protocol est une norme ouverte qui permet aux agents IA de communiquer avec des services externes via une interface structurée et sécurisée.

Un serveur MCP expose les capacités d’un système. Un client MCP (Mia) se connecte à ce serveur et invoque ces capacités en votre nom.

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

Demander à Mia de publier des articles d’actualité ou de mettre à jour des entrées d’iblock
Rechercher des commandes, des clients ou des produits selon des critères
Générer des rapports sur les ventes, le trafic ou la performance du contenu
Créer des utilisateurs, attribuer des rôles ou gérer les permissions
Consulter des analyses ou extraire des indicateurs de performance

Le tout depuis un seul chat Telegram.

Prérequis

Avant de commencer, assurez-vous de disposer de :

Un site 1C-Bitrix (licencié, avec l’installation des modules activée)
Un accès administrateur pour installer des modules et configurer les paramètres
Un compte Mia Handles avec au moins un forfait Standard (les connexions MCP nécessitent un accès API)
Un certificat SSL sur votre site Bitrix (HTTPS est requis pour l’endpoint MCP)

Étape 1 — Installer le module hiweb.site_mcp

Le module recommandé est hiweb.site_mcp depuis le Bitrix Marketplace. Il fournit l’implémentation officielle du serveur MCP pour Bitrix.

Lien du Marketplace : https://marketplace.1c-bitrix.ru/hiweb.site_mcp

Note : la page du marketplace est actuellement en construction, mais sera publiée prochainement. Si vous avez déjà le module, passez à l’étape 2.

Depuis votre panneau d’administration Bitrix :

Allez dans Paramètres → Marketplace
Recherchez hiweb.site_mcp ou utilisez le lien direct ci-dessus
Installez et activez le module
Après activation, accédez à Paramètres → Paramètres du site → Serveur MCP

Vous y trouverez :

URL de l’endpoint — l’URL publique de l’endpoint MCP (typiquement https://yoursite.com/api/mcp/)
Authentification — configuration du token bearer
Outils à exposer — activer les capacités Bitrix auxquelles Mia peut accéder (iblocks, actualités, utilisateurs, commandes, analyses, etc.)

Étape 2 — Générer un token Bearer

Le module Bitrix MCP utilise l’authentification Bearer token pour un accès API sécurisé.

Allez dans Paramètres → Paramètres du site → Serveur MCP
Cliquez sur Generate Token ou Create New Token
Donnez-lui un nom, par exemple Mia MCP Integration
Définissez l’expiration du token (recommandé : aucune expiration pour une utilisation en production)
Copiez le token généré — vous ne le verrez qu’une seule fois

Ce token devient l’identifiant que Mia utilise pour se connecter à votre site Bitrix.

Étape 3 — Exposer l’endpoint de manière sécurisée

L’endpoint MCP ne doit être accessible qu’aux services que vous confiez. Options typiques :

Authentification par bearer token — chaque requête doit inclure l’en-tête Authorization avec le bearer token
Liste blanche IP — restreindre le chemin MCP à la plage d’IP du backend de Mia
Réseau privé / VPC — pour les configurations entreprise

Si votre site Bitrix est derrière Cloudflare ou un autre WAF, assurez-vous que le chemin MCP est autorisé via les méthodes POST. Testez d’abord l’endpoint avec curl (voir l’étape 5) avant de connecter Mia.

Étape 4 — Connecter le serveur Bitrix dans Mia Handles

Maintenant, la partie intéressante. Dans votre chat Mia :

Ouvrez la miniapp Mia (touchez votre photo de profil ou utilisez le menu)
Allez dans Paramètres → Outils → Serveurs MCP → Ajouter (ou modifiez un serveur existant)
Renseignez le formulaire de connexion :

Server name:   My Bitrix Site
Endpoint URL:  https://example.com/hiweb-site-mcp/
Transport:     JSON POST (stateless)
Auth:          Bearer token
Token:         (collez le bearer token généré)

Important : sélectionnez JSON POST (stateless) comme type de transport. N’utilisez PAS Streamable HTTP ou SSE — le module Bitrix MCP n’accepte que des requêtes POST JSON-RPC.

Appuyez sur Connect. Mia validera l’endpoint, listera les outils disponibles et ajoutera le serveur à votre chat.

Étape 5 — Tester la connexion

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

"Lister les 5 dernières actualités sur mon site Bitrix"

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

La validité et l’expiration du bearer token
Le fait que le module MCP est actif et que les outils sont activés
L’URL de l’endpoint est accessible depuis le backend de Mia (pare-feu, certificat SSL)
Le type de transport est réglé sur JSON POST (stateless)

Vous pouvez aussi tester manuellement avec 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/"

Vous devriez obtenir une liste d’outils JSON en retour — cela signifie que le serveur est bien en vie.

Étape 6 — Ce que vous pouvez faire après la configuration

Une fois connecté, Mia devient votre copilote pour Bitrix. Voici les actions les plus courantes que vous pouvez effectuer :

Opérations sur le contenu — créer, mettre à jour ou publier des articles d’actualité et des entrées d’iblock
Gestion des médias — lister, téléverser ou remplacer des images dans les fichiers
Gestion des utilisateurs — créer des comptes, réinitialiser les mots de passe, attribuer des rôles
Commandes & CRM — interroger les commandes, clients, transactions ou prospects
Analytique — récupérer des rapports de trafic, des métriques de conversion ou des résumés de ventes
Publication planifiée — mettre le contenu en file pour des dates futures via le calendrier de Mia

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

"Créer un article d’actualité sur le lancement du produit que je t’ai envoyé, le programmer pour mercredi à 14:00, et ajouter une tâche pour que l’équipe marketing le revoie."

Mia fera les trois en une seule fois.

Dépannage

Symptôme	Cause probable	Solution
"La connexion a échoué"	Endpoint bloqué ou URL incorrecte	Vérifiez les règles de pare-feu et le certificat SSL
"Aucun outil disponible"	Module désactivé ou aucun outil sélectionné	Réactivez et sélectionnez au moins un outil
"Non autorisé"	Bearer token invalide	Régénérez-le dans les paramètres MCP et mettez-le à jour dans Mia
"HTTP 404"	Chemin d’endpoint incorrect	Vérifiez l’URL de l’endpoint configurée dans le module
"Erreur de transport"	Type de transport incorrect	Utilisez JSON POST (stateless), pas SSE ni Streamable
Réponses lentes	Trop d’outils activés	Désactivez les outils inutilisés, activez la pagination

WordPress et Drupal fonctionnent de la même façon

Si vous gérez aussi un site WordPress ou Drupal, le même schéma s’applique. Chaque CMS possède son propre adaptateur MCP, mais le workflow de connexion dans Mia est identique : installer le module, exposer un endpoint, coller les identifiants dans Mia. Vous pouvez même connecter les trois plateformes au même chat Mia, et elle s’adressera à chacune par son nom.

Pour les autres guides, voir :

Pour conclure

Connecter Bitrix à 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é, ça fonctionne — tranquillement, en arrière-plan, chaque fois que vous en avez besoin.

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