Aller au contenu principal

Connecter une IA externe (MCP)

Outre l'Analyste IA intégré, Qubix peut être connecté à votre propre assistant IA — Claude Desktop, Claude Code, Cursor ou tout client prenant en charge MCP (Model Context Protocol). L'assistant répond alors à vos questions sur vos campagnes en s'appuyant sur des données en temps réel — avec exactement les mêmes accès et permissions que ceux dont vous disposez dans l'interface.

Ce dont vous avez besoin​

  • Un token personnel (PAT) — créez-le sur la page MCP/API. Plus de détails — MCP/API.
  • Votre adresse Qubix sous la forme https://<your-domain>/api/mcp.
Le token n'est affiché qu'une seule fois

Le token n'est affiché qu'au moment où vous le créez. Copiez-le immédiatement et conservez-le en lieu sûr — Qubix ne stocke que son hash et ne peut pas l'afficher de nouveau. Vous l'avez perdu ? Cliquez sur Regénérer pour en obtenir un nouveau (l'ancien cesse de fonctionner immédiatement).

Comment se connecter​

Vous avez besoin de deux éléments : l'adresse https://<your-domain>/api/mcp et l'en-tête Authorization: Bearer <your-token>. Le reste dépend du client.

Claude Code (CLI)​

Bash
claude mcp add --transport http qubix https://<your-domain>/api/mcp \
  --header "Authorization: Bearer qbx_YOUR_TOKEN"

Redémarrez Claude Code — les outils Qubix deviennent disponibles dans le chat.

Claude Desktop​

Ouvrez Settings → Connectors → Add custom connector, indiquez l'adresse https://<your-domain>/api/mcp et ajoutez l'en-tête Authorization: Bearer qbx_YOUR_TOKEN.

Cursor​

Ajoutez le serveur à ~/.cursor/mcp.json (ou au .cursor/mcp.json du projet) :

JSON
{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

Ce que l'assistant peut faire​

Une fois connecté, l'assistant peut lire vos analyses et effectuer des actions — le tout dans les limites de vos permissions :

  • Analytique — le tableau de bord, le géo, les offres, les réseaux, les sources de trafic, les écrans Facebook, le tunnel de visiteurs, ainsi qu'une analyse détaillée de n'importe quelle annonce, campagne, offre, créa, PWA, géo ou source de trafic.
  • Créas — la recherche sémantique (« trouver des créas ressemblant à une capture de faux chat ») et les thèmes de créas les plus performants.
  • Britva — consulter les règles d'automatisation, les annonces en pause et l'historique des déclenchements ; créer, modifier et publier des règles.
  • Actions — mettre en pause et reprendre des annonces et des campagnes ; gérer les offres, les réseaux, les sources de trafic et les campagnes du tracker.
  • Requêtes libres — pour les questions que les outils prêts à l'emploi ne couvrent pas.
Vos données uniquement

L'assistant voit exactement ce que vous voyez dans l'interface : un administrateur obtient tout le compte, un buyer n'obtient que les données de son équipe. Les actions sont limitées par vos permissions, tout comme dans le panneau d'administration.

Les actions sont réelles

Mettre en pause une annonce, supprimer une règle ou une offre via l'assistant modifie vos campagnes réelles. Dans les clients de chat, ces actions ne sont effectuées qu'après votre confirmation — lisez ce que l'assistant propose avant d'approuver.

Sécurité​

  • Le token est votre clé d'accès — traitez-le comme un mot de passe, ne le placez pas dans des fichiers partagés ou des dépôts publics.
  • Un token par utilisateur. Pour révoquer l'accès, ouvrez la page MCP/API et cliquez sur Révoquer (ou Regénérer pour le remplacer).

Et ensuite​

Chat de l'Analyste IA

l'assistant intégré, sans configuration nécessaire.

MCP/API

l'endpoint, votre token et le catalogue complet des méthodes.

IA (aperçu)

les données d'analyse derrière les outils.

On this page