3/4. Connecter WordPress et Claude en serveur local

Vue d’ensemble

Cette leçon détaille la troisième méthode annoncée à la leçon précédente : l’extension Novamira, qui permet une connexion locale (ou proxy) entre Claude et WordPress. Contrairement à Copilhost ou OttoKit, cette méthode ne repose pas sur une simple URL à coller : elle demande d’éditer le fichier de configuration claude_desktop_config.json sur son PC.

Novamira remplit en réalité deux fonctions distinctes, qu’il faut bien différencier :

  1. Ajouter de nouvelles capacités (abilities) au site WordPress
  2. Permettre une connexion locale entre Claude et WordPress via un serveur MCP

Fonction 1 : les AI abilities de Novamira

Après installation et activation de l’extension (version gratuite, installation manuelle par téléversement du fichier), un nouveau menu Novamira apparaît dans WordPress. Par défaut, rien n’est activé.

Dans les réglages de l’extension, activer l’option AI abilities ajoute au registre commun des capacités WordPress (le même registre que celui exposé par un serveur MCP côté hébergeur) tous les outils fournis par Novamira. Un message d’avertissement s’affiche à l’activation, déconseillant l’usage en production — cohérent avec le point de vigilance déjà signalé à la leçon 3/3.

Le menu AI abilities de l’extension permet ensuite de consulter la liste des capacités ajoutées.

Point clé : compatibilité avec un serveur MCP hébergé

Ces capacités Novamira, une fois déclarées dans le registre commun, sont automatiquement récupérées par un serveur MCP côté hébergeur (Copilhost, par exemple), via ses outils méta discover_abilities / get_ability / execute_ability (cf. leçon 3/2). Autrement dit, activer les AI abilities de Novamira enrichit un serveur MCP Copilhost déjà connecté, sans connexion locale supplémentaire à faire. Les deux approches se combinent.

Fonction 2 : la connexion locale proprement dite

Voici la procédure pour connecter WordPress à Claude en local via Novamira, indépendamment de la fonction précédente.

Étape 1 — Créer un mot de passe d’application WordPress

Dans un compte WordPress (idéalement un compte dédié, par exemple nommé « Claude »), section Mots de passe d’application : générer un nouveau mot de passe. Ce système, natif à WordPress, sert d’identifiant pour autoriser un outil externe à utiliser l’API du site.

Étape 2 — Récupérer le bloc de configuration JSON

Addendum 19-07-2026 : depuis la version 1.9.1 de Novamira, une méthode plus simple existe pour Claude Desktop et Claude.ai — la connexion par OAuth, sans mot de passe d’application ni fichier JSON à toucher. Dans WordPress, Novamira > Configuration fournit l’URL https://[site]/wp-json/mcp/novamira-oauth ; il suffit de la coller dans Claude (Réglages > Connecteurs > Ajouter un connecteur personnalisé) et d’autoriser depuis son propre login WordPress dans le navigateur — exactement comme pour Copilhost ou OttoKit. Les étapes 2 à 6 ci-dessous (récupération du JSON, Node.js, éditeur de code, fusion manuelle, redémarrage) ne sont donc plus le chemin par défaut : elles restent valables uniquement pour la méthode alternative par mot de passe d’application (utile si le client IA ne supporte pas OAuth), et le « bundle .mcp en un clic » qu’on peut croiser dans d’autres tutoriels est signalé indisponible par l’éditeur sur les versions récentes de Claude Desktop. Source : documentation officielle Novamira.

Dans l’extension Novamira, à côté de l’intégration proposée, cliquer sur le lien Needs the JSON config (peu visible), puis choisir Claude Desktop. Cela génère le bloc de code JSON à insérer dans la configuration de Claude.

Étape 3 — Installer Node.js

Prérequis technique pour faire fonctionner un serveur MCP local : télécharger et installer Node.js (nodejs.org, bouton Get Node.js, version détectée automatiquement selon l’OS).

Étape 4 — Installer un éditeur de code

Le fichier claude_desktop_config.json peut s’ouvrir avec un simple Bloc-notes, mais un éditeur de code (coloration syntaxique, appariement des accolades) rend la manipulation plus sûre. La leçon recommande Cursor (gratuit, compte requis), en précisant que VS Code, Windsurf ou tout autre éditeur de code conviennent également. Associer les fichiers .json à cet éditeur par défaut simplifie les prochaines manipulations.

Étape 5 — Fusionner le nouveau bloc de code via Claude

Plutôt que de modifier le JSON à la main (risque d’erreur de syntaxe), la méthode recommandée : copier le contenu actuel du fichier de config, le coller dans une conversation Claude, ajouter le nouveau bloc du serveur MCP WordPress, et demander à Claude de fusionner les deux proprement. Claude renvoie alors le fichier complet à recopier.

Point de vigilance signalé pendant la leçon : cette étape implique de coller un identifiant et un mot de passe WordPress en clair dans une conversation Claude. Claude avertit systématiquement quand une clé API ou un mot de passe est détecté dans un message, et recommande de la révoquer/regénérer par précaution — ce n’est pas utilisé pour l’entraînement des modèles, mais il reste préférable d’éviter cette pratique une fois la manipulation maîtrisée.

Étape 6 — Enregistrer et redémarrer Claude Desktop

Coller le fichier fusionné dans l’éditeur de code, sauvegarder (Ctrl+S — un indicateur visuel signale les modifications non enregistrées). Puis quitter complètement Claude Desktop (pas seulement fermer la fenêtre : vérifier qu’il ne tourne plus en tâche de fond, via le gestionnaire de tâches sous Windows) avant de le rouvrir, pour que la nouvelle configuration soit prise en compte.

Étape 7 — Vérifier l’installation

Dans Réglages > Développeur, un nouvel encart liste les configurations locales installées, dont le serveur Novamira WordPress qui vient d’être ajouté. Il est également visible dans Customize > Connecteurs, section bureau (local/proxy).

Contrairement à un serveur MCP hébergé qui expose potentiellement de nombreux outils, un serveur local fraîchement connecté n’affiche qu’un petit nombre d’outils statiques au départ — cohérent avec le principe des outils dynamiques déjà vu à la leçon 3/2.

Pour tester : désactiver temporairement les autres connecteurs WordPress (pour isoler la source), puis demander à Claude s’il a accès au site via Novamira. Claude demande une autorisation la première fois (« toujours autoriser »), puis peut interroger l’environnement, les extensions actives et inactives, etc.

Structure du fichier de configuration

Le fichier claude_desktop_config.json contient un bloc principal mcpServers, qui regroupe un ou plusieurs serveurs MCP locaux/proxy. Pour ajouter un nouveau serveur, il faut l’insérer à l’intérieur de ce bloc, au même niveau que les serveurs déjà présents — la fusion via Claude (étape 5) évite les erreurs de syntaxe à ce stade (accolades, virgules).

À retenir

  • Novamira remplit deux rôles indépendants : enrichir le registre d’abilities WordPress (utile même avec un serveur MCP hébergé) et fournir une connexion locale par elle-même.
  • La connexion locale demande une installation ponctuelle (Node.js, éditeur de code) mais suit toujours le même schéma : mot de passe d’application → bloc JSON → fusion dans claude_desktop_config.json → redémarrage complet de Claude Desktop.
  • Se faire la main sur cette procédure une ou deux fois est utile : elle sera réutilisée pour d’autres serveurs MCP locaux dans la suite du module.