WordPress MCP Gemini : Connecter et Piloter son site avec l’IA (Guide Complet)

L’idée de piloter un site WordPress directement depuis son terminal en discutant simplement avec une Intelligence Artificielle n’est plus de la science-fiction. Grâce à la combinaison WordPress MCP Gemini, vous pouvez transformer votre installation en un « serveur de contexte » et utiliser Gemini CLI pour interagir avec vos contenus en langage naturel.

Mais passer de la théorie à la pratique n’est pas toujours simple. Dans ce guide complet, je vous propose un retour d’expérience concret basé sur mon installation réelle. Nous allons voir comment connecter WordPress à Gemini, mais surtout comment diagnostiquer et résoudre les blocages techniques (erreurs 401, 403, REST API désactivée) que vous pourriez rencontrer en production.

1 — Les outils nécessaires pour WordPress MCP Gemini

Avant de vous lancer dans la ligne de commande, assurez-vous de disposer des éléments suivants :

• Un site WordPress : En production ou en local (via HTTPS).
• Le plugin WordPress MCP : Téléchargez la version v0.2.5 ici.
• Un compte Google : Indispensable pour l’API Gemini.
• Node.js et npm : Pour installer le client localement.
• Gemini CLI : L’interface qui pilotera votre site.
• Un token JWT : À générer dans les réglages du plugin MCP.
• Un accès au .htaccess : Pour corriger d’éventuels blocages de l’API REST.

2 — Comprendre l’architecture du pont IA

Pour réussir à automatiser WordPress avec l’IA, il faut comprendre le flux de données :

• Le Serveur (WordPress) : Il expose ses outils (lecture, création, modification) via des points d’entrée sécurisés.
• Le Client (Gemini CLI) : L’outil sur votre ordinateur qui envoie les requêtes.
• Le Pont (settings.json) : Le fichier local qui contient l’URL du serveur et votre clé d’accès.

Notez bien que le fichier settings.json se trouve sur votre machine de travail, et non sur votre serveur web.

3 — Installation de Gemini CLI

L’installation est rapide via npm. Ouvrez votre terminal (PowerShell ou Terminal) :

npm install -g @google/gemini-cli

Vérifiez ensuite que l’outil est bien reconnu par votre système :

gemini --version

4 — Configuration du fichier settings.json

C’est l’étape cruciale pour connecter WordPress à Gemini. Sur Windows, le fichier doit se trouver ici :

C:\Users\VOTRE_NOM\.gemini\settings.json

Voici la structure de configuration à utiliser :

{
  "mcpServers": {
    "wordpress-mcp": {
      "httpUrl": "https://votresite.com/wp-json/wp/v2/wpmcp/streamable",
      "headers": {
        "Authorization": "Bearer VOTRE_TOKEN_JWT"
      }
    }
  }
}

5 — Diagnostic : Pourquoi la connexion échoue-t-elle ?

Lors de mes tests, j’ai rencontré plusieurs obstacles. Voici comment les identifier :

Symptôme 1 : Commande gemini introuvable

Si vous obtenez l’erreur gemini : Le terme n'est pas reconnu, cela signifie que l’installation globale de npm a échoué ou que votre PATH n’est pas à jour.

Symptôme 2 : Serveur « Disconnected »

Si la commande /mcp list affiche votre serveur mais en mode déconnecté, le client ne parvient pas à joindre l’URL WordPress.

6 — Décoder les erreurs HTTP (401, 403, 404)

Chaque code d’erreur est un indice sur l’origine du blocage :

• 401 Unauthorized : Votre token JWT est invalide ou expiré.
• 403 Forbidden : L’accès est bloqué par un plugin de sécurité ou l’API REST est désactivée.
• 404 Not Found : L’URL du endpoint est incorrecte ou les permaliens sont mal configurés.

7 — Le blocage « rest_disabled » et les résidus de sécurité

J’ai découvert que même après avoir désinstallé des plugins comme Wordfence, certains réglages de sécurité restaient actifs dans la base de données, affichant :

{
  "code": "rest_disabled",
  "message": "REST API disabled.",
  "data": { "status": 403 }
}

C’est un enseignement vital : vérifiez toujours que votre API REST est totalement accessible avant de tenter une connexion MCP WordPress.

8 — Correction indispensable du fichier .htaccess

Si votre API REST renvoie des erreurs 404, il manque probablement les règles de routage dans votre fichier .htaccess. Utilisez cette version complète :

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule .* - [E=HTTP_AUTHORIZATION:%1]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

9 — Tests techniques pour valider WordPress MCP Gemini

Utilisez ce script PowerShell pour simuler une requête IA et valider votre token :

$headers = @{
  "Authorization" = "Bearer VOTRE_TOKEN"
  "Content-Type"  = "application/json"
  "Accept"        = "application/json, text/event-stream"
}
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Invoke-RestMethod -Uri "https://votresite.com/wp-json/wp/v2/wpmcp/streamable" -Method Post -Headers $headers -Body $body

10 — Le résultat final : Un site piloté par l’IA

Une fois les réglages validés, la commande /mcp list doit afficher :

wordpress-mcp - Ready (34 tools, 2 prompts, 5 resources)

Vous pouvez désormais demander à Gemini de lister vos articles, d’en créer de nouveaux ou de modifier vos pages directement en langage naturel.

Conclusion

Mettre en place WordPress MCP Gemini demande un peu de rigueur technique, mais le gain de productivité est immense. La clé du succès réside dans une API REST WordPress parfaitement ouverte et sécurisée.