Claude Bridge – Plugin WordPress

Claude Bridge est un plugin WordPress qui expose une API REST sécurisée permettant à Claude (via un serveur MCP local) de lire et modifier les fichiers du thème, de gérer les plugins, les options, la médiathèque et la base de données de votre site. Chaque écriture est précédée d’une sauvegarde automatique et d’une validation syntaxique PHP.

Version 1.0.0 · WordPress 5.6 ou supérieur · PHP 7.4 ou supérieur · Licence GPL-2.0+ · Synaptic CRM Dev Team

Fonctionnalités

Claude Bridge regroupe ses fonctions en sept outils, que vous activez ou désactivez un par un :

• Thème : lister, lire, créer et modifier les fichiers du thème actif, y compris par modifications ciblées (insertion, remplacement ou suppression par ligne ou par ancre).
• Plugins : lister, rechercher, installer, activer, désactiver et mettre à jour les extensions.
• Code des plugins : lire et modifier le code source des extensions installées (Claude Bridge lui-même est protégé).
• Options : lire, rechercher et modifier les options WordPress.
• Base de données : lister les tables et exécuter des requêtes en lecture seule. L’écriture SQL exige en plus la constante CLAUDE_BRIDGE_ALLOW_SQL_WRITE dans wp-config.php.
• Médiathèque : téléverser des images (logos, illustrations…), avec texte alternatif et rattachement à un article.
• Sauvegardes : lister et restaurer les copies créées automatiquement avant chaque modification.

Les gros fichiers sont envoyés en plusieurs morceaux, avec un contrôle d’intégrité SHA-256.

Sécurité

• Accès réservé aux comptes administrateurs, authentifiés par un mot de passe d’application WordPress dédié (jamais le mot de passe habituel).
• HTTPS requis : un avertissement s’affiche dans l’administration si le site n’est pas en SSL.
• Seuls trois outils sont actifs par défaut (Thème, Plugins, Options). Un outil désactivé renvoie une erreur 403 sur toutes ses routes, même avec des identifiants valides.
• Sauvegarde automatique avant chaque modification et vérification de la syntaxe PHP avant l’écriture.
• Les opérations SQL les plus dangereuses (DROP DATABASE, GRANT, CREATE USER, suppression des tables cœur de WordPress…) restent toujours interdites.

Installation

Option A : depuis le fichier ZIP (le plus simple)

1. Téléchargez le fichier ZIP avec le bouton ci-dessus (il contient déjà le dossier claude-bridge, ne le décompressez pas).
2. Connectez-vous à l’administration WordPress : https://votre-site.tld/wp-admin.
3. Dans le menu de gauche, cliquez sur Extensions puis Ajouter une extension.
4. En haut de la page, cliquez sur Téléverser une extension.
5. Cliquez sur Choisir un fichier, sélectionnez le fichier ZIP téléchargé, puis cliquez sur Installer maintenant.
6. Une fois l’installation terminée, cliquez sur Activer l’extension.

Option B : par transfert de fichiers (FTP, SFTP ou gestionnaire de fichiers)

1. Décompressez l’archive et copiez le dossier claude-bridge tel quel dans wp-content/plugins/claude-bridge/.
2. Dans l’administration WordPress, ouvrez Extensions puis Extensions installées.
3. Repérez Claude Bridge dans la liste et cliquez sur Activer sous son nom.

Configuration : choisir les outils autorisés

Ouvrez Réglages puis Claude Bridge. Chaque outil a sa case à cocher :

• Thème : activé par défaut
• Plugins : activé par défaut
• Code des plugins : désactivé par défaut (risqué)
• Options : activé par défaut
• Base de données : désactivé par défaut (accès SQL direct)
• Médiathèque : désactivé par défaut
• Sauvegardes : désactivé par défaut

Cochez uniquement les outils dont vous avez besoin, puis cliquez sur Enregistrer. Vous pouvez revenir sur cette page à tout moment.

Créer un mot de passe d’application

Claude Bridge ne fonctionne pas avec le mot de passe habituel du compte. Il faut créer un mot de passe d’application dédié, avec un compte administrateur, sur un site en HTTPS.

1. Dans l’administration, cliquez sur votre nom en haut à droite (ou Utilisateurs puis Profil).
2. Faites défiler jusqu’à la section Mots de passe d’application, en bas de la page.
3. Saisissez un nom pour vous repérer, par exemple Claude Bridge.
4. Cliquez sur Ajouter un nouveau mot de passe d’application.
5. WordPress affiche le mot de passe une seule fois (4 groupes de 4 caractères). Copiez-le immédiatement dans un gestionnaire de mots de passe.

Informations à donner au serveur MCP local (ou à l’outil qui appelle l’API) :

• URL du site : https://votre-site.tld
• Nom d’utilisateur : votre identifiant de connexion WordPress
• Mot de passe : le mot de passe d’application généré (pas votre mot de passe habituel)

Tester la connexion (facultatif)

curl -u "votre_identifiant:xxxx xxxx xxxx xxxx" 
     https://votre-site.tld/wp-json/claude-bridge/v1/info

Si tout est correct, la commande renvoie un JSON avec la version du plugin, la version de WordPress et le thème actif.

Pour révoquer l’accès plus tard, retournez sur votre page de profil, section Mots de passe d’application, et cliquez sur Révoquer en face du mot de passe « Claude Bridge ».