Aller au contenu

Connecter un assistant IA (MCP)

Mis à jour le 18 octobre 2026

Le protocole MCP (Model Context Protocol) permet aux assistants IA d'utiliser vos données Statsdot. Une fois connecté, vous pouvez poser des questions telles que « Quelles pages ont attiré le plus de visiteurs depuis Google la semaine dernière ? » ou « Comparez septembre avec août pour shop.example.com » et l'assistant lit les chiffres depuis Statsdot.

L'adresse du serveur est https://statsdot.com/api/mcp. Claude et ChatGPT se connectent via OAuth : vous vous connectez à Statsdot et approuvez la connexion. Les outils de développement tels que Claude Code, Cursor et Codex utilisent les mêmes jetons d'accès personnels que l'API REST.

Claude et ChatGPT (OAuth)

Claude

Dans Claude (web, bureau ou mobile), ouvrez Paramètres > Connecteurs, choisissez Ajouter un connecteur personnalisé et saisissez https://statsdot.com/api/mcp. Claude ouvre une page Statsdot : connectez-vous si nécessaire et choisissez Autoriser.

ChatGPT

Dans ChatGPT, ouvrez Paramètres > Applications et connecteurs, activez le mode développeur sous Avancé si votre formule le nécessite, créez un connecteur avec l'URL https://statsdot.com/api/mcp et choisissez OAuth comme authentification. Approuvez la connexion sur la page Statsdot qui s'ouvre.

Les connexions effectuées de cette manière sont en lecture seule : l'assistant peut interroger vos statistiques mais ne peut pas modifier les sites, les objectifs, les notes ou votre équipe. Elles apparaissent sous Assistants connectés sur la page API et MCP, où vous pouvez les déconnecter. Une connexion inutilisée expire après 30 jours.

Outils de développement (jeton d'accès)

1. Créer un jeton

Sur la page API et MCP de votre compte, créez un jeton. Lecture seule suffit pour poser des questions. Choisissez lecture et écriture uniquement si vous souhaitez que l'assistant ajoute des sites, des objectifs ou des membres d'équipe.

2. Connecter votre assistant

Claude Code

claude mcp add --transport http statsdot https://statsdot.com/api/mcp \
  --header "Authorization: Bearer 12|your-token"

Cursor

Dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "statsdot": {
      "url": "https://statsdot.com/api/mcp",
      "headers": { "Authorization": "Bearer 12|your-token" }
    }
  }
}

Codex

Dans ~/.codex/config.toml :

[mcp_servers.statsdot]
url = "https://statsdot.com/api/mcp"
http_headers = { "Authorization" = "Bearer 12|your-token" }

Les autres clients prenant en charge les serveurs MCP distants via HTTP avec un en-tête personnalisé fonctionnent de la même manière.

Outils

Outil Fonction
get-account Votre formule, événements utilisés et inclus, limites
list-sites Sites que vous pouvez voir, avec leurs identifiants
get-overview Visiteurs, pages vues, taux de rebond et durée de visite, comparés à la période précédente
get-timeseries Visiteurs et pages vues par jour ou par mois
get-breakdown Pages principales, pages d'entrée et de sortie, référents, campagnes, pays, appareils, navigateurs, systèmes, événements
get-goal-results Objectifs avec conversions et taux de conversion
get-realtime Visiteurs au cours des cinq dernières minutes
get-bot-traffic Robots d'indexation IA qui lisent le site et les pages qu'ils ont demandées
list-funnels, get-funnel-results, create-funnel, delete-funnel Tunnels de conversion et visiteurs à chaque étape
create-site, update-site, delete-site Gérer les sites, y compris les alertes et l'objectif principal (jetons d'écriture)
create-goal, delete-goal Gérer les objectifs (jetons d'écriture)
list-notes, create-note, delete-note Notes sur le graphique expliquant les changements de trafic
list-team, invite-team-member, remove-team-member Gérer votre équipe (jetons d'écriture)

Les outils de lecture sont marqués comme lecture seule, et les outils de suppression sont marqués comme destructifs ; les assistants demandent donc confirmation avant de les utiliser. Les plages et les filtres fonctionnent comme dans l'API.

Confidentialité

L'assistant voit les mêmes statistiques agrégées que votre tableau de bord. Statsdot ne stocke aucune donnée personnelle sur vos visiteurs, il n'y a donc aucune donnée à partager. Révoquez le jeton ou déconnectez l'assistant sur la page API et MCP pour couper la connexion à tout moment.