MCP (assistants IA)

MCP (assistants IA)

MetriXs expose un endpoint MCP en lecture seule (Model Context Protocol) pour interroger vos statistiques depuis un assistant IA : « combien de visiteurs mon site a-t-il eus cette semaine, et d’où venaient-ils ? », avec de vraies données au lieu d’une estimation.

Endpoint : https://mcp.metrixs.eu/api/mcp

MetriXs n’appelle jamais un fournisseur d’IA lui-même. Vous connectez votre propre assistant avec vos propres identifiants ; seuls des chiffres statistiques agrégés vont vers le chat que vous avez choisi.

Agences : les clients ne peuvent pas connecter le serveur MCP

Les comptes clients des paliers Agency ne peuvent pas utiliser le serveur MCP : l’écran de consentement refuse systématiquement les comptes clients, et les clients ne peuvent pas non plus créer de clés API dans le tableau de bord. Si un client veut un accès IA à ses statistiques, l’agence crée une clé API de site (Paramètres → Sites → Clés API) et la partage avec lui. La clé reste épinglée à ce seul site et en lecture seule.

Deux façons de connecter

1. Clé API (Claude Code, Codex CLI, Gemini CLI, VS Code / GitHub Copilot, Cursor, JetBrains)

1. Dans le tableau de bord, ouvrez Paramètres → Sites et créez une clé API pour le site à partager. La clé n’est affichée qu’une seule fois.
2. Ajoutez le serveur dans votre client avec l’URL ci-dessus et l’en-tête Authorization: Bearer <clé> :

Client	Emplacement
Claude Code	claude mcp add metrixs --transport http https://mcp.metrixs.eu/api/mcp --header "Authorization: Bearer <clé>"
VS Code / GitHub Copilot	.vscode/mcp.json → servers.metrixs avec type: "http", l’URL et l’en-tête
Codex CLI	~/.codex/config.toml → [mcp_servers.metrixs] avec url + bearer_token_env_var
Gemini CLI	~/.gemini/settings.json → mcpServers.metrixs avec httpUrl + headers
Cursor	Paramètres MCP → ajouter un serveur personnalisé (HTTP) avec l’URL et l’en-tête
JetBrains AI Assistant	Paramètres → MCP, ajouter un serveur distant avec l’URL et l’en-tête

2. OAuth (Claude Desktop, connecteurs ChatGPT, Cursor, JetBrains)

1. Dans votre assistant, ajoutez un serveur MCP distant personnalisé / connecteur avec l’URL ci-dessus. Claude Desktop et ChatGPT ne prennent en charge que ce flux : une clé API simple y est refusée.
2. L’assistant ouvre une page MetriXs dans votre navigateur. Connectez-vous, choisissez un site et autorisez l’accès.
3. C’est fait. L’assistant peut maintenant lire les statistiques de ce site.

Chaque connexion OAuth apparaît comme une clé API nommée MCP: <assistant> dans Paramètres → Sites → Clés API. Supprimer cette ligne révoque la connexion instantanément, sessions actives comprises.

Outils disponibles (tous en lecture seule)

list_sites, get_current_visitors, get_overview, get_timeseries, get_breakdown (pages, sources, pays, appareils, UTM, …), get_events, get_event_props, get_revenue, get_funnel, get_top_products (sites e-commerce), get_ai_traffic, get_blocked_bots, get_security_audit (dernier audit de sécurité, plans Team, Pro et Agency).

Confidentialité

• Lecture seule : aucun outil ne peut modifier les réglages, les sites ou les données.
• Un site par connexion : une clé est liée à un seul site ; les assistants ne voient jamais au-delà.
• Agrégats uniquement : aucun identifiant de visiteur n’existe à divulguer ; les IDs visiteurs sont des hachages à rotation quotidienne et ne figurent dans aucune réponse d’outil.
• Hébergé dans l’UE : MetriXs n’appelle jamais d’IA. Votre assistant parle à MetriXs ; MetriXs ne parle jamais à un fournisseur d’IA.