Menu de la documentationConnecter Claude ou Cursor à votre site

Connecter Claude ou Cursor à votre site

Connectez Claude Code, Claude Desktop ou Cursor au serveur MCP de Vireo, posez vos premières questions sur votre trafic et réglez les problèmes de connexion.

Sur cette page

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

  1. Dans WordPress, allez dans Utilisateurs > Profil (ou modifiez l’utilisateur de l’étape 1).
  2. 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 ».
  3. 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é.

  1. Ouvrez les Settings de Claude Desktop, puis Developer, et cliquez sur Edit Config.
  2. Collez la configuration de l’écran des réglages dans claude_desktop_config.json. Si le fichier contient déjà une section mcpServers, ajoutez-y l’entrée vireo-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"
      }
    }
  }
}
  1. 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 printf est username:password entre 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.