Je suis consultante et formatrice aux méthodes de travail avec l’IA, et l’une des questions qui revient le plus souvent dans mes formations ces derniers mois, c’est celle-ci : « Est-ce qu’on peut vraiment faire travailler Claude directement sur son site WordPress, sans passer par des copier-coller à n’en plus finir ? » La réponse est oui — et c’est précisément ce que permet le protocole MCP. Dans cet article, je vous explique pas à pas comment connecter Claude à WordPress via MCP, en partant de zéro, avec les vraies erreurs à éviter et des exemples concrets de ce que ça change dans la pratique.
MCP et WordPress : de quoi parle-t-on exactement ?
MCP signifie Model Context Protocol. C’est un protocole ouvert — publié par Anthropic — qui permet à Claude d’interagir directement avec des applications externes, dont WordPress. Concrètement, une fois la connexion établie, Claude peut lire vos articles, en créer, les modifier, gérer vos pages, analyser votre contenu éditorial, et bien plus encore, depuis une simple conversation dans Claude Desktop.
Ce n’est pas de la magie : c’est une intégration technique qui crée un pont entre l’IA et votre CMS. L’intérêt principal pour les professionnels qui gèrent un blog ou un site de contenu, c’est de supprimer les allers-retours fastidieux entre l’interface de Claude et l’administration WordPress. Vous travaillez dans un seul espace, en conversation naturelle.
Ce dont vous avez besoin avant de commencer
- Claude Desktop — l’application de bureau (pas la version web). Un plan payant Pro ou Team est requis.
- Node.js installé sur votre ordinateur (voir l’étape 1 ci-dessous).
- Un site WordPress auto-hébergé (WordPress.org) avec accès administrateur. Si vous êtes sur WordPress.com avec un plan payant, l’intégration MCP est disponible nativement depuis le tableau de bord, sans plugin supplémentaire.
- Le plugin wordpress-mcp d’Automattic installé sur votre site.
Installation étape par étape pour connecter Claude à WordPress via MCP
Étape 1 — Installer Node.js
Node.js est nécessaire pour faire tourner le proxy @automattic/mcp-wordpress-remote, le programme qui fait le pont entre Claude Desktop sur votre ordinateur et votre site WordPress distant.
Pour vérifier si Node.js est déjà installé, ouvrez un terminal (ou PowerShell sur Windows) et tapez :
node -v
npm -v
npx -vSi vous obtenez des numéros de version, passez directement à l’étape 2. Sinon, rendez-vous sur nodejs.org, téléchargez la version LTS (la stable recommandée, actuellement v22.x), lancez l’installeur et vérifiez avec node -v dans un nouveau terminal.
⚠️ Si vous utilisez nvm (Node Version Manager) :
npxpeut utiliser par défaut une version ancienne plutôt que celle configurée. Ce bug est l’une des causes principales de déconnexion MCP. Pour éviter ce problème, installez Node.js directement depuis nodejs.org, sans passer par nvm.
Étape 2 — Installer le plugin WordPress MCP
Vous devez installer le plugin wordpress-mcp sur votre site et activer la fonctionnalité MCP dans les réglages.
- Téléchargez le plugin officiel depuis le dépôt GitHub d’Automattic.
- Dans votre admin WordPress : Extensions → Ajouter → Téléverser une extension.
- Uploadez le fichier ZIP et activez le plugin.
- Allez dans Réglages → MCP Settings et activez les fonctionnalités MCP.
Étape 3 — Générer un token JWT
Le token JWT est le « mot de passe sécurisé » qui permet à Claude de s’authentifier sur votre site sans exposer vos identifiants habituels.
- Dans votre admin WordPress, allez dans Réglages → MCP Settings.
- Cherchez la section de génération de token JWT.
- Générez un token et copiez-le immédiatement — il ne sera affiché qu’une seule fois.
Préférez des tokens à courte durée de vie (1 à 24 heures). Traitez-les comme des mots de passe : ne les partagez jamais et ne les mettez pas dans un fichier public.
💡 Alternative au JWT : vous pouvez aussi utiliser un mot de passe d’application WordPress (plus simple à gérer). Rendez-vous dans Utilisateurs → Votre profil → Mots de passe d’application, générez-en un, et utilisez
WP_API_USERNAME+WP_API_PASSWORDdans la configuration (voir la section alternative plus bas).
Étape 4 — Configurer Claude Desktop
Claude Desktop se configure via un fichier JSON. Accédez-y depuis l’application :
- Mac : Menu Claude → Paramètres → Developer → Edit Config
- Windows :
%APPDATA%\Claude\claude_desktop_config.json
Voici la configuration correcte à copier-coller :
{
"mcpServers": {
"wordpress-mcp": {
"command": "npx",
"args": [ "-y", "@automattic/mcp-wordpress-remote@latest" ],
"env": {
"WP_API_URL": "https://votre-site.fr",
"JWT_TOKEN": "votre-vrai-token-jwt-ici"
}
}
}
}Remplacez https://votre-site.fr par l’URL de votre site et votre-vrai-token-jwt-ici par le token copié à l’étape précédente.
Étape 5 — Vérifier que ça fonctionne
Après avoir sauvegardé le fichier et complètement relancé Claude Desktop (sur Mac : Cmd+Q pour quitter, pas juste fermer la fenêtre), le serveur wordpress-mcp doit apparaître dans les connecteurs avec un point vert. Testez avec cette question simple :
« Liste-moi les 5 derniers articles publiés sur mon site WordPress. »
Claude doit utiliser automatiquement les outils MCP et afficher vos articles avec leurs dates et statuts. Si c’est le cas, la connexion est opérationnelle.
Ce que vous pouvez faire concrètement une fois connecté
C’est souvent la question qui fait basculer les gens : « Oui, mais concrètement, ça sert à quoi ? » Voici quelques exemples d’usages que j’observe régulièrement — et qui font gagner un temps considérable.
📝 Rédiger et publier un article sans quitter Claude
Vous pouvez dicter à Claude le sujet, le plan et le ton souhaité, puis lui demander de rédiger l’article et de le publier directement sur WordPress — avec le titre, le slug, les catégories et les tags. Plus aucun copier-coller entre votre espace de rédaction et votre CMS. Claude rédige, structure et publie en une seule conversation.
🔍 Auditer son contenu éditorial existant
Demandez à Claude d’analyser vos 20 derniers articles : longueur moyenne, régularité de publication, sujets couverts, articles sans excerpt ou sans catégorie. En quelques secondes, vous avez une vue d’ensemble de votre blog que vous n’aviez peut-être jamais prise le temps de faire. Utile pour préparer une stratégie de contenu ou identifier des articles à mettre à jour.
✏️ Mettre à jour plusieurs articles en série
Vous avez changé le nom d’un outil, d’une offre ou d’une méthode que vous mentionnez dans 10 articles différents ? Claude peut les identifier, lire le contenu de chacun et les mettre à jour sans que vous ayez à ouvrir chaque article manuellement dans l’éditeur. Un gain de temps massif sur les tâches de maintenance éditoriale.
🗂️ Réorganiser les catégories et tags de vos publications
Si votre taxonomie s’est développée de manière organique au fil des années et manque de cohérence, Claude peut lister toutes vos catégories et tags, identifier les doublons ou les catégories sous-utilisées, et vous aider à réorganiser la classification de vos articles selon une logique que vous définissez ensemble.
📊 Préparer un rapport de publication mensuel
En fin de mois, demandez à Claude de compiler les articles publiés sur la période, leur statut, leur catégorie et leur date. Il peut vous produire un récapitulatif structuré que vous n’auriez autrement obtenu qu’en parcourant manuellement votre liste d’articles ou en exportant des données.
Les erreurs fréquentes — et comment les corriger
La connexion MCP WordPress est simple en théorie, mais quelques pièges récurrents font perdre beaucoup de temps. Les voici, avec leurs solutions.
❌ Erreur 1 — Laisser les valeurs placeholder dans la configuration (la plus courante)
La documentation officielle fournit un exemple de configuration avec des valeurs de démonstration. Le piège classique : copier-coller ce JSON sans remplacer toutes les valeurs. Résultat — une déconnexion immédiate sans message d’erreur clair.
Deux problèmes fréquents dans la config d’exemple :
"JWT_TOKEN": "your-jwt-token-here"— le texte your-jwt-token-here est un placeholder, pas un vrai token. Claude tente de s’authentifier avec une chaîne invalide et le serveur refuse la connexion."LOG_FILE": "optional-path-to-log-file"— ce chemin n’existe pas sur votre système. Sans correction, Claude génère une erreur qui provoque la déconnexion.
La solution : supprimez la ligne LOG_FILE et remplacez le token par votre vrai token. Si vous souhaitez garder les logs, spécifiez un chemin réel : /tmp/wordpress-mcp.log sur Mac/Linux, ou C:\Users\VotreNom\wordpress-mcp.log sur Windows.
❌ Erreur 2 — « Server disconnected » lié à nvm
Si vous avez nvm installé, la commande npx peut résoudre vers une version ancienne de Node.js plutôt que celle active. Pour contourner ce problème, trouvez le chemin complet de votre binaire npx avec la commande which npx dans le terminal, puis remplacez "command": "npx" dans votre config par ce chemin complet :
"command": "/Users/votrenom/.nvm/versions/node/v22.16.0/bin/npx"❌ Erreur 3 — L’API WordPress renvoie du HTML au lieu de JSON
Si vous voyez l’erreur Unexpected token < in JSON at position 0, c’est que le proxy reçoit une page HTML ordinaire à la place d’une réponse JSON — souvent un problème de permaliens ou d’URL incorrecte.
Vérifiez en ouvrant dans un navigateur : https://votre-site.fr/wp-json/wp/v2/posts. Vous devez voir du JSON brut. Si vous voyez votre page d’accueil WordPress, allez dans Réglages → Permaliens et enregistrez (même sans modifier) pour régénérer les règles de réécriture.
❌ Erreur 4 — Le plugin est absent ou inactif côté WordPress
Si la configuration Claude est correcte mais que rien ne fonctionne, vérifiez que le plugin wordpress-mcp est bien actif dans votre liste d’extensions et que la fonctionnalité MCP est activée dans Réglages → MCP Settings. Sans le plugin actif, le proxy n’a aucun endpoint à contacter et se déconnecte immédiatement.
❌ Erreur 5 — Ne pas avoir relancé Claude après la modification de la config
Claude Desktop ne relit les configurations MCP qu’au démarrage. Après avoir sauvegardé le fichier JSON, vous devez quitter complètement l’application et la relancer. Sur Mac, fermer la fenêtre ne suffit pas : utilisez Cmd+Q pour quitter.
Configuration alternative : mot de passe d’application (sans JWT)
Si vous préférez éviter la gestion des tokens JWT, vous pouvez utiliser un mot de passe d’application WordPress pour une authentification basique. Cette option est souvent plus simple à maintenir sur le long terme.
{
"mcpServers": {
"wordpress-mcp": {
"command": "npx",
"args": [ "-y", "@automattic/mcp-wordpress-remote@latest" ],
"env": {
"WP_API_URL": "https://votre-site.fr",
"WP_API_USERNAME": "votre-identifiant",
"WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
"OAUTH_ENABLED": "false"
}
}
}
}Le mot de passe d’application se génère dans Utilisateurs → Votre profil → Mots de passe d’application. Conservez les espaces entre les groupes de caractères — ils font partie du mot de passe.
Un mot sur la sécurité
Je recommande de créer un utilisateur WordPress dédié avec le rôle Éditeur pour Claude. Il aura accès aux articles et pages sans toucher aux réglages critiques du site. C’est une bonne pratique de sécurité qui limite la surface d’exposition en cas de problème.
À noter : Claude opère sous les mêmes contraintes de permissions que l’utilisateur WordPress configuré. Un éditeur ne pourra pas supprimer des plugins ni modifier les réglages critiques du site, même si vous le lui demandez explicitement. C’est un filet de sécurité bienvenu.
Récapitulatif — checklist avant de tester la connexion
| Élément | À vérifier |
|---|---|
| Node.js | node -v retourne v18 ou supérieur |
| Plugin WordPress | Actif dans Extensions, MCP activé dans Réglages |
| JWT Token | Token réel généré depuis WordPress, pas le placeholder |
| LOG_FILE | Ligne supprimée ou remplacée par un vrai chemin |
| URL du site | Répond du JSON sur /wp-json/wp/v2/posts |
| Claude Desktop | Complètement relancé après modification de la config |
Ce que ça change vraiment dans la pratique
Connecter Claude à WordPress via MCP, c’est franchir un cap dans la façon de travailler avec l’IA. On passe d’un outil de génération de texte qu’on copie-colle à un assistant qui opère directement dans son environnement de travail. La connexion MCP n’est pas réservée aux développeurs : avec ce guide, n’importe quel professionnel qui gère un site WordPress peut la mettre en place en moins d’une heure.
Les prérequis sont simples : Claude Desktop avec un plan payant, Node.js installé, et le plugin Automattic activé sur votre site. La configuration se fait en modifiant un seul fichier JSON. Les erreurs les plus fréquentes — token placeholder non remplacé, ligne LOG_FILE laissée telle quelle, application non relancée — sont toutes évitables avec un peu d’attention. Une fois la connexion établie, les usages sont nombreux : rédaction et publication directes, audit de contenu, mise à jour en série, réorganisation taxonomique. C’est un investissement de mise en place qui se rentabilise très vite sur les tâches répétitives de gestion éditoriale.