Objectif

À la fin de ce guide, votre assistant IA lit vos campagnes, vos leads, vos deals et vos données d'attribution Metrikia directement dans la conversation. La connexion se fait par autorisation depuis votre compte : aucune clé à copier, aucun identifiant à saisir.

Prérequis

Un compte Metrikia actif.
Un assistant IA compatible avec les serveurs MCP distants : Claude (application ou navigateur), Claude Code, Cursor, Windsurf, ChatGPT, Grok.
Rien d'autre. Vous n'avez aucune clé à générer au préalable.

Étape 1. Récupérer l'adresse du serveur

Ouvrez Paramètres, section Intelligence, page MCP Server.
Copiez l'adresse affichée en haut de la page avec le bouton de copie à droite.

Cette adresse est identique pour tous les comptes. Ce sont vos identifiants Metrikia, et non l'adresse, qui déterminent les données auxquelles votre assistant accède.

Étape 2. Ajouter le connecteur dans votre assistant

Claude, application ou navigateur

Ouvrez Paramètres, puis Connecteurs.
Cliquez sur Ajouter un connecteur personnalisé.
Saisissez un nom, par exemple Metrikia, et collez l'adresse du serveur.
Laissez vides les champs OAuth avancés, identifiant et secret client. Metrikia enregistre votre assistant automatiquement.
Validez.

Claude Code

Ajoutez le serveur avec la commande claude mcp add --transport http metrikia https://mcp.metrikia.io/api/v1/mcp puis tapez /mcp dans une session pour lancer la connexion. Le plugin officiel Metrikia fait la même chose et installe en plus les skills et les agents.

Cursor, Windsurf et autres clients

Déclarez un serveur MCP distant avec cette adresse dans la configuration de votre client. Les clients qui gèrent les serveurs MCP distants ouvrent la page d'autorisation tout seuls au premier appel.

Étape 3. Autoriser l'accès

Une page Metrikia s'ouvre dans votre navigateur.
Connectez-vous si vous ne l'êtes pas déjà.
Vérifiez la destination affichée sur l'écran : c'est l'application à laquelle vous donnez accès. N'autorisez que si vous la reconnaissez.
Cliquez sur Autoriser.

L'écran demande deux permissions : lire vos données, et les modifier (créer un lead ou un deal, changer un statut, lancer une synchronisation). Votre assistant reçoit ensuite un accès valable 15 minutes qu'il renouvelle automatiquement, sans vous redemander votre accord.

Résultat attendu

Votre assistant expose 17 outils Metrikia, 13 en lecture et 4 en écriture. Testez avec une question comme : Montre-moi mes 5 meilleures campagnes par ROAS cette semaine, ou : Y a-t-il des anomalies détectées sur mes comptes ?

Problèmes fréquents

Mon assistant ne voit aucun outil Metrikia

Le connecteur est ajouté mais pas connecté. Rouvrez la liste des connecteurs de votre assistant : s'il signale qu'une connexion est nécessaire, relancez l'autorisation. Certains clients demandent un redémarrage après l'ajout.

L'autorisation échoue

Vérifiez que le navigateur qui s'ouvre est connecté au bon compte Metrikia. Si vous gérez plusieurs comptes, déconnectez-vous, puis relancez l'ajout du connecteur depuis votre assistant.

Mon assistant lit mes données mais refuse d'en créer

La permission de modification n'a pas été accordée. Supprimez le connecteur, ajoutez-le de nouveau, et acceptez les deux permissions sur l'écran d'autorisation.

J'utilisais une clé API

Les clés API restent acceptées, mais ne sont plus le mode recommandé : les assistants hébergés comme Claude, ChatGPT ou Grok ne permettent pas d'envoyer un en-tête personnalisé et ne peuvent donc pas s'en servir. Reconnectez vos clients par autorisation, puis révoquez la clé depuis la page MCP Server.

Retirer un accès

Supprimez le connecteur dans votre assistant pour couper l'usage. Pour révoquer définitivement l'autorisation côté Metrikia, contactez le support depuis l'application.

Connecter un assistant IA à Metrikia (MCP)