Connecter Claude Code à ellô-wp
Une fois un site connecté à ellô-wp (Installer le plugin ellô-wp Companion), vous pouvez le piloter depuis Claude Code : lire son contenu, modifier des textes, construire des pages Elementor, gérer les médias. Cinq minutes, une seule fois par poste.
Pour claude.ai (web, bureau, mobile) ou ChatGPT, pas de jeton à créer : on colle l'adresse https://mcp.<domaine>/mcp et on autorise l'accès sur l'écran d'ellô-wp. Voir Connecter claude.ai à ellô-wp et Connecter ChatGPT à ellô-wp.
1. Créer un jeton dans le dashboard
- Ouvrez votre espace ellô-wp (
https://app.<domaine>), écran Jetons MCP. - Cliquez Créer un jeton : donnez-lui un nom (« Claude Code », ou le nom de la personne qui l'utilisera), choisissez le ou les sites qu'il pourra atteindre (ou activez Tous mes sites, y compris les futurs : les sites connectés plus tard, où votre compte est relié avec le droit « Utiliser l'IA », seront accessibles sans nouveau jeton), et si besoin activez Lecture seule (aucune écriture possible, ni directe ni en brouillon).
- Le jeton s'affiche une seule fois, préfixé
ewp_. Copiez-le tout de suite dans un endroit sûr (gestionnaire de mots de passe) : il ne sera plus jamais montré, seul son tout début reste visible dans la liste par la suite.
Un jeton n'élargit jamais les droits : sur chaque site, il agit avec les droits du rôle WordPress du compte relié à votre compte ellô-wp (section « Utilisateurs et rôles » du site). Une écriture de l'IA part en direct seulement si ce rôle a le droit En direct (publish.live) ; sinon elle part en copie brouillon à relire.
2. Ajouter le serveur dans Claude Code
Dans votre propre terminal (jamais collé dans une conversation avec l'IA), une seule commande :
claude mcp add --transport http ellowp https://mcp.<domaine>/mcp --header "Authorization: Bearer <JETON>"
Remplacez <domaine> par le domaine de votre espace ellô-wp (celui de app.<domaine>, avec mcp. à la place de app.) et <JETON> par le jeton copié à l'étape précédente. Vérifiez ensuite dans Claude Code : claude mcp list doit afficher ellowp connecté.
3. Premiers échanges
Quelques demandes simples pour vérifier que tout fonctionne, avant d'aller plus loin :
- « Liste mes sites ellô-wp. »
- « Donne-moi la vue d'ensemble du site <nom du site>. » (
get_site_overview: versions, Elementor Free ou Pro, dernières écritures, avertissements éventuels) - « Sur <site>, montre-moi le texte du titre de la page d'accueil. »
- « Sur <site>, corrige la faute dans le paragraphe d'introduction de la page <page> : "..." → "...". »
Ensuite, des demandes plus construites : « Sur <site>, construis une page "Contact" avec un titre, un texte court et le formulaire existant », ou « Modifie le Mega Menu pour ajouter une entrée "Tarifs" ».
4. Brouillons, aperçus et mise en ligne
- Écriture en direct : si votre rôle a le droit
publish.live, la plupart des écritures de l'IA sont visibles immédiatement sur le site, avec une révision WordPress créée automatiquement (restaurable à tout moment). - Copie brouillon : sans ce droit, ou pour un modèle global (en-tête, pied de page, popup, kit — toujours en brouillon quel que soit le rôle, par sécurité), l'IA écrit dans une copie invisible des visiteurs. La réponse de l'outil inclut un lien d'aperçu (
preview_url), valable 30 minutes, à ouvrir tel quel dans un navigateur : il montre exactement le brouillon, sans connexion nécessaire. - Mettre en ligne un brouillon : une fois l'aperçu validé, demandez « Mets en ligne ce brouillon » (outil
promote_draft). Le contenu original est remplacé par la version brouillon, en une seule révision. - Revenir en arrière : « Restaure la version d'avant sur <page> » (
restore_revision), ou consultez l'historique WordPress habituel de la page.
5. Erreurs courantes
L'IA reçoit un code d'erreur stable et une piste de solution à chaque refus ; ceux qui reviennent le plus souvent à la connexion d'un nouveau site :
| Code | Cause | Ce qu'il faut faire |
|---|---|---|
right_missing |
Le rôle WordPress lié à votre compte n'a pas le droit nécessaire sur ce site (par exemple text.edit pour modifier un texte, elementor.structure pour construire une page). |
Ouvrez le dashboard, écran Rôles du site, et ajoutez le droit au rôle concerné (ou reliez votre compte à un rôle qui l'a déjà). |
revision_conflict |
Le contenu a changé depuis la dernière lecture (une autre personne, l'éditeur en direct, ou une précédente demande à l'IA). | Redemandez le contenu (« relis cette page ») puis réessayez la modification : l'IA relit automatiquement dans la plupart des cas et réapplique la demande. |
site_blocked_by_firewall |
Le site est derrière Cloudflare (ou un pare-feu équivalent) et a bloqué la requête signée avant qu'elle n'atteigne le plugin. | Dans Cloudflare, ajoutez une règle WAF « Skip » pour l'IP du serveur ellô-wp sur les routes /ellowp/v1/ (adresse IP et marche à suivre détaillée sur demande à contact@ello-wp.com) ; sans cette règle, aucune lecture ni écriture ne passera sur ce site. |
site_blocked_by_firewall, message « Pare-feu de l'hébergeur » |
Le pare-feu de l'hébergeur (ModSecurity, Imunify360…) a bloqué la requête avant WordPress : il a pris son contenu (HTML d'un modèle d'e-mail de formulaire, code…) pour une attaque. Seules certaines écritures échouent. | Mettez à jour l'extension ellô-wp (1.0.6 ou plus : les écritures sont encodées et le pare-feu ne voit plus le HTML). Si le message dit « même encodée », faites ajouter par l'hébergeur une exclusion ciblée pour le serveur ellô-wp sur ?rest_route=/ellowp/v1/ (marche à suivre sur demande à contact@ello-wp.com) ; en attendant, modifiez la page dans Elementor. |
D'autres codes existent (capability_missing pour une fonction Pro absente, site_suspended, validation_failed…) : chacun revient avec une explication en français et, quand c'est possible, une alternative directement utilisable.
Modifier ou révoquer un jeton
Dashboard, écran Jetons MCP : bouton Modifier en face du jeton pour changer ses sites (ou « Tous mes sites, y compris les futurs ») et la lecture seule. Le jeton garde la même valeur : rien à recoller dans Claude Code, le changement s'applique à sa prochaine utilisation. Seule la personne qui a créé le jeton peut le modifier.
Bouton Révoquer en face du jeton concerné. Effet immédiat ; à faire dès qu'une personne quitte l'équipe ou qu'un poste est compromis. Dans Claude Code, retirer le serveur devenu inutile : claude mcp remove ellowp.