Depuis la version 10.3, SEOPress intègre un serveur MCP. MCP (Model Context Protocol) est le standard ouvert qu’utilisent les assistants IA pour dialoguer avec des outils externes. Une fois votre site connecté, Claude, ChatGPT, Cursor ou tout autre client MCP peut lire et gérer vos données SEO directement depuis une conversation : titres, méta descriptions, directives robots, métadonnées sociales, analyse de contenu, redirections, données structurées, etc. Depuis SEOPress 10.4, cela couvre aussi vos termes de taxonomie : catégories, étiquettes, catégories de produits et taxonomies personnalisées.
Le serveur MCP est inclus dans SEOPress Free. SEOPress PRO y ajoute ses propres outils. Il n’y a aucune extension supplémentaire à installer, aucun service tiers intermédiaire et aucune clé API à payer : le client IA dialogue directement avec votre site.
Ce que vous pouvez en faire
Quelques demandes à saisir dans votre client IA une fois le site connecté :
- « Liste les pages qui n’ont pas de méta description et rédiges-en une pour chacune. »
- « Quelles publications sont en noindex ? Dis-moi si l’une d’elles ressemble à une erreur. »
- « Lance l’analyse de contenu de la publication 123 sur le mot-clé « seo wordpress » et dis-moi quoi corriger. »
- « Réécris les titres SEO de mes 10 derniers articles pour qu’ils restent sous les 60 caractères. »
- « Liste les catégories de produits qui n’ont pas de méta description et rédiges-en une pour chacune. » (SEOPress 10.4)
- « Crée une redirection 301 de /ancienne-page/ vers /nouvelle-page/. » (SEOPress PRO)
- « Lance l’audit technique du site et résume les problèmes par priorité. » (SEOPress PRO)
L’assistant choisit lui-même les bons outils. Vous gardez la main sur ce qu’il a le droit de faire, comme expliqué plus bas.
Prérequis
- SEOPress 10.3 ou supérieur (SEOPress PRO 10.3 ou supérieur pour les outils PRO). Les outils des termes de taxonomie nécessitent SEOPress 10.4, et les suggestions IA pour les termes SEOPress PRO 10.4.
- WordPress 6.9 ou supérieur. Le serveur MCP repose sur l’API Abilities de WordPress, livrée avec WordPress 6.9.
- Un site servi en HTTPS. Les clients hébergés dans le cloud (claude.ai, chatgpt.com) ont besoin d’une adresse HTTPS publique pour atteindre votre site.
- Un compte WordPress disposant des permissions correspondant à ce que vous voulez confier à l’assistant.
Les sites locaux (localhost, 127.0.0.1, *.localhost) fonctionnent sans HTTPS avec les clients installés sur votre machine : Claude Code, l’application de bureau Claude et Cursor. claude.ai et chatgpt.com tournent sur leurs propres serveurs et ne peuvent pas voir un site local.
Étape 1 : activer le serveur MCP
Le serveur MCP est désactivé par défaut. Rien n’est exposé tant que vous ne l’avez pas activé.
- Allez dans SEO > Avancé, onglet Avancé.
- Dans la section API Abilities, activez Exposer les abilities aux agents IA et aux outils externes.
- Cliquez sur Enregistrer les modifications.
- Ouvrez l’onglet MCP de la même page.
L’onglet MCP réunit tout ce dont vous avez besoin : l’état de la connexion, les vérifications de disponibilité, l’URL du serveur MCP, les instructions propres à chaque client, une section de dépannage, les clients connectés et la liste des outils.
Depuis SEOPress 10.4, vous pouvez aussi l’ouvrir depuis le tableau de bord SEO (SEO > Tableau de bord). Dans la section Modules SEO, le groupe Technique contient une carte Serveur MCP : « Gérez votre SEO depuis votre assistant IA : Claude, ChatGPT, Cursor ou tout client MCP. » Son lien Réglages ouvre l’onglet MCP. Contrairement à la plupart des modules, cette carte n’a pas d’interrupteur : le serveur s’active et se désactive avec le réglage Exposer les abilities aux agents IA et aux outils externes vu plus haut.
L’URL de votre serveur MCP ressemble à ceci :
https://example.com/wp-json/seopress/mcp/v1
Si vos permaliens sont réglés sur « Simple », l’URL prend la forme avec paramètre de requête (https://example.com/?rest_route=/seopress/mcp/v1). Elle fonctionne aussi : copiez-la exactement telle que l’onglet MCP l’affiche.
Étape 2 : connecter votre client IA
Dans la section Connexion de l’onglet MCP, choisissez votre client : Claude, ChatGPT ou Cursor. Chacun se configure différemment, seules les instructions du client choisi sont donc affichées. Depuis SEOPress 10.4, chaque client affiche aussi une ligne Comment il s’identifie : qui indique ce dont il a besoin de la part de votre site.
Lorsque votre site peut faire fonctionner OAuth, tous les clients s’identifient de cette façon. Vous collez l’URL, votre navigateur ouvre votre propre site, vous vous connectez à WordPress et vous approuvez la connexion. Il n’y a aucun mot de passe ni aucune clé API à créer ou à copier. Si votre site ne peut pas utiliser OAuth, les onglets Claude et Cursor passent d’eux-mêmes à un mot de passe d’application : voir Quand votre site ne peut pas utiliser OAuth plus bas.
Claude (claude.ai, application de bureau, Claude Code)
Claude existe sous forme d’application de discussion, sur claude.ai ou installée sur votre ordinateur, et sous forme de Claude Code dans un terminal. Depuis SEOPress 10.4, l’onglet Claude propose un bloc pour chacun : suivez celui de l’application que vous utilisez. claude.ai et l’écran Connectors de l’application de bureau se connectent depuis les serveurs d’Anthropic : votre site a donc besoin d’une adresse HTTPS publique pour eux. Claude Code s’identifie depuis votre propre machine.
claude.ai et l’application de bureau Claude
- Ouvrez Settings > Connectors, puis Add custom connector.
- Collez l’URL de votre serveur MCP. Laissez tous les autres champs vides : votre site enregistre lui-même le client et lui indique où s’identifier.
- Votre navigateur est redirigé vers votre site. Connectez-vous à WordPress si nécessaire, puis approuvez la connexion.
Claude Code (terminal)
Lancez dans un terminal la commande affichée dans l’onglet MCP. Elle ressemble à ceci :
claude mcp add --transport http --scope user SEOPress "https://example.com/wp-json/seopress/mcp/v1"
Démarrez ensuite Claude Code, tapez /mcp, choisissez SEOPress et identifiez-vous sur votre site dans la fenêtre de navigateur qui s’ouvre.
ChatGPT
ChatGPT s’identifie uniquement via OAuth : un mot de passe d’application ne peut pas être utilisé. chatgpt.com se connecte depuis les serveurs d’OpenAI, votre site doit donc avoir une adresse HTTPS publique. Depuis SEOPress 10.4, l’onglet ChatGPT donne des étapes distinctes pour l’application de bureau et pour chatgpt.com.
L’application de bureau ChatGPT
- Ouvrez Settings, puis Plugins sous Integrations. Cliquez sur Add et choisissez Add MCP server.
- Donnez-lui un nom, choisissez le type Streamable HTTP, collez l’URL de votre serveur MCP et enregistrez. Laissez vides les champs de jeton (bearer token) et d’en-têtes : votre site identifie lui-même la connexion via OAuth.
- Cliquez sur Authenticate à côté du serveur, connectez-vous à votre site et approuvez la connexion.
chatgpt.com
- Les serveurs MCP personnalisés n’apparaissent qu’en mode développeur. Ouvrez Settings et activez Developer mode dans la section consacrée à la sécurité et à la connexion.
- Depuis la page Plugins, ouvrez le formulaire de création d’un plugin personnalisé : selon votre compte, un bouton +, ou Browse directory puis Add.
- Renseignez un nom et l’URL de votre serveur MCP comme URL du serveur, gardez OAuth comme méthode d’authentification, confirmez l’avertissement sur les risques et créez-le.
- Connectez-vous à votre site lorsque votre navigateur y est redirigé, puis approuvez la connexion.
Cursor
Cursor lit ses serveurs MCP dans un fichier JSON que vous modifiez vous-même. Il vous identifie via OAuth la première fois qu’il utilise le serveur : il n’y a donc rien à créer au préalable.
- Ouvrez ou créez le fichier
.cursor/mcp.json(ce projet uniquement) ou~/.cursor/mcp.json(tous les projets). - Ajoutez-y le serveur SEOPress ci-dessous. Si le fichier contient déjà un objet
mcpServers, ajoutez l’entréeSEOPressà l’intérieur au lieu de remplacer le fichier.
{
"mcpServers": {
"SEOPress": {
"type": "http",
"url": "https://example.com/wp-json/seopress/mcp/v1"
}
}
}
Redémarrez ensuite Cursor, ouvrez Settings > Customize > MCPs, cliquez sur Authenticate à côté de SEOPress et approuvez la connexion.
Quand votre site ne peut pas utiliser OAuth
OAuth ne peut pas fonctionner lorsque le site n’est pas servi en HTTPS (sauf site local), lorsque le serveur OAuth est désactivé, ou lorsque votre hébergeur répond lui-même aux adresses de découverte /.well-known/ au lieu de les transmettre à WordPress. Depuis SEOPress 10.4, l’onglet MCP tient compte du résultat des vérifications de disponibilité et adapte les onglets des clients :
- ChatGPT, claude.ai et l’écran Connectors de l’application de bureau Claude ne peuvent pas se connecter. Leur onglet indique l’élément manquant et ce qu’il faut corriger.
- Claude Code, l’application de bureau Claude et Cursor fonctionnent toujours : ils tournent sur votre propre machine et envoient à la place un mot de passe d’application WordPress. Les onglets Claude et Cursor affichent alors les configurations correspondantes.
Créer le mot de passe d’application
Dans l’onglet Claude ou Cursor, donnez un Nom au mot de passe (SEOPress MCP par défaut, le nom sous lequel il apparaît sur votre profil) et cliquez sur Créer un mot de passe d’application. WordPress le crée pour votre compte, et les configurations de l’onglet se remplissent d’elles-mêmes : il ne reste rien à remplacer. Le mot de passe n’est affiché qu’une seule fois et SEOPress ne le stocke jamais : copiez ce dont vous avez besoin avant de recharger la page.
Vous avez déjà créé un mot de passe d’application depuis votre profil ? Tant que vous n’en créez pas un dans l’onglet, les configurations contiennent l’espace réservé BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD. L’onglet fournit une commande qui demande votre mot de passe et affiche le Base64 à coller à sa place. Sous macOS ou Linux, lancez-la dans un terminal (l’onglet y écrit votre propre identifiant à la place de USERNAME) :
read -rsp 'Application password: ' SEOPRESS_PW && printf '%s' "USERNAME:$SEOPRESS_PW" | base64 && unset SEOPRESS_PW
Sous Windows, lancez plutôt celle-ci dans PowerShell :
$pw = Read-Host 'Application password' -AsSecureString; [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes('USERNAME:' + [Net.NetworkCredential]::new('', $pw).Password)); Remove-Variable pw
Application de bureau Claude
Le fichier de configuration de l’application de bureau ne démarre que des serveurs situés sur votre propre machine. Elle atteint donc votre site par l’intermédiaire de mcp-remote, une petite passerelle qui nécessite Node.js.
- Installez Node.js (la version LTS disponible sur nodejs.org) si votre ordinateur ne l’a pas encore. La passerelle se lance avec
npx, fourni avec Node.js. - Dans l’application de bureau, ouvrez Settings, puis Developer, et cliquez sur Edit Config. Sous macOS, Settings se trouve dans le menu Claude ; sous Windows, dans le menu en haut à gauche de la fenêtre, sous File. L’application vous montre le fichier
claude_desktop_config.json: ouvrez-le dans un éditeur de texte. Il se trouve dans~/Library/Application Support/Claude/sous macOS,%APPDATA%\Claude\sous Windows et~/.config/Claude/sous Linux. - Collez-y la configuration de l’onglet MCP. Si le fichier contient déjà un objet
mcpServers, ajoutez l’entréeSEOPressà l’intérieur au lieu de remplacer le fichier. - Quittez complètement l’application, puis rouvrez-la : fermer sa fenêtre la laisse tourner. Sous macOS, choisissez Quit Claude dans le menu Claude. Sous Windows, faites un clic droit sur l’icône Claude dans la zone de notification, près de l’horloge, et choisissez Quit.
- Ouvrez de nouveau Settings > Developer : SEOPress doit apparaître comme en cours d’exécution (running). S’il affiche une erreur, son journal, accessible depuis cet écran, en donne la raison.
La configuration ressemble à ceci :
{
"mcpServers": {
"SEOPress": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://example.com/wp-json/seopress/mcp/v1",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
}
}
}
}
Claude Code (terminal)
Claude Code envoie lui-même le mot de passe d’application, il n’a donc besoin d’aucune passerelle. Lancez la commande affichée dans l’onglet MCP :
claude mcp add --transport http --scope user SEOPress "https://example.com/wp-json/seopress/mcp/v1" --header "Authorization: Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
Démarrez ensuite Claude Code et tapez /mcp : SEOPress doit apparaître comme connecté.
Cursor
Collez la configuration de l’onglet Cursor dans .cursor/mcp.json ou ~/.cursor/mcp.json, comme plus haut. Elle transmet le mot de passe dans un en-tête :
{
"mcpServers": {
"SEOPress": {
"type": "http",
"url": "https://example.com/wp-json/seopress/mcp/v1",
"headers": {
"Authorization": "Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
}
}
}
}
Redémarrez Cursor et ouvrez Settings > Customize > MCPs : SEOPress doit apparaître avec ses outils.
Autres clients MCP
Tout client compatible avec le transport Streamable HTTP peut se connecter. S’il gère OAuth, donnez-lui l’URL du serveur MCP : il trouvera seul la page d’identification.
Dans le cas contraire, vous pouvez vous authentifier avec un mot de passe d’application WordPress, envoyé dans un en-tête Authorization de type Basic, comme dans la configuration Cursor ci-dessus :
{
"mcpServers": {
"SEOPress": {
"type": "http",
"url": "https://example.com/wp-json/seopress/mcp/v1",
"headers": {
"Authorization": "Basic BASE64_OF_USERNAME_COLON_APPLICATION_PASSWORD"
}
}
}
}
L’en-tête contient Basic, une espace, puis le Base64 de votre identifiant, de deux-points et du mot de passe d’application. Les commandes Base64 ci-dessus calculent cette valeur pour vous.
L’écran d’approbation : lecture seule, ou lecture et modification
Lorsqu’un client se connecte via OAuth, votre site affiche un écran d’approbation. Il indique quel client fait la demande, au nom de quel compte WordPress il agira et la liste des outils qu’il obtiendra. Vous choisissez ensuite ce que la connexion a le droit de faire :
- Lecture et modification : tous les outils sont disponibles.
- Lecture seule : seuls les outils qui lisent des données sont servis. Les outils qui modifient des données ne sont pas présentés à cette connexion, et sont refusés si le client en appelle un par son nom.
Cliquez sur Autoriser cette connexion pour terminer, ou sur Refuser pour annuler.
Le client choisit lui-même son nom lors de son enregistrement, et rien ne permet de le vérifier. N’approuvez qu’une connexion que vous venez de lancer vous-même.
Étape 3 : vérifier que tout fonctionne
Demandez à votre assistant quels outils il possède. Il doit lister ceux de la section Outils exposés de l’onglet MCP.
Si rien n’apparaît, ouvrez le panneau Diagnostics en haut de l’onglet MCP et cliquez sur Lancer les vérifications. Chaque ligne orange ou rouge indique ce qu’il faut modifier sur votre site. Depuis SEOPress 10.4, une ligne bleue signale un résultat attendu pour la configuration de votre site : il n’y a rien à corriger.
Outils disponibles
Les noms d’outils sont préfixés par seopress__. Par exemple, l’ability seopress/get-post-title-description est servie sous la forme de l’outil seopress__get-post-title-description.
SEOPress Free
| Outil | Ce qu’il fait | Accès | Qui peut l’utiliser |
|---|---|---|---|
get-post-title-description |
Lit le titre SEO et la méta description personnalisés d’une publication | Lecture seule | Comptes pouvant modifier la publication |
update-post-title-description |
Définit ou vide le titre SEO et la méta description d’une publication | Peut modifier des données | Comptes pouvant modifier la publication, si leur rôle n’est pas bloqué pour les metaboxes SEO |
get-post-robots-settings |
Lit les directives robots d’une publication (noindex, nofollow, URL canonique, catégorie principale, etc.) | Lecture seule | Comptes pouvant modifier la publication |
update-post-robots-settings |
Met à jour les directives robots d’une publication | Peut modifier des données | Comptes pouvant modifier la publication, si leur rôle n’est pas bloqué pour les metaboxes SEO |
get-post-social-settings |
Lit les métadonnées Facebook/Open Graph et X/Twitter d’une publication | Lecture seule | Comptes pouvant modifier la publication |
update-post-social-settings |
Met à jour les métadonnées Facebook/Open Graph et X/Twitter d’une publication | Peut modifier des données | Comptes pouvant modifier la publication, si leur rôle n’est pas bloqué pour les metaboxes SEO |
analyze-post-content |
Lance l’analyse de contenu sur une publication et renvoie le score, les vérifications et les recommandations | Lecture seule | Comptes pouvant modifier la publication |
list-posts-missing-metadata |
Liste les publications sans titre SEO et/ou sans méta description personnalisés | Lecture seule | Comptes pouvant modifier des publications |
list-posts-by-content-score |
Liste les publications avec le verdict de leur dernière analyse de contenu | Lecture seule | Comptes pouvant modifier des publications |
list-posts-noindexed |
Liste les publications portant une directive noindex explicite | Lecture seule | Comptes pouvant modifier des publications |
get-term-title-description |
Lit le titre SEO et la méta description personnalisés d’un terme de taxonomie (catégorie, étiquette, catégorie de produits, etc.). Depuis la 10.4 | Lecture seule | Comptes pouvant modifier le terme |
update-term-title-description |
Définit ou vide le titre SEO et la méta description d’un terme de taxonomie. Depuis la 10.4 | Peut modifier des données | Comptes pouvant modifier le terme, si leur rôle n’est pas bloqué pour les metaboxes SEO |
get-term-robots-settings |
Lit les directives robots d’un terme de taxonomie (noindex, nofollow, nosnippet, noimageindex, URL canonique). Depuis la 10.4 | Lecture seule | Comptes pouvant modifier le terme |
update-term-robots-settings |
Met à jour les directives robots d’un terme de taxonomie. Une directive imposée par les réglages globaux n’est pas modifiée. Depuis la 10.4 | Peut modifier des données | Comptes pouvant modifier le terme, si leur rôle n’est pas bloqué pour les metaboxes SEO |
get-term-social-settings |
Lit le titre, la description et l’image Facebook/Open Graph et X/Twitter d’un terme de taxonomie. Depuis la 10.4 | Lecture seule | Comptes pouvant modifier le terme |
update-term-social-settings |
Met à jour le titre, la description et l’image Facebook/Open Graph et X/Twitter d’un terme de taxonomie. Depuis la 10.4 | Peut modifier des données | Comptes pouvant modifier le terme, si leur rôle n’est pas bloqué pour les metaboxes SEO |
list-terms-missing-metadata |
Liste les termes de taxonomie sans titre SEO et/ou sans méta description personnalisés. Depuis la 10.4 | Lecture seule | Comptes pouvant modifier les termes d’une taxonomie (seules ces taxonomies sont listées) |
get-global-titles-settings |
Lit les modèles globaux de titres et de méta descriptions | Lecture seule | Comptes pouvant gérer les réglages Titres & métas |
get-sitemap-settings |
Lit la configuration des sitemaps XML et HTML | Lecture seule | Comptes pouvant gérer les réglages Sitemap XML / HTML |
get-instant-indexing-settings |
Lit la configuration de l’Indexation instantanée et le journal des envois. Les clés API ne sont jamais renvoyées | Lecture seule | Comptes pouvant gérer les réglages Indexation instantanée |
get-global-social-settings |
Lit le Knowledge Graph et les réglages sociaux par défaut | Lecture seule | Comptes pouvant gérer les réglages Réseaux sociaux |
Les outils des termes fonctionnent sur les taxonomies publiques dont la metabox SEO est active. Une taxonomie pour laquelle Désactiver la metabox SEO est coché dans SEO > Titres & métas, onglet Taxonomies, est refusée.
SEOPress PRO
| Outil | Ce qu’il fait | Accès | Qui peut l’utiliser |
|---|---|---|---|
list-redirections |
Liste les redirections et les erreurs 404 détectées, avec pagination, recherche et filtres | Lecture seule | Comptes pouvant lire les redirections |
get-redirection |
Lit une redirection | Lecture seule | Comptes pouvant lire les redirections |
create-redirection |
Crée une redirection d’une URL d’origine vers une URL cible | Peut modifier des données | Comptes pouvant publier des redirections |
update-redirection |
Met à jour une redirection existante | Peut modifier des données | Comptes pouvant modifier la redirection |
delete-redirection |
Supprime définitivement une redirection | Peut modifier des données | Comptes pouvant supprimer la redirection |
get-post-schemas |
Lit les données structurées manuelles (schema.org) d’une publication | Lecture seule | Comptes pouvant modifier la publication |
update-post-schemas |
Remplace les données structurées manuelles d’une publication | Peut modifier des données | Comptes pouvant modifier la publication |
update-target-keywords |
Met à jour les mots-clés cibles d’une publication | Peut modifier des données | Comptes pouvant modifier la publication |
generate-seo-title |
Génère une suggestion de titre SEO par IA. La suggestion n’est pas enregistrée | Lecture seule | Comptes pouvant modifier la publication, si leur rôle peut utiliser la génération IA |
generate-meta-description |
Génère une suggestion de méta description par IA. La suggestion n’est pas enregistrée | Lecture seule | Comptes pouvant modifier la publication, si leur rôle peut utiliser la génération IA |
generate-term-seo-title |
Génère par IA une suggestion de titre SEO pour un terme de taxonomie. La suggestion n’est pas enregistrée : enregistrez-la avec update-term-title-description. Depuis la 10.4 |
Lecture seule | Comptes pouvant modifier le terme, si leur rôle peut utiliser la génération IA |
generate-term-meta-description |
Génère par IA une suggestion de méta description pour un terme de taxonomie. La suggestion n’est pas enregistrée : enregistrez-la avec update-term-title-description. Depuis la 10.4 |
Lecture seule | Comptes pouvant modifier le terme, si leur rôle peut utiliser la génération IA |
generate-alt-text |
Génère un texte alternatif et une légende pour une image par IA. La suggestion n’est pas enregistrée | Lecture seule | Comptes pouvant modifier l’image, si leur rôle peut utiliser la génération IA |
upload-image |
Télécharge une image depuis une URL et l’ajoute à la médiathèque | Peut modifier des données | Comptes pouvant téléverser des fichiers (et modifier la publication, si l’image y est attachée) |
get-technical-audit |
Lance les vérifications techniques globales du site et renvoie une liste de contrôle structurée | Lecture seule | Comptes pouvant gérer les outils d’audit de SEOPress PRO |
Les réglages et les outils d’audit sont réservés par défaut aux administrateurs. Les cinq outils generate-* utilisent le fournisseur d’IA configuré dans SEOPress PRO.
Depuis SEOPress 10.4, les outils MCP respectent les restrictions par rôle de SEO > Avancé, onglet Sécurité, comme le fait l’administration WordPress :
- Un rôle coché sous Metaboxes SEO : rôles bloqués ne peut pas utiliser les outils qui modifient les réglages SEO d’une publication ou d’un terme. Il peut toujours utiliser ceux qui les lisent.
- Avec SEOPress PRO, lorsque des rôles sont cochés sous Génération IA, seuls ces rôles (et les administrateurs) peuvent utiliser les outils
generate-*.
Sécurité et permissions
Le serveur MCP est conçu pour que la connexion d’un client IA ne lui donne jamais plus de pouvoir que vous n’en avez déjà.
- Désactivé par défaut. Le point de terminaison refuse toutes les requêtes tant que vous n’avez pas activé l’exposition.
- Vos propres permissions, jamais plus. Une connexion agit au nom du compte WordPress qui l’a approuvée. Chaque appel d’outil passe par les mêmes contrôles de permissions que l’administration WordPress, y compris les restrictions par rôle de l’onglet Sécurité. Un éditeur connecté via MCP ne peut pas lire les réglages SEOPress réservés aux administrateurs, et un auteur ne peut pas modifier les publications des autres.
- Connexions en lecture seule. Choisies sur l’écran d’approbation, et imposées par le serveur pendant toute la durée de vie de la connexion.
- Uniquement les outils SEOPress. Le serveur ne sert que les abilities de SEOPress. Celles enregistrées par d’autres extensions sont retenues, sauf si vous choisissez de les servir.
- Contrôle outil par outil. Vous pouvez désactiver n’importe quel outil pour l’ensemble du site.
- Aucun secret ne quitte votre site. Les clés API stockées dans les réglages de SEOPress ne sont jamais renvoyées par un outil. Les mots de passe d’application créés depuis l’onglet MCP vont de WordPress à votre navigateur et ne sont jamais stockés ni journalisés par SEOPress.
- OAuth 2.1 standard. L’identification repose sur PKCE, l’enregistrement dynamique des clients et des jetons liés à l’adresse de votre site. Les jetons d’accès durent une heure et sont renouvelés automatiquement. Une connexion inutilisée pendant 30 jours doit s’identifier de nouveau.
- Révocable à tout moment. Un clic dans l’onglet MCP coupe immédiatement l’accès d’un client.
Les outils qui modifient des données enregistrent sur votre site en production, exactement comme si vous aviez modifié la publication vous-même. Demandez à votre assistant de vous montrer ce qu’il compte modifier avant de le faire, et utilisez une connexion en lecture seule lorsque vous n’avez besoin que d’un audit.
Gérer la connexion
Clients connectés
La section Clients connectés de l’onglet MCP liste chaque client détenant un jeton pour votre compte : son nom, ce pour quoi il a été approuvé (lecture seule, ou lecture et modification), la date de connexion et la date de dernière utilisation. Cliquez sur Révoquer pour lui couper l’accès. L’effet est immédiat.
Chaque compte ne voit et ne révoque que ses propres connexions. Un compte peut détenir jusqu’à 25 connexions.
Si vous changez l’adresse de votre site, les connexions émises pour l’ancienne adresse sont marquées comme n’étant plus valides. Révoquez-les, puis connectez-vous de nouveau.
Cette liste ne montre que les connexions OAuth. Un client qui s’identifie avec un mot de passe d’application se révoque depuis votre profil WordPress, grâce au lien Gérer les mots de passe d’application de l’onglet MCP.
Choisir les outils servis
La section Outils exposés liste chaque outil avec son niveau d’accès. Utilisez l’interrupteur Servi en fin de ligne pour désactiver un outil, puis enregistrez. Un outil désactivé n’est plus présenté à aucun client et ne peut plus être appelé, quelles que soient les permissions du compte.
C’est utile pour garder un outil sensible pour vous, par exemple delete-redirection.
Abilities des autres extensions
D’autres extensions peuvent enregistrer leurs propres abilities dans WordPress. Par défaut, le serveur MCP de SEOPress ne les sert pas, afin que l’activation de vos outils SEO ne confie jamais par accident à un client IA les outils d’une autre extension.
Pour les servir également, activez Servir aussi les abilities enregistrées par d’autres extensions dans la section Outils exposés. Avant que vous n’enregistriez, l’onglet MCP liste les outils que cela ajouterait. Lisez cette liste : certains peuvent modifier ou supprimer des données.
Dépannage
Le panneau Diagnostics lance neuf vérifications et vous indique quoi corriger pour chacune de celles qui échouent.
| Vérification | En cas d’échec |
|---|---|
| API Abilities de WordPress | Mettez WordPress à jour en version 6.9 ou supérieure. |
| Abilities exposées aux clients externes | Activez Exposer les abilities aux agents IA et aux outils externes dans l’onglet Avancé, puis enregistrez. |
| Route MCP enregistrée | Une autre extension supprime des routes de l’API REST de WordPress. Autorisez la route /seopress/mcp/v1. |
| Réponse du point de terminaison MCP | Une extension de sécurité, un pare-feu ou un CDN bloque la requête, ou votre hébergeur bloque les requêtes en boucle locale (loopback). Autorisez les requêtes POST vers l’URL du serveur MCP. Une réponse HTTP 401 est attendue ici : la vérification appelle le point de terminaison sans identifiants. |
| Mots de passe d’application | Nécessaires uniquement pour les clients qui ne s’identifient pas via OAuth. WordPress ne les propose qu’en HTTPS, et une extension de sécurité peut les désactiver. |
| HTTPS | Installez un certificat TLS et passez l’adresse web de WordPress et l’adresse web du site en https. |
| Permaliens | Simple avertissement : l’URL fonctionne sous sa forme avec paramètre de requête. Choisissez une structure autre que « Simple » pour obtenir une URL plus courte. |
| OAuth pour les clients navigateur | OAuth nécessite HTTPS (ou un site local). Depuis SEOPress 10.4, si le serveur OAuth a été désactivé volontairement avec le filtre seopress_mcp_oauth_enabled, cette ligne est bleue : c’est attendu si vous vous connectez avec un mot de passe d’application. |
| Document de découverte OAuth | Votre serveur ne transmet pas les requêtes /.well-known/ à WordPress. Choisissez une structure de permaliens autre que « Simple ». Si WordPress est installé dans un sous-répertoire, ajoutez une règle qui lui transmet les requêtes /.well-known/. Certains hébergeurs répondent eux-mêmes aux adresses /.well-known/, avant que WordPress ne s’exécute : demandez au vôtre de transmettre /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server à WordPress. En attendant, les onglets Claude et Cursor passent à un mot de passe d’application. |
Quand les vérifications sont vertes mais qu’un client échoue
Les vérifications de disponibilité appellent votre site depuis lui-même : un pare-feu ou un CDN placé devant ne les voit donc jamais. Depuis SEOPress 10.4, l’onglet MCP contient une section Dépannage, sous les étapes de connexion, qui part du message affiché par votre client :
- claude.ai ou ChatGPT est refusé alors que toutes les vérifications sont vertes (par exemple
Dynamic client registration failed: registration endpoint returned 403). claude.ai et ChatGPT appellent votre site depuis leurs propres serveurs, sans navigateur, et une protection anti-bots les traite comme des robots. Autorisez les requêtes GET et POST vers les adresses Registration, Token et MCP server listées dans l’onglet, depuis n’importe quelle adresse IP. Sur Cloudflare, regardez dans Security, Events : si Bot Fight Mode les a bloquées, désactivez-le (avec l’offre gratuite, une règle WAF personnalisée ne peut pas le contourner), ou, avec une offre payante, ajoutez une règle WAF qui ignore la protection anti-bots pour ces adresses. Ajoutez ensuite de nouveau le serveur dans votre client. - claude.ai ou ChatGPT trouve le site, puis ne parvient pas à s’identifier. Le client n’a pas pu lire les documents de découverte OAuth. Ouvrez dans un navigateur les deux adresses listées dans l’onglet : toutes deux doivent répondre en JSON, et non par une page « introuvable ». Si ce n’est pas le cas, demandez à votre hébergeur de les transmettre à WordPress.
- L’application de bureau Claude ne liste pas le serveur. Son fichier de configuration n’accepte que les serveurs qu’elle démarre elle-même : une entrée avec une
urln’est pas prise en charge et peut faire ignorer tous les serveurs du fichier. Utilisez la configurationmcp-remotede l’onglet Claude, vérifiez que Node.js est installé (npx --versionaffiche un numéro de version), quittez complètement l’application et rouvrez-la, puis consultez le journal du serveur dans Settings > Developer. - Claude Code, l’application de bureau ou Cursor est refusé avec une erreur HTTP 401. L’en-tête
Authorizationest incorrect : espace réservé laissé dans la configuration, identifiant d’un autre compte ou mot de passe révoqué. Créez un nouveau mot de passe d’application dans l’onglet, ou relancez la commande Base64 et collez son résultat à la place de l’espace réservé.
Autres situations courantes :
- Le client se connecte mais ne liste aucun outil. Vérifiez la section Outils exposés, ainsi que les permissions de votre compte WordPress.
- La connexion a été approuvée en lecture seule. Un outil de modification est alors refusé. Supprimez la connexion dans votre client, reconnectez-vous et choisissez Lecture et modification.
- Vous n’avez pas la permission d’utiliser un outil. Votre compte WordPress ne dispose pas de la permission requise par cet outil, ou son rôle est restreint dans l’onglet Sécurité.
- Le connecteur échoue dès la première tentative. Ouvrez les deux adresses listées sous Documents de découverte dans la section Clients connectés. Toutes deux doivent répondre en JSON. Si ce n’est pas le cas, une extension de sécurité, un cache ou une règle serveur fait obstacle.
- Un cache ou une couche de sécurité devant le site. Excluez
/wp-json/seopress/mcp/et/.well-known/oauth-*du cache de page, et ne supprimez pas l’en-têteAuthorization. - Une autre extension fait tourner son propre serveur MCP sur le même site. Passez à SEOPress 10.4 ou supérieur. Les versions précédentes répondaient aussi aux requêtes de découverte OAuth destinées à l’autre serveur : ses clients recevaient alors les documents de découverte de SEOPress au lieu des siens. SEOPress ne répond désormais qu’aux adresses de découverte de son propre serveur, et laisse les autres à l’extension concernée.
Pour les développeurs
Le serveur implémente le transport MCP Streamable HTTP sur une unique route REST (POST /wp-json/seopress/mcp/v1) et prend en charge les révisions 2025-06-18, 2025-03-26 et 2024-11-05 du protocole. Il n’expose que des outils (ni ressources, ni prompts).
Chaque outil est une ability WordPress enregistrée avec wp_register_ability() dans l’espace de noms seopress. Les filtres suivants permettent d’ajuster le comportement :
| Filtre | Rôle |
|---|---|
seopress_abilities_api_rest_enabled |
Forcer l’activation ou la désactivation de l’exposition, quel que soit le réglage. |
seopress_mcp_read_only |
Forcer toutes les connexions en lecture seule. |
seopress_mcp_disabled_abilities |
Désactiver des abilities par leur nom. |
seopress_mcp_served_abilities |
Dernier mot sur la liste des abilities servies aux clients. |
seopress_mcp_exposed_namespaces |
Ajouter des espaces de noms d’abilities à servir en plus de seopress. |
seopress_mcp_foreign_namespaces_enabled |
Servir, ou non, les abilities de toutes les autres extensions. |
seopress_mcp_allowed_origins |
Origines autorisées à atteindre le point de terminaison depuis un navigateur. |
seopress_mcp_oauth_enabled |
Désactiver le serveur OAuth. |
seopress_mcp_oauth_transport_is_secure |
Indiquer au serveur OAuth que le site est servi de façon sécurisée, par exemple derrière un proxy qui termine le TLS. |
seopress_remove_feature_mcp |
Renvoyer false pour masquer la carte Serveur MCP du tableau de bord SEO. Depuis la 10.4. |
Exemple : passer toutes les connexions MCP en lecture seule sur un site en production.
add_filter( 'seopress_mcp_read_only', '__return_true' );
Exemple : servir les abilities de votre propre extension aux côtés de celles de SEOPress.
add_filter( 'seopress_mcp_exposed_namespaces', function ( $namespaces ) {
$namespaces[] = 'my-plugin';
return $namespaces;
} );
FAQ
Le serveur MCP est-il disponible dans SEOPress Free ?
Oui. Le serveur et 21 outils sont inclus dans SEOPress Free. SEOPress PRO ajoute 15 outils (redirections, données structurées, mots-clés cibles, génération par IA pour les publications, les termes et les images, import d’image, audit technique).
SEOPress envoie-t-il mon contenu à un fournisseur d’IA ?
Non. SEOPress se contente de répondre aux requêtes du client IA que vous avez connecté. Ce que votre client fait des réponses dépend de ce client et de son fournisseur.
Ai-je besoin d’une clé API OpenAI ou Anthropic ?
Non. Vous utilisez votre propre abonnement ChatGPT, Claude ou Cursor. Seuls les cinq outils generate-* de SEOPress PRO s’appuient sur le fournisseur d’IA configuré dans SEOPress PRO. Notez qu’un abonnement ChatGPT ou Claude n’inclut pas de crédits API.
Plusieurs personnes peuvent-elles connecter leur propre client ?
Oui. Chaque connexion est liée au compte WordPress qui l’a approuvée et limitée aux permissions de ce compte.
Est-ce compatible avec un réseau multisite ?
Chaque site du réseau possède sa propre URL de serveur MCP et son propre réglage.
Comment tout désactiver ?
Désactivez Exposer les abilities aux agents IA et aux outils externes, puis enregistrez. Le point de terminaison et le serveur OAuth cessent immédiatement de répondre.