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.

| Clé | Peut |
|---|---|
| Read | Seulement regarder : métriques, listes, rapports, conversions. Ne peut physiquement rien modifier — sans risque pour commencer |
| Write | Tout 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.
- 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_KEYest copiée. - Dans Claude : Settings → Connectors → Add custom connector, collez l'URL, donnez un nom (Orbitra), Add.
- 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.

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.
- Dans le dépôt :
cd mcp && npm install. - 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"
}
}
}
}
- 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
- Soyez précis sur la période et l'entité : « campagne 12, 7 derniers jours, par pays ».
- Pour des modifications, demandez d'abord un plan : « Montre-moi ce que tu créerais, puis attends mon OK ».
- Le travail en masse est son point fort : « Clone la campagne 12 pour AT et CH, mêmes streams, offre #7 au lieu de la #4 ».
Sécurité
- La clé ne part que vers l'adresse de votre propre tracker.
- Supprimez une clé dans ⚙ → Users et chaque assistant qui l'utilise perd l'accès aussitôt.
- Donnez à l'assistant une clé Read, sauf si vous avez vraiment besoin qu'il modifie des choses.
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érenceGlossaire des abréviations
Les termes de l'affiliation et leurs abréviations expliqués simplement.
Lire le guide →RéférenceBases 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érenceAssistant IA (MCP)
Connectez Claude ou un autre assistant IA à votre tracker via MCP et pilotez-le en langage naturel.
Lire le guide →