WordPress MCP Adapter : guide et tutoriel complet

Bannière mcp-adapter

Et si votre site WordPress devenait directement pilotable par une IA ? C’est la promesse du MCP Adapter, le pont officiel entre WordPress et le Model Context Protocol. Ce guide explique son fonctionnement, son installation et la connexion de votre assistant à votre site, en local comme à distance.

Introduction

WordPress est le CMS le plus utilisé au monde, et l’IA s’invite désormais dans son cœur. Avec la version 6.9, WordPress a introduit l’Abilities API, un registre standard des actions que le cœur, les extensions et les thèmes savent accomplir. Le MCP Adapter, développé par l’équipe IA de WordPress dans le cadre de l’initiative AI Building Blocks for WordPress, expose ces capacités via le Model Context Protocol (MCP). Votre assistant IA, comme Claude Desktop, Claude Code, Cursor ou VS Code, peut alors les découvrir et les exécuter sur votre site. Cet article vous propose un MCP guide complet pour bien démarrer.

🎯 Qu’est-ce que le WordPress MCP Adapter ?

Le MCP Adapter est une extension officielle qui convertit les abilities (capacités) de WordPress en outils, ressources et prompts MCP. Une capacité décrit une action précise : son nom, sa description, le schéma de ses paramètres, le code qui l’exécute et la vérification des droits de l’utilisateur.

Par défaut, les capacités sont privées : c’est le développeur qui choisit celles qu’il rend publiques. L’adaptateur crée automatiquement un serveur par défaut qui expose trois méta-outils, mcp-adapter-discover-abilities, mcp-adapter-get-ability-info et mcp-adapter-execute-ability : l’assistant découvre les capacités disponibles, consulte leur schéma, puis les exécute. Cette approche garde une liste d’outils compacte, quel que soit le nombre de capacités.

Schéma : Assistant IA → MCP Adapter → Abilities API → Cœur, extensions et thème WordPress

⚙️ Fonctionnalités principales

L’adaptateur fournit tout le nécessaire pour ouvrir un site WordPress aux agents IA :

Conversion automatique : les capacités WordPress deviennent des outils, des ressources ou des prompts MCP.
Serveur par défaut prêt à l’emploi : trois méta-outils pour découvrir, décrire et exécuter les capacités publiques, sans configuration.
Serveurs personnalisés : créez vos propres serveurs MCP avec une liste explicite de capacités, via le hook mcp_adapter_init.
Deux transports : HTTP via l’API REST de WordPress et STDIO via WP-CLI, avec une interface pour développer des transports sur mesure.
Sécurité par défaut : capacités privées tant qu’elles ne sont pas rendues publiques, et contrôle des droits propre à chaque capacité.
Gestion des erreurs et observabilité : des gestionnaires dédiés pour journaliser les erreurs et suivre l’activité.
Projet officiel : maintenu sous l’égide de WordPress, sous licence GPL-2.0 ou ultérieure.

📦 Installation et configuration

Voici la marche à suivre, de l’installation à la connexion de votre assistant :

Prérequis : WordPress 6.9 ou plus récent (l’Abilities API est intégrée au cœur) et PHP 7.4 ou plus récent.
Installer l’extension : recherchez « MCP Adapter » dans Extensions > Ajouter, ou utilisez WP-CLI :
```
wp plugin install mcp-adapter --activate
```

Rendre une capacité publique : lors de l’enregistrement d’une capacité, ajoutez la métadonnée qui l’expose au protocole MCP. Exemple dans une extension :

add_action( 'wp_abilities_api_init', function() {
    wp_register_ability( 'mon-extension/infos-site', array(
        'label'               => 'Informations du site',
        'description'         => 'Renvoie le nom et le lien du site',
        'category'            => 'site',
        'input_schema'        => array(
            'type'       => 'object',
            'properties' => array(
                'include_stats' => array( 'type' => 'boolean', 'default' => false ),
            ),
        ),
        'execute_callback'    => function( $input ) {
            $result = array( 'name' => get_bloginfo( 'name' ), 'url' => get_site_url() );
            if ( ! empty( $input['include_stats'] ) ) {
                $result['posts'] = wp_count_posts( 'post' )->publish;
            }
            return $result;
        },
        'permission_callback' => function() {
            return current_user_can( 'read' );
        },
        'meta'                => array( 'mcp' => array( 'public' => true ) ),
    ) );
} );

