KI-Assistent (MCP)
Was es ist
MCP (Model Context Protocol) ist ein Standard, mit dem du einem KI-Assistenten — Claude und anderen MCP-Clients — Werkzeug zur Arbeit mit deiner Software gibst. Orbitra bringt einen MCP-Server mit: Nach einmaligem Verbinden schreibst du dem Assistenten einfach:
„Wie liefen meine Kampagnen in den letzten 7 Tagen? Welche hat Geld verloren?"
„Zeig mir gestern Conversions der Kampagne Keto DE nach Ländern."
„Erstelle 5 Kampagnen für Offer #4 — eine pro GEO: DE, AT, CH, FR, IT — auf der Domain go.example.com."
„Füge die Domain promo.example.com hinzu und lege Kampagne 12 auf ihr Root."
„Welche Creatives hatten diese Woche einen ROI unter null?"
Der Assistent ruft die API des Trackers für dich auf: Er liest Statistiken, baut Reports, legt Kampagnen, Offers, Domains, Traffic-Quellen und Landings an und bearbeitet sie (41 Tools insgesamt). Er sieht nur, was dein API-Key erlaubt.
Read-Key oder Write-Key?
Keys legst du unter ⚙ → Users an → die Zahl in der Spalte API keys eines Nutzers → Read key oder Write key.

| Key | Kann |
|---|---|
| Read | Nur ansehen: Metriken, Listen, Reports, Conversions. Kann physisch nichts ändern — sicher zum Starten |
| Write | Alles, was Read kann, plus Kampagnen, Offers, Domains, Quellen und Landings anlegen, bearbeiten und löschen |
Starte mit einem Read-Key. Bittest du einen Read-Key-Assistenten um eine Änderung, antwortet er 403 API key is read-only — dann legst du einen Write-Key an.
Verbinden — Option A: ein Link (am einfachsten)
Funktioniert in den Claude-Apps (Web, Desktop, mobil), nichts zu installieren.
- Lege einen Key an (siehe oben) und klicke neben ihm auf das Link-Symbol — eine fertige URL wie
https://track.example.com/mcp.php?k=YOUR_KEYwird kopiert. - In Claude: Settings → Connectors → Add custom connector, füge die URL ein, gib ihr einen Namen (Orbitra), Add.
- Frage in einem neuen Chat: „Ping meinen Orbitra-Tracker" — der Assistent sollte mit der Version deines Trackers antworten.
🔑 Der Key steckt im Link, behandle den Link also wie ein Passwort: poste ihn nirgendwo. Um den Zugang zu entziehen, lösche den Key — der Link hört sofort auf zu funktionieren.
Die Seite ⚙ → AI / MCP zeigt dieselbe Anleitung, mit der Adresse deines Trackers schon eingetragen.

Verbinden — Option B: lokaler Server für Claude Desktop
Für alle, die den Server lieber auf ihrem eigenen Rechner betreiben. Du brauchst Node.js und eine Kopie des Orbitra-Repositorys.
- Im Repository:
cd mcp && npm install. - In Claude Desktop: Settings → Developer → Edit Config und ergänze:
{
"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"
}
}
}
}
- Beende Claude Desktop vollständig (⌘Q auf dem Mac) und starte es neu.
Der Button Copy config im API-Keys-Fenster liefert dir diesen Block mit deiner Adresse. Erscheint der Server nicht: nutze den absoluten Pfad zu node (which node zeigt ihn), prüfe, ob npm install gelaufen ist, und prüfe den Key mit ORBITRA_URL=… ORBITRA_API_KEY=… npm run smoke -- --ping.
Gute Prompts
- Sei konkret bei Zeitraum und Objekt: „Kampagne 12, letzte 7 Tage, nach Ländern".
- Bei Änderungen erst einen Plan verlangen: „Zeig mir zuerst, was du anlegen würdest, und warte auf mein OK".
- Massenarbeit ist seine Stärke: „Klone Kampagne 12 für AT und CH, dieselben Streams, Offer #7 statt #4".
Sicherheit
- Der Key geht nur an deine eigene Tracker-Adresse.
- Löschst du einen Key unter ⚙ → Users, verliert jeder Assistent, der ihn nutzt, sofort den Zugriff.
- Gib dem Assistenten einen Read-Key, außer du brauchst wirklich, dass er etwas ändert.
Metrics-Spickzettel
Jede Report-Spalte in Orbitra mit ihrer Formel: CR, CPC, CPA, ROI, EPC und mehr.
Guide lesen →ReferenzGlossar der Abkürzungen
Affiliate-Marketing-Begriffe und Abkürzungen, einfach erklärt.
Guide lesen →ReferenzGeo-Datenbanken
Sypex Geo, MaxMind und IP2Location installieren — und warum bessere Geo-Daten das Cloaking verbessern.
Guide lesen →ReferenzKI-Assistent (MCP)
Claude oder einen anderen KI-Assistenten per MCP mit deinem Tracker verbinden und ihn in natürlicher Sprache steuern.
Guide lesen →