Vireo fait tourner un serveur MCP sur votre site WordPress. Une fois un assistant IA connecté, vous pouvez l’interroger en langage naturel sur votre trafic, et il répond à partir de vos propres chiffres en appelant les outils de Vireo. Tous les outils sont en lecture seule : l’assistant peut consulter, jamais modifier.
Comptez une dizaine de minutes, un accès administrateur et l’assistant que vous voulez utiliser.
1. Choisir l’utilisateur sous lequel l’assistant se connecte
L’assistant se connecte comme un utilisateur WordPress et voit exactement ce que cet utilisateur voit dans le tableau de bord de Vireo. Seuls les utilisateurs qui peuvent ouvrir le tableau de bord peuvent se connecter : les administrateurs, plus les rôles que vous avez cochés sous Réglages > Général, « Rôles ayant accès ». Voir Qui peut voir les chiffres.
Si vous ne voulez pas que l’assistant utilise un compte administrateur, créez un utilisateur dont le rôle donne accès au tableau de bord, et rien de plus, puis connectez-vous avec lui.
2. Créer un mot de passe d’application
- Dans WordPress, allez dans Utilisateurs > Profil (ou modifiez l’utilisateur de l’étape 1).
- Descendez jusqu’à Mots de passe d’application. Saisissez un nom d’après l’assistant, par exemple « Claude Desktop », puis cliquez sur « Ajouter un mot de passe d’application ».
- Copiez le mot de passe affiché par WordPress. Il ne s’affiche qu’une seule fois. Vous pouvez garder les espaces.
Les réglages de Vireo renvoient directement à cet écran : Vireo Analytics > Réglages > Search Console et API, « Connecter un assistant IA », « Créez-en un sur votre profil ».
Pour couper l’accès d’un assistant plus tard, révoquez son mot de passe au même endroit.
3. Copier votre point de terminaison et la configuration
Allez dans Vireo Analytics > Réglages, ouvrez l’onglet Search Console et API et trouvez « Connecter un assistant IA ». Vous y voyez :
- votre « Point de terminaison MCP », c’est-à-dire l’adresse de votre site suivie de
/wp-json/vireo-analytics/mcp - une commande toute prête pour Claude Code
- une configuration toute prête pour Claude Desktop, Cursor et d’autres
Votre nom d’utilisateur est déjà renseigné. Chacune a un bouton Copier. Collez votre mot de passe d’application à l’endroit où l’extrait indique APP_PASSWORD.
4. L’ajouter à Claude Code
Lancez dans un terminal la commande affichée sur l’écran des réglages. Elle ressemble à ceci :
claude mcp add --transport http vireo-analytics https://example.com/wp-json/vireo-analytics/mcp --header "Authorization: Basic $(printf 'your-username:APP_PASSWORD' | base64)"
Lancez claude mcp list pour vérifier que la connexion est établie, puis démarrez Claude Code et posez vos questions.
Ou l’ajouter à Claude Desktop
Claude Desktop se connecte via @automattic/mcp-wordpress-remote, un petit proxy qui tourne sur votre ordinateur et parle à votre site en HTTPS. Il faut que Node.js soit installé.
- Ouvrez les Settings de Claude Desktop, puis Developer, et cliquez sur Edit Config.
- Collez la configuration de l’écran des réglages dans
claude_desktop_config.json. Si le fichier contient déjà une sectionmcpServers, ajoutez-y l’entréevireo-analytics.
{
"mcpServers": {
"vireo-analytics": {
"command": "npx",
"args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
"env": {
"WP_API_URL": "https://example.com/wp-json/vireo-analytics/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "APP_PASSWORD"
}
}
}
}
- Quittez Claude Desktop et rouvrez-le. Les outils de Vireo apparaissent dans le menu des outils d’une nouvelle conversation.
Ou l’ajouter à Cursor
Ajoutez la même entrée mcpServers à ~/.cursor/mcp.json pour tous vos projets, ou à .cursor/mcp.json pour un seul. Ouvrez les réglages de Cursor, MCP, pour vérifier que le serveur apparaît comme connecté.
5. Poser votre première question
Commencez par quelque chose de large :
Comment va le site ce mois-ci par rapport au mois dernier ?
L’assistant devrait appeler vireo-analytics-get-changes et répondre avec l’évolution des pages vues, les pages et les sources qui l’expliquent, et d’éventuels avertissements, par exemple si le suivi s’est arrêté.
Questions à essayer
| Demandez | Outils probablement appelés |
|---|---|
| Quels articles ont eu le plus de vues la semaine dernière ? | get-top-pages |
| D’où venaient les visiteurs ce mois-ci ? | get-traffic-sources, puis get-top-referrers |
| Qu’est-ce que Hacker News nous a envoyé, et vers quels articles ? | get-referrer-detail |
| Qu’ont tapé les gens sur Google pour trouver ma page de tarifs ? | get-search-console |
| Quelle part prennent les robots d’IA par rapport aux lecteurs que les assistants IA envoient ? | get-ai-referrals, get-bot-stats |
| Ai-je des liens cassés ? | get-404s |
| Pourquoi le trafic a-t-il explosé le 3 ? | get-daily-stats, get-annotations, get-changes |
| Lesquelles de mes pages sont lentes pour les vrais visiteurs ? | get-vitals |
| Rédige-moi un résumé de mon année. | get-year-review |
Sur le serveur, les noms d’outils commencent par vireo-analytics-, par exemple vireo-analytics-get-top-pages. La liste complète est dans la référence de l’API.
Les questions sur Search Console demandent que Search Console soit connectée. Si elle ne l’est pas, l’outil le dit et l’assistant devrait vous le signaler.
Ce qu’ajoute Vireo Pro
Avec une licence Vireo Pro active, le même serveur propose aussi les outils de Pro, et vous pouvez demander :
| Demandez | Outils |
|---|---|
| Quelles sources ont rapporté de l’argent le mois dernier ? | get-revenue-by-source |
| Quels articles de blog mènent à des ventes ? | get-revenue-by-landing-page |
| Combien de personnes sont sur le site en ce moment ? | get-realtime |
| La campagne de la newsletter d’octobre a-t-elle amené du trafic ? | get-campaigns |
| À quel endroit les gens abandonnent-ils mon tunnel de commande ? | get-funnels, get-store-funnel |
| Quelles pages les gens lisent-ils vraiment jusqu’au bout ? | get-engagement |
Les outils de boutique apparaissent quand WooCommerce, Easy Digital Downloads, FluentCart ou Freemius est actif.
Si les sites de vos clients remontent vers cette installation comme sites connectés, la même connexion peut répondre pour chacun d’eux : voir Interroger un seul assistant IA sur tous les sites de vos clients. Sur un site gratuit, le serveur indique à l’assistant les questions auxquelles Pro répond.
Avec Vireo Pro, vous pouvez aussi vous passer de cette configuration et poser vos questions dans WordPress : Ask Vireo utilise les mêmes outils via le fournisseur d’IA que vous avez configuré sous Réglages > Connecteurs. Si les sites de vos clients sont des enfants MainWP, connectez plutôt l’assistant au tableau de bord MainWP : voir Avec un tableau de bord MainWP. Interroger Claude sur vos statistiques WordPress montre les questions par lesquelles commencer, et poser vos questions depuis wp-admin fait de même avec Ask Vireo.
Si vous obtenez une erreur 401
WordPress n’a pas accepté l’identification. Vérifiez que :
- le nom d’utilisateur est l’identifiant de connexion, pas l’e-mail ni le nom affiché
- le mot de passe d’application est collé en entier et n’a pas été révoqué
- pour Claude Code, la partie
printfestusername:passwordentre apostrophes, sans espace autour des deux-points
Si vous obtenez une erreur 403
WordPress sait qui vous êtes, mais cet utilisateur ne peut pas voir les chiffres de Vireo. Connectez-vous en administrateur, ou donnez accès au rôle de l’utilisateur sous Réglages > Général, « Rôles ayant accès ».
Si les mots de passe d’application manquent dans le profil
WordPress ne propose les mots de passe d’application que sur les sites servis en HTTPS, sauf si le site est déclaré comme environnement de développement local. Certains plugins de sécurité et certains hébergeurs les désactivent aussi, ou bloquent l’API REST pour les requêtes non connectées. Autorisez les mots de passe d’application, et les requêtes vers /wp-json/vireo-analytics/, pour l’utilisateur avec lequel vous vous connectez.
Si l’adresse commence par http://
Utilisez exactement le point de terminaison de l’écran des réglages, https:// compris. Si vous saisissez http:// et que votre site redirige vers HTTPS, certains clients perdent l’identification lors de la redirection et obtiennent une 401.
Si les outils n’apparaissent pas
- Claude Desktop et Cursor ont besoin de Node.js, car le proxy passe par
npx. Installez-le et redémarrez l’application. - Redémarrez l’assistant après avoir modifié sa configuration.
- Si l’écran des réglages affiche « L’adaptateur MCP fourni est absent de cette installation », réinstallez Vireo à partir de son paquet de publication.
Si la connexion MCP d’un autre plugin ne fonctionne plus
Rank Math, et WooCommerce avec sa fonction MCP activée, exposent leurs propres outils via le point de terminaison partagé du MCP Adapter, à /wp-json/mcp/mcp-adapter-default-server. Mettez Vireo Analytics à jour vers la version 0.12.5 ou une version plus récente, qui laisse ce point de terminaison partagé à ces plugins dès qu’un autre plugin utilise l’adapter. Le point de terminaison propre à Vireo est /wp-json/vireo-analytics/mcp.
Si les chiffres semblent faux
L’assistant voit les mêmes chiffres que votre tableau de bord. Si une réponse paraît étrange, ouvrez la même période dans la Vue d’ensemble. Les dates couvrent par défaut les 30 derniers jours, dans le fuseau horaire de votre site.