Référence

Assistant IA (MCP)

De quoi s'agit-il

MCP (Model Context Protocol) est une façon standard de donner à un assistant IA — Claude et d'autres clients MCP — des outils pour travailler avec votre logiciel. Orbitra embarque un serveur MCP : après une connexion unique, vous pouvez simplement écrire à l'assistant :

« Comment mes campagnes ont-elles performé sur les 7 derniers jours ? Laquelle a perdu de l'argent ? »
« Montre-moi les conversions d'hier de la campagne Keto DE par pays. »
« Crée 5 campagnes pour l'offre #4 — une par GEO : DE, AT, CH, FR, IT — sur le domaine go.example.com. »
« Ajoute le domaine promo.example.com et mets la campagne 12 sur sa racine. »
« Quelles créas ont eu un ROI négatif cette semaine ? »

L'assistant appelle l'API du tracker pour vous : il lit les statistiques, construit des rapports, crée et modifie campagnes, offres, domaines, sources de trafic et landings (41 outils au total). Il ne voit que ce que votre clé API autorise.

Clé de lecture ou clé d'écriture ?

Les clés se créent dans ⚙ → Users → le chiffre dans la colonne API keys d'un utilisateur → Read key ou Write key.

Créer une clé API
Créer une clé API
CléPeut
ReadSeulement regarder : métriques, listes, rapports, conversions. Ne peut physiquement rien modifier — sans risque pour commencer
WriteTout ce que Read peut, plus créer, modifier et supprimer campagnes, offres, domaines, sources, landings

Commencez avec une clé Read. Si vous demandez à un assistant doté d'une clé Read de modifier quelque chose, il répond 403 API key is read-only — créez alors une clé Write.

Connexion — option A : un lien (le plus simple)

Fonctionne dans les applis Claude (web, desktop, mobile), rien à installer.

  1. Créez une clé (voir plus haut) et appuyez sur l'icône lien à côté — une URL prête comme https://track.example.com/mcp.php?k=YOUR_KEY est copiée.
  2. Dans Claude : Settings → Connectors → Add custom connector, collez l'URL, donnez un nom (Orbitra), Add.
  3. Dans un nouveau chat, demandez « Ping my Orbitra tracker » — l'assistant devrait répondre avec la version de votre tracker.

🔑 La clé est à l'intérieur du lien, alors traitez le lien comme un mot de passe : ne le publiez nulle part. Pour couper l'accès, supprimez la clé — le lien cesse de fonctionner immédiatement.

La page ⚙ → AI / MCP montre les mêmes instructions avec l'adresse de votre tracker déjà remplie.

La page AI / MCP
La page AI / MCP

Connexion — option B : serveur local pour Claude Desktop

Pour ceux qui préfèrent faire tourner le serveur sur leur propre ordinateur. Il vous faut Node.js et une copie du dépôt Orbitra.

  1. Dans le dépôt : cd mcp && npm install.
  2. Dans Claude Desktop : Settings → Developer → Edit Config et ajoutez :
{
  "mcpServers": {
    "orbitra": {
      "command": "/usr/local/bin/node",
      "args": ["/absolute/path/to/Orbitra/mcp/src/index.js"],
      "env": {
        "ORBITRA_URL": "https://track.example.com",
        "ORBITRA_API_KEY": "your-api-key"
      }
    }
  }
}
  1. Quittez complètement Claude Desktop (⌘Q sur Mac) et relancez-le.

Le bouton Copy config dans la fenêtre des clés API vous donne ce bloc avec votre adresse. Si le serveur n'apparaît pas : utilisez le chemin absolu vers node (which node l'affiche), vérifiez que npm install a bien tourné, et testez la clé avec ORBITRA_URL=… ORBITRA_API_KEY=… npm run smoke -- --ping.

Bons prompts

Sécurité

Référence : MCP, API REST.

← Précédent
Bases de données geo
Suivant →
Démarrage rapide : votre première campagne
Voir la source sur GitHub: github.com/fenjo26/Orbitra.link/wiki
Tous les guides
Référence

Aide-mémoire des métriques

Chaque colonne de rapport d'Orbitra avec sa formule : CR, CPC, CPA, ROI, EPC et plus.

Lire le guide →
Référence

Glossaire des abréviations

Les termes de l'affiliation et leurs abréviations expliqués simplement.

Lire le guide →
Référence

Bases de données geo

Installez Sypex Geo, MaxMind et IP2Location, et pourquoi de meilleures données geo améliorent le cloaking.

Lire le guide →
Référence

Assistant IA (MCP)

Connectez Claude ou un autre assistant IA à votre tracker via MCP et pilotez-le en langage naturel.

Lire le guide →