Connecter Claude à WordPress via MCP : guide complet

Connecter Claude à WordPress via MCP : installation et configuration complètes

Vous avez besoin d’un abonnement Claude Pro (20 $/mois), de Claude Desktop et du plugin WordPress MCP officiel. Le Model Context Protocol (MCP) est un standard ouvert créé par Anthropic pour connecter Claude à des applications externes. La configuration passe par un fichier JSON à modifier dans Claude Desktop. Une fois activé, vous pouvez créer des articles, modifier des pages et gérer vos médias directement depuis Claude.

Qu’est-ce que le Model Context Protocol pour WordPress

Le Model Context Protocol, ou MCP, est un standard technique publié par Anthropic qui permet à Claude de se connecter à des outils extérieurs. En clair, au lieu de simplement discuter avec Claude dans une interface de chat, vous lui donnez accès à votre site WordPress pour qu’il puisse lire, créer et modifier du contenu directement.

MCP agit comme un pont. D’un côté, Claude Desktop fait tourner un serveur MCP local. De l’autre, votre site WordPress expose ses données via une API REST. Le plugin WordPress MCP installé sur votre site fait le lien entre les deux.

Prenons un exemple concret. Vous tapez dans Claude : « Crée un article de 800 mots sur le référencement local, avec le titre ‘SEO local en 2026’, en brouillon. » Claude va directement créer cet article dans votre WordPress, avec le bon titre, le bon statut et le bon contenu. Aucun copier-coller nécessaire, aucun aller-retour entre les interfaces.

C’est l’intégration qui change vraiment la façon de gérer un site web au quotidien.

Comment MCP communique avec votre WordPress

Le serveur MCP tourne localement via Node.js. Il traduit les instructions de Claude en appels API REST vers votre site WordPress. Chaque action (lire des articles, publier du contenu, modifier une page) passe par ce serveur intermédiaire.

Ce qui distingue cette approche des plugins classiques

Les plugins classiques ajoutent des fonctionnalités à votre interface admin WordPress. Le plugin WordPress MCP, lui, rend votre site accessible depuis l’extérieur, via Claude. C’est une direction inverse qui ouvre des possibilités d’automatisation inédites. Pour aller plus loin sur les usages possibles de ce protocole, notre article sur Claude MCP détaille les intégrations disponibles avec d’autres plateformes.

Les prérequis avant de commencer

Avant d’installer quoi que ce soit, vérifiez que vous avez bien tous ces éléments en place.

• Un site WordPress avec accès administrateur (WordPress 6.0 minimum)
• Un abonnement Claude Pro ou Team (à partir de 20 $/mois) avec accès à Claude Desktop
• Claude Desktop installé sur votre machine (Mac ou Windows), version mai 2026 ou plus récente
• Le plugin WordPress MCP (disponible sur le répertoire officiel wordpress.org ou sur le GitHub d’Automattic)
• Node.js installé sur votre ordinateur, version 18 ou supérieure (vérifiez avec node -v dans votre terminal)

Si vous découvrez Claude et souhaitez comprendre comment l’utiliser en ligne de commande avant de passer à l’intégration WordPress, le guide pour utiliser Claude Code vous donnera les bases nécessaires.

Les versions minimales à respecter

Node 18 est le minimum, mais Node 20 est recommandé pour éviter des bugs de compatibilité. Pour Claude Desktop, vérifiez que votre version date d’après mars 2026, date à laquelle le support MCP a été stabilisé. Côté WordPress, assurez-vous que votre API REST est activée et accessible depuis l’extérieur, sinon aucune connexion ne fonctionnera.

Un point sur les coûts

L’abonnement Claude Pro est nécessaire pour accéder aux fonctionnalités MCP dans Claude Desktop. Le plugin WordPress MCP est gratuit. La seule dépense réelle est donc l’abonnement Anthropic. Si vous hésitez encore sur le choix de votre assistant IA, notre comparatif Claude vs ChatGPT peut vous aider à trancher.

Installation du plugin WordPress MCP en 3 étapes

Étape 1 : installer le plugin sur votre site

Rendez-vous dans votre administration WordPress, section Extensions > Ajouter une extension. Dans la barre de recherche, tapez « WordPress MCP » ou cherchez le plugin publié par Automattic. Vous pouvez aussi télécharger le fichier .zip directement depuis le GitHub officiel d’Automattic (github.com/Automattic/wordpress-mcp) et téléverser l’archive via Extensions > Téléverser une extension. Cliquez sur « Installer maintenant » puis sur « Activer ». Le plugin apparaît ensuite dans votre liste d’extensions actives.

Une fois activé, un menu MCP apparaît dans votre admin WordPress. C’est simple, aucun réglage complexe n’est nécessaire à ce stade.

Étape 2 : générer vos identifiants d’application

