Tutoriels inédits sur le CMS Joomla

Vous avez suivi le tutoriel, votre premier site Joomla est connecté à Claude Desktop, et tout fonctionne parfaitement. Maintenant, vous gérez plusieurs sites Joomla — un pour votre activité principale, un autre pour un client, un troisième pour un projet perso... La bonne nouvelle : ajouter un second site (ou un troisième, ou un dixième) ne nécessite aucune installation supplémentaire. Juste quelques lignes à ajouter dans un fichier texte.

Comment ça fonctionne ?

Rappelons rapidement le principe : Claude Desktop lit un fichier de configuration appelé claude_desktop_config.json au démarrage. Ce fichier liste tous les serveurs MCP auxquels Claude doit se connecter. Chaque entrée dans ce fichier correspond à un site Joomla différent, avec ses propres identifiants.

Le serveur MCP lui-même — le fichier index.js que vous avez installé — n'a pas besoin d'être copié. Le même fichier est réutilisé pour tous vos sites. Claude Desktop en lance simplement plusieurs instances en parallèle, chacune configurée avec une URL et un token différents.

Étape 1 — Récupérer le token API du second site

Chaque site Joomla a son propre token API. Pour le générer sur votre second site :

1. Connectez-vous à l'administration du second site
2. Allez dans Utilisateurs → Votre compte
3. Cliquez sur l'onglet "Authentification API Joomla"
4. Cliquez sur "Créer un token" et copiez-le

Étape 2 — Ouvrir le fichier de configuration

Ouvrez le fichier claude_desktop_config.json avec un éditeur de texte (Bloc-notes, Notepad++, VS Code...) :

• Windows : C:\Users\[VotreNom]\AppData\Roaming\Claude\claude_desktop_config.json
• Mac : ~/Library/Application Support/Claude/claude_desktop_config.json

Votre fichier ressemble actuellement à ceci (avec votre premier site déjà configuré) :

{
  "mcpServers": {
    "monsite": {
      "command": "node",
      "args": ["C:\\joomla-mcp\\index.js"],
      "env": {
        "JOOMLA_URL": "https://www.mon-premier-site.fr",
        "JOOMLA_TOKEN": "token_du_premier_site"
      }
    }
  }
}

Étape 3 — Ajouter le second site

Il suffit d'ajouter une nouvelle entrée dans la section mcpServers, après la première, séparée par une virgule :

{
  "mcpServers": {
    "monsite": {
      "command": "node",
      "args": ["C:\\joomla-mcp\\index.js"],
      "env": {
        "JOOMLA_URL": "https://www.mon-premier-site.fr",
        "JOOMLA_TOKEN": "token_du_premier_site"
      }
    },
    "second-site": {
      "command": "node",
      "args": ["C:\\joomla-mcp\\index.js"],
      "env": {
        "JOOMLA_URL": "https://www.mon-second-site.fr",
        "JOOMLA_TOKEN": "token_du_second_site"
      }
    }
  }
}

Adaptez simplement :

• "second-site" → le nom que vous voulez donner à ce connecteur (sans espaces, sans accents)
• JOOMLA_URL → l'adresse de votre second site
• JOOMLA_TOKEN → le token API généré à l'étape 1

Étape 4 — Redémarrer Claude Desktop

Sauvegardez le fichier, puis redémarrez complètement Claude Desktop :

1. Faites un clic droit sur l'icône Claude dans la barre des tâches (en bas à droite)
2. Cliquez sur "Quitter"
3. Vérifiez dans le Gestionnaire des tâches (Ctrl+Shift+Échap) qu'aucun processus Claude ne tourne encore
4. Relancez Claude Desktop depuis le Bureau ou le menu Démarrer

Vérifier que les deux sites sont connectés

Dans Claude Desktop, allez dans Paramètres → Développeur. Vous devriez voir apparaître deux serveurs MCP — un par site — chacun avec un statut vert.

Testez directement dans la conversation en précisant sur quel site vous souhaitez agir :

"Sur mon-second-site, liste les articles"

"Sur monsite, crée un article dans la catégorie 5"

Claude comprend le contexte et utilise automatiquement le bon connecteur selon le site mentionné.

Vous gérez 10 sites ? Pas de problème.

Il n'y a pas de limite au nombre d'entrées dans mcpServers. Chaque site Joomla que vous gérez peut avoir son propre connecteur, avec un nom explicite qui vous permet de les distinguer facilement :

{
  "mcpServers": {
    "web54":    { ... },
    "migration-joomla":  { ... },
    "client-boulangerie": { ... },
    "client-avocat": { ... }
  }
}

Une seule installation Node.js, un seul fichier index.js, autant de sites que vous le souhaitez.

Article rédigé par Serge Billon — web54.fr | Agence web Joomla en Lorraine