Tutoriels sur Joomla et la création de site

Et si vous pouviez dire à Claude "crée-moi un article sur Joomla" et le voir apparaître directement sur votre site, sans ouvrir l'administration ? C'est exactement ce que permet le protocole MCP (Model Context Protocol), développé par Anthropic pour connecter des intelligences artificielles à des outils externes.

Dans ce tutoriel, nous allons mettre en place, pas à pas, une connexion entre Claude Desktop (l'application bureau de Claude) et votre site Joomla 5, en passant par l'API REST native de Joomla. À la fin, vous pourrez piloter vos articles, catégories, menus, médias, tags et utilisateurs directement depuis une conversation avec Claude.

Comprendre le principe en 30 secondes

Joomla 5 intègre nativement une API REST qui permet à n'importe quel logiciel d'interagir avec votre site via des requêtes HTTP. De son côté, Claude Desktop peut se connecter à des serveurs MCP — de petits programmes qui exposent des "outils" que Claude peut utiliser.

Le schéma est simple :

1. Claude Desktop lance un petit serveur Node.js sur votre ordinateur
2. Ce serveur traduit les demandes de Claude en requêtes vers l'API Joomla
3. Joomla répond, et Claude vous présente le résultat

Tout se passe en local sur votre machine — pas besoin d'hébergement supplémentaire.

Étape 1 — Activer l'API REST dans Joomla

1a. Activer le plugin Web Services

Dans votre administration Joomla, allez dans Extensions → Plugins, recherchez "Web Services" et activez le plugin "System – Web Services – API".

1b. Générer votre token API

Allez dans Utilisateurs → Votre compte, puis cliquez sur l'onglet "Authentification API Joomla". Cliquez sur "Créer un token".

Ce token s'utilise comme une clé d'accès : il identifie qui fait la requête et avec quels droits. Il correspond aux droits de votre compte utilisateur Joomla.

Étape 2 — Installer Node.js sur votre ordinateur

Node.js est un environnement d'exécution JavaScript qui va faire tourner notre petit serveur MCP. C'est gratuit et s'installe en quelques clics.

1. Rendez-vous sur nodejs.org
2. Téléchargez la version LTS (bouton vert à gauche — c'est la version stable recommandée)
3. Installez-la avec les options par défaut (Suivant, Suivant, Terminer)

Pour vérifier que l'installation s'est bien passée, ouvrez un terminal (cmd sur Windows, Terminal sur Mac/Linux) et tapez :

node --version

Vous devriez voir s'afficher un numéro de version (ex : v20.x.x ou supérieur). Tout est bon.

Étape 3 — Créer le serveur MCP

( Le zip suivant sert d'exemple à décompresser et installer dans C:\ pour modification, sinon suivez la procédure )

Télécharger les fichiers MCP (zip)

3a. Créer le dossier

Créez un dossier sur votre ordinateur, par exemple C:\joomla-mcp sur Windows, ou ~/joomla-mcp sur Mac/Linux. C'est là que vivront les fichiers de votre serveur MCP.

3b. Créer les fichiers

Dans ce dossier, créez les trois fichiers suivants :

package.json — décrit les dépendances du projet :

{
   "name": "joomla-mcp-local",
   "version": "1.0.0",
   "type": "module",
   "main": "index.js",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "node-fetch": "^3.3.2",
     "dotenv": "^16.4.5",
     "zod": "^3.22.4"
   }
 }

.env — vos identifiants (ne partagez jamais ce fichier) :

JOOMLA_URL=https://www.votre-site.fr
 JOOMLA_TOKEN=votre_token_api_joomla

index.js — le cœur du serveur MCP :

import 'dotenv/config';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import fetch from 'node-fetch';
 import fs from 'fs/promises';
 import path from 'path';
 
 const JOOMLA_URL = process.env.JOOMLA_URL?.replace(/\/$/, '');
 const BASE       = JOOMLA_URL + '/api/index.php/v1';
 
 const HEADERS = {
   'Authorization': 'Bearer ' + process.env.JOOMLA_TOKEN,
   'Content-Type':  'application/json',
   'Accept':        'application/vnd.api+json'
 };
 
 async function joomla(endpoint, method = 'GET', body = null) {
   const opts = { method, headers: HEADERS };
   if (body) opts.body = JSON.stringify(body);
   const res = await fetch(BASE + endpoint, opts);
   if (!res.ok) {
     const text = await res.text();
     throw new Error(`Joomla API ${res.status}: ${text}`);
   }
   return res.json();
 }
 
 function ok(data) {
   return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
 }
 
 const server = new McpServer({ name: 'joomla-mcp', version: '1.0.0' });
 
 // ── ARTICLES ──────────────────────────────────────────────────────────────────
 server.tool('lister_articles', 'Liste...