C’est l’étape la plus importante pour la sécurité. Allez dans votre profil utilisateur WordPress : cliquez sur votre nom d’utilisateur en haut à droite, puis sur « Modifier le profil ». Faites défiler vers le bas jusqu’à la section « Mots de passe d’application » (Application Passwords).

Dans le champ « Nouveau nom du mot de passe d’application », tapez un nom reconnaissable, par exemple « Claude MCP ». Cliquez sur « Ajouter un nouveau mot de passe d’application ». WordPress génère alors un mot de passe application au format xxxx xxxx xxxx xxxx xxxx xxxx. Copiez-le immédiatement car il ne s’affichera qu’une seule fois. Ce password servira à authentifier Claude sur votre WordPress.

Notez aussi votre nom d’utilisateur (username) administrateur, vous en avez besoin pour la config JSON.

Étape 3 : tester la connexion basique

Avant de configurer Claude Desktop, vérifiez que votre API REST fonctionne. Ouvrez un navigateur et allez sur https://votresite.com/wp-json/wp/v2/posts. Si vous voyez une liste JSON de vos articles, votre API est bien accessible. Si vous obtenez une erreur 401 ou 403, vérifiez que votre hébergeur ne bloque pas l’API REST et que l’authentification par mot de passe application est activée dans votre WordPress.

Configuration de Claude Desktop avec le fichier JSON

Où trouver le fichier de configuration

Le fichier de configuration de Claude Desktop s’appelle claude_desktop_config.json. Son emplacement varie selon votre système :

• Sur Mac : ~/Library/Application Support/Claude/claude_desktop_config.json
• Sur Windows : %APPDATA%\Claude\claude_desktop_config.json

Ouvrez ce fichier avec un éditeur de texte (VS Code, Notepad++, TextEdit). S’il n’existe pas encore, créez-le manuellement dans le bon dossier.

Le fichier config JSON complet à utiliser