Connecter votre client en local (STDIO) : si WordPress tourne sur votre machine, passez par WP-CLI dans la configuration de votre client, par exemple claude_desktop_config.json :

{
  "mcpServers": {
    "wordpress": {
      "command": "wp",
      "args": [
        "--path=/chemin/vers/votre/site",
        "mcp-adapter",
        "serve",
        "--server=mcp-adapter-default-server",
        "--user=admin"
      ]
    }
  }
}

Connecter un site distant (HTTP) : créez un mot de passe d’application dans Utilisateurs > Profil, puis utilisez le proxy @automattic/mcp-wordpress-remote :

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://votre-site.fr/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "votre-identifiant",
        "WP_API_PASSWORD": "votre-mot-de-passe-d-application"
      }
    }
  }
}

Redémarrer et tester : relancez votre client. Vous pouvez aussi vérifier le serveur en ligne de commande :

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | wp mcp-adapter serve --user=admin --server=mcp-adapter-default-server

💡 Guide d’utilisation pratique

Une fois connecté, l’assistant explore votre site en trois temps : il découvre les capacités publiques, consulte le schéma de celle qui l’intéresse, puis l’exécute. Quelques exemples de demandes :

Explorer : « Quelles capacités sont disponibles sur mon site WordPress ? »
Interroger : « Donne-moi le nom de mon site et le nombre d’articles publiés. »
Agir : « Crée un brouillon à partir de ces notes. », si une capacité de création de contenu est exposée sur votre site.

Ce que l’assistant peut faire dépend directement des capacités rendues publiques : celles que vous développez, et celles que vos extensions déclarent à mesure qu’elles adoptent l’Abilities API.

🚀 Cas d’usage et exemples

Administration conversationnelle : confiez à l’IA des tâches de gestion courantes, exposées sous forme de capacités.
Extensions prêtes pour l’IA : les développeurs rendent leurs fonctionnalités accessibles aux assistants sans écrire de serveur MCP dédié.
Agences et freelances : standardisez l’accès de vos agents IA à plusieurs sites clients.
Production de contenu : reliez la rédaction assistée par IA à votre flux éditorial WordPress.
Diagnostic et maintenance : exposez des capacités de contrôle (état du site, configuration) pour accélérer le support.

⚖️ Avantages et inconvénients

Avantages	Inconvénients
Projet officiel de WordPress	Encore en version 0.x, avec des changements entre versions
S’appuie sur l’Abilities API intégrée au cœur	Nécessite WordPress 6.9 ou plus récent
Capacités privées par défaut, droits vérifiés à chaque appel	Il faut déclarer et rendre publiques des capacités pour en profiter
Transports STDIO et HTTP, serveurs personnalisés	L’accès distant impose une gestion rigoureuse des mots de passe d’application

❓ FAQ

Q : Le MCP Adapter est-il officiel ?
- R : Oui, il est publié sous le compte GitHub de WordPress (WordPress/mcp-adapter) et dans le répertoire officiel des extensions.
Q : Faut-il installer l’Abilities API séparément ?
- R : Non. Depuis WordPress 6.9, elle fait partie du cœur.
Q : L’assistant peut-il tout faire sur mon site ?
- R : Non. Seules les capacités rendues publiques sont exposées, et chacune vérifie les droits de l’utilisateur connecté avant de s’exécuter.
Q : Avec quels assistants est-il compatible ?
- R : Avec tout client MCP, notamment Claude Desktop, Claude Code, Cursor et VS Code, en local via WP-CLI ou à distance en HTTP.
Q : Faut-il savoir coder ?
- R : Pour créer de nouvelles capacités, oui : quelques notions de PHP sont nécessaires. Pour utiliser celles fournies par vos extensions, une simple configuration suffit.

🎊 Conclusion et recommandations

Le WordPress MCP Adapter pose les fondations d’un WordPress piloté par l’IA : un standard officiel, sécurisé par défaut, qui permet à n’importe quel assistant compatible MCP d’agir sur votre site à travers des capacités clairement définies. Développeurs d’extensions, agences et éditeurs de sites ont tout intérêt à s’y intéresser dès maintenant. Retrouvez-le aussi dans notre annuaire des serveurs MCP.

Essayez le WordPress MCP Adapter dès aujourd’hui ! Consultez le repository GitHub et la présentation de l’Abilities API pour commencer.

WordPress MCP Adapter : guide et tutoriel