Voici le fichier de configuration à copier et adapter. Remplacez les valeurs entre guillemets par les vôtres :

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": [
        "-y",
        "@automattic/mcp-server-wordpress",
        "--latest"
      ],
      "env": {
        "API_URL": "https://votresite.com/wp-json",
        "API_USERNAME": "votre_username_admin",
        "API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

La commande npx est utilisée pour lancer le serveur MCP via Node. Le paramètre @automattic/mcp-server-wordpress pointe vers le package officiel. Les valeurs API_URL, API_USERNAME et API_PASSWORD sont les trois paramètres à remplacer avec vos propres informations. L’URL doit correspondre à l’adresse HTTPS de votre site, sans slash final. Pour API_USERNAME, utilisez votre identifiant d’administration WordPress, pas votre adresse e-mail. Pour API_PASSWORD, collez le mot de passe application généré à l’étape précédente.

Les erreurs courantes à ce stade

Si Claude Desktop ne détecte pas le serveur MCP après avoir sauvegardé le fichier, quitter et relancer l’application complètement règle le problème dans 80 % des cas. Vérifiez aussi que la commande npx fonctionne dans votre terminal avant de relancer.

Un mauvais fichier JSON (virgule oubliée, guillemet manquant) bloque toute la configuration. Utilisez un validateur JSON en ligne pour vérifier votre fichier si quelque chose ne fonctionne pas.

Le fichier desktop_config doit être sauvegardé avant de relancer Claude. Si la section mcpServers n’apparaît pas dans les réglages avancés de Claude Desktop, c’est souvent un problème de chemin de fichier.

Ce que vous pouvez faire une fois connecté

Une fois la connexion établie, les outils WordPress sont accessibles directement dans l’interface de Claude. Voici les actions concrètes que vous pouvez réaliser via MCP :

• Créer des articles ou des pages : « Crée un article intitulé ‘Guide du jardinage en mai’, 600 mots, catégorie Jardinage, statut brouillon »
• Modifier une page existante : « Mets à jour la page d’accueil en remplaçant le texte d’introduction par… »
• Gérer les médias : lister les fichiers uploadés, demander des informations sur une image existante
• Auditer le contenu de vos articles : « Liste les 10 derniers articles publiés avec leur titre et leur nombre de mots »
• Gérer les commentaires : approuver, supprimer ou répondre à des commentaires en attente

Pour formuler des instructions précises à Claude, maîtriser l’art du prompt engineer vous permettra d’obtenir des résultats plus fiables et cohérents dès la première demande.

Les permissions nécessaires dans WordPress

Pour que toutes ces actions fonctionnent, votre utilisateur WordPress doit avoir le rôle administrateur ou éditeur. Un rôle auteur ne donnera accès qu’à la création et modification de ses propres articles. Les pages, quant à elles, ne sont accessibles qu’à partir du rôle éditeur. Claude peut faire une demande qui dépasse les droits de l’utilisateur configuré et recevoir une erreur 403 en réponse, sans que ce soit un bug du plugin.

Les limites à connaître

La gestion des custom fields complexes (ACF avancé, blocs Gutenberg imbriqués) reste perfectible. La gestion des métadonnées non standard est limitée dans la version actuelle du plugin (mai 2026). Pour la publication d’articles avec des relations de taxonomies personnalisées, une vérification manuelle reste nécessaire après création.

Dépannage et résolution des erreurs fréquentes

Ce tableau résume les problèmes les plus fréquents avec leur cause et leur solution :

Problèmes de connexion liés à l’hébergement

Certains hébergeurs mutualisés bloquent les mots de passe d’application WordPress par défaut. Si votre connexion échoue systématiquement, rendez-vous dans votre admin WordPress sous Réglages > Général et vérifiez que l’API REST est bien accessible depuis l’extérieur. Le serveur MCP a besoin d’un accès HTTP sortant sans restriction du côté hébergeur.

Pour les questions plus techniques, le GitHub officiel du projet (github.com/Automattic/wordpress-mcp) contient les issues résolues et un Discord communautaire actif. La documentation mise à jour en avril 2026 couvre les cas limites les plus courants.

Cas d’usage et gain de temps réel

Le rédacteur qui gère un blog à 50 articles par mois

Imaginez un rédacteur web qui doit créer des articles WordPress chaque semaine. Sans MCP, le travail passe par l’éditeur WordPress, le copier-coller depuis son éditeur de texte, la configuration manuelle des catégories. Avec Claude WordPress MCP, il demande directement : « Crée 5 articles en brouillon sur les sujets suivants, avec ce plan type… » Claude crée chaque article automatiquement dans WordPress. Le gain de temps estimé : 30 à 45 minutes par lot de 5 articles.

L’audit de contenu en une seule requête

Un gestionnaire de site souhaitant auditer les 10 derniers articles WordPress pour vérifier les titres, les longueurs et les catégories doit normalement aller dans chaque article un par un. Via MCP, une seule demande suffit : « Liste mes 10 derniers articles avec leur titre, leur nombre de mots et leurs catégories. » Claude retourne la liste complète en quelques secondes. Pour 10 articles, c’est 15 à 20 minutes économisées sur un audit hebdomadaire.

La mise à jour de contenu existant à grande échelle

Modifier des pages de votre site WordPress pour mettre à jour des informations (prix, dates, contacts) se fait normalement page par page. Claude peut lire le contenu d’une page existante et proposer une version modifiée que vous validez avant publication. C’est particulièrement utile pour les sites comportant des dizaines de pages statiques.

La limite connue reste la gestion des blocs Gutenberg complexes. Claude est efficace sur le contenu texte classique. Les layouts visuels avancés demandent encore une intervention manuelle directe dans votre WordPress.

Questions

 fréquentes sur Claude WordPress MCP

Claude Desktop WordPress est-il compatible avec tous les hébergements ?

Claude Desktop WordPress via MCP fonctionne avec la grande majorité des hébergements, à condition que l’API REST de votre site soit accessible depuis l’extérieur. Les hébergements mutualisés avec pare-feu restrictif peuvent poser problème. Un hébergement VPS ou dédié est généralement sans souci. Vérifiez toujours en accédant à votre-site.com/wp-json/wp/v2/posts depuis un navigateur avant de configurer quoi que ce soit.

Le plugin WordPress MCP est-il gratuit ?

Le plugin WordPress MCP développé par Automattic est entièrement gratuit et open source. Il est disponible sur le répertoire officiel wordpress.org. La seule dépense obligatoire est l’abonnement Claude Pro à 20 $/mois pour accéder aux fonctionnalités MCP dans Claude Desktop. Aucun coût supplémentaire n’est nécessaire côté plugin.

Peut-on connecter Claude à plusieurs sites WordPress simultanément ?

Oui. Il vous suffit d’ajouter plusieurs entrées dans la section mcpServers de votre fichier de configuration JSON, avec un nom différent pour chaque site. Chaque entrée possède ses propres valeurs d’API_URL, API_USERNAME et API_PASSWORD. Claude Desktop charge toutes les connexions au démarrage et vous pouvez spécifier quel site WordPress cibler dans chaque requête.

Est-ce sécurisé de mettre son mot de passe WordPress dans un fichier JSON ?

Le fichier claude_desktop_config.json est stocké localement sur votre machine et n’est pas transmis à Anthropic. Le risque réel est un accès non autorisé à votre ordinateur. Pour limiter l’exposition, utilisez impérativement un mot de passe application dédié (et non votre vrai mot de passe administrateur). Si vous supprimez ce password depuis votre profil WordPress, l’accès est immédiatement révoqué sans impact sur votre compte principal.

Quelle version de Node.js est nécessaire pour MCP WordPress ?

Node.js 18 est la version minimale requise pour faire tourner le serveur MCP via npx. La version 20 (LTS) est recommandée pour la stabilité. Vérifiez votre version avec la commande node -v dans votre terminal. Si votre version est inférieure à 18, téléchargez la dernière version LTS sur nodejs.org avant de lancer la configuration.