MCP: ein KI-Assistent im Tracker
Ab Version 0.9.5.0 kannst du einen KI-Assistenten (Claude Desktop und andere MCP-Clients) über den MCP-Server an Orbitra anbinden — er liegt im Ordner mcp/. Einmal verbunden, lässt sich der Tracker in natürlicher Sprache steuern:
„Wie liefen meine Kampagnen in den letzten 7 Tagen?“
„Lege 10 Kampagnen für Offer #4 an — eine pro GEO: US, CA, GB, DE, FR.“
„Füge die Domain track.example.com hinzu und lege Kampagne 12 auf ihr Root.“
Der Server spricht über HTTPS mit deinem Tracker, mit einem persönlichen API-Key. Er speichert nichts auf seiner eigenen Seite, und Read-only-Keys können physisch nichts ändern.
Wie es funktioniert
Claude Desktop ──stdio──► mcp/src/index.js ──HTTPS + API key──► ваш Orbitra (api.php)
Der MCP-Server ist ein Thin Client über die normale API des Trackers (api.php). Er wrappt API-Aktionen lediglich in Tools, die eine KI versteht, und baut eine Sicherung ein (Read-Keys können nicht schreiben).
Schritt 1. API-Key besorgen
Im Panel: ⚙ → AI / MCP oder ⚙ → Users → API keys (Keys legt ein Admin an).
- Read key — nur Analytics (Metriken, Listen, Reports).
- Write key — plus Verwaltung (Kampagnen, Offers, Domains … anlegen/bearbeiten/löschen).
Der Key wird nur einmal gezeigt — kopiere ihn.
Schritt 2. Abhängigkeiten installieren
Bei der Installation über install.sh kommen die MCP-Abhängigkeiten automatisch mit. Manuell:
cd mcp
npm install
Selbstcheck (startet den Server und gibt die Tool-Liste aus; kein echter Tracker nötig):
npm run smoke
Gegen einen echten Tracker prüfen:
ORBITRA_URL=https://tracker.example.com ORBITRA_API_KEY=your_key npm run smoke -- --ping
Schritt 3. Claude Desktop verbinden
Die Konfigurationsdatei von Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Option A. Verbindung per URL (ab Version 0.9.6.2)
Die schnellste Option und die einzige, die in der Browser-Version von Claude funktioniert: Der Tracker selbst serviert MCP über HTTP durch mcp.php.
- ⚙ → Users → API keys, Key anlegen (Read — nur Analytics, Write — plus Verwaltung).
- Den Link-Button neben dem Key anklicken — eine fertige URL landet in der Zwischenablage:
https://ваш-трекер.example.com/mcp.php?k=ВАШ_КЛЮЧ
- In Claude: Settings → Connectors → Add custom connector, URL einfügen, Namen vergeben, „Add“.
Nichts zu installieren — weder Node noch das Repository auf deinem Rechner.
🔑 Der Key reist direkt in der URL mit, denn der Connector-Dialog hat kein Feld für einen Key und unterstützt nur OAuth. Behandle so eine URL wie ein Passwort: Veröffentliche sie nicht, und um den Zugriff zu kappen, lösche den Key in ⚙ → Users → API keys — die URL hört sofort auf zu funktionieren. Ein Read-Key kann physisch nichts ändern.
Wie es funktioniert. mcp.php implementiert sessionloses MCP Streamable HTTP: Jeder POST ist ein in sich abgeschlossener JSON-RPC-Austausch. Die Tool-Liste nimmt er aus mcp/tools.json, die aus dem Node-Server generiert wird (node mcp/src/manifest.js) — beide Verbindungstypen zeigen also exakt denselben Satz von 41 Tools. Ein Tool-Call läuft als kurzer CLI-Prozess cli/api_invoke.php — der Tracker ruft sich nicht selbst über HTTP auf, was auf einem VPS mit zwei PHP-FPM-Workern sonst die ganze Site blockieren könnte.
Voraussetzungen: PHP CLI (braucht der Cron ohnehin) und erlaubtes proc_open. Ist proc_open in der php.ini deaktiviert, sagt dir der Endpunkt das im Klartext — nimm in dem Fall Option B. Den PHP-Pfad kannst du manuell über die Einstellung mcp_php_binary setzen.
Option B. Lokaler Server für Claude Desktop
⚠️ Das ist nicht der „Add custom connector“-Dialog. Der Connectors-Bereich in Claude akzeptiert nur remote MCP-Server über HTTPS und autorisiert sie per OAuth — deshalb gibt es dort kein API-Key-Feld. Der Orbitra-Server läuft über stdio: Er startet lokal neben dem Assistenten und wird in der unten stehenden Konfigurationsdatei registriert. Eine Tracker-URL im Connector-Dialog funktioniert nicht.
Die Datei öffnest du direkt aus der App: Settings → Developer → Edit Config.
Füge einen orbitra-Server hinzu (nutze den absoluten Pfad zu mcp/src/index.js):
{
"mcpServers": {
"orbitra": {
"command": "/usr/local/bin/node",
"args": ["/absolute/path/to/Orbitra/mcp/src/index.js"],
"env": {
"ORBITRA_URL": "https://tracker.example.com",
"ORBITRA_API_KEY": "ваш-api-ключ"
}
}
}
}
Beende Claude Desktop vollständig (⌘Q unter macOS) — die Orbitra-Tools erscheinen in der Liste. Das Fenster schließen reicht nicht; die Konfiguration wird nur beim Start gelesen.
Wenn der Server nicht auftaucht:
- Node-Pfad.
commandbraucht einen absoluten Pfad: Die App startet nicht aus deiner Shell, deshalb erreicht Node aus nvm oder Homebrew seinPATHnie, und der Server scheitert still beim Start. Den Pfad findest du mitwhich node(macOS/Linux) oderwhere node(Windows). - Abhängigkeiten nicht installiert.
cd mcp && npm install. - Falscher Key oder falsche URL. Separat verifizieren:
ORBITRA_URL=... ORBITRA_API_KEY=... npm run smoke -- --ping. 403 API key is read-onlybeim Anlegen oder Update — du brauchst einen Write-Key; ein Read-Key liefert nur Analytics.
Tools (41)
Lesen: orbitra_ping, orbitra_get_metrics, orbitra_get_chart, orbitra_list_campaigns, orbitra_campaigns_stats, orbitra_get_campaign, orbitra_campaign_report, orbitra_list_offers, orbitra_get_offer, orbitra_all_offers, orbitra_list_domains, orbitra_ssl_environment, orbitra_get_integration_code, orbitra_list_app_configs, orbitra_telegram_status, orbitra_integrations_status, orbitra_list_traffic_sources, orbitra_list_landings, orbitra_list_affiliate_networks, orbitra_list_conversions, orbitra_recent_clicks, orbitra_system_status.
Verwaltung (braucht einen Write-Key): orbitra_create_campaign, orbitra_update_campaign, orbitra_bulk_create_campaigns, orbitra_bulk_set_campaign_domain, orbitra_delete_campaign, orbitra_copy_campaign, orbitra_create_offer, orbitra_update_offer, orbitra_delete_offer, orbitra_create_domain, orbitra_delete_domain, orbitra_check_domain_dns, orbitra_reissue_ssl, orbitra_run_ssl_worker, orbitra_save_app_config, orbitra_create_traffic_source, orbitra_list_traffic_source_templates, orbitra_create_landing.
Fortgeschritten: orbitra_api_request — jede api.php-Aktion direkt aufrufen (die Fallback-Option).
Große Accounts. orbitra_list_campaigns und orbitra_list_domains liefern kompakte Listen (id, name, alias, domain, link) mit ID-Range- und Domain-Filtern sowie Pagination — die Antwort bleibt klein, auch bei Tausenden Kampagnen. Stats für alle Kampagnen kommen aus orbitra_campaigns_stats (eine schwere Antwort), für eine einzelne — orbitra_campaign_report. Die Domain vieler Kampagnen auf einmal ändern — orbitra_bulk_set_campaign_domain: Nur die Domain ändert sich, Streams und Postbacks bleiben unberührt, und die Antwort trägt den alten und den neuen Link jeder Kampagne. orbitra_update_campaign erhält Stream-IDs, deren Namen, die Filter-Logik, die Offer-Auswahl und die Bot Challenge.
Die vollständige Parameter-Referenz liegt in mcp/README.md.
Sicherheit
- Behandle den API-Key wie ein Passwort. Nutze standardmäßig einen Read-Key; Write nur, wenn Verwaltung nötig ist.
- Der Key geht nur an deine
ORBITRA_URL(HeaderAuthorization: Bearer/X-Api-Key). - Write-Aktionen laufen über die normale API und landen wie jede andere Operation im Audit-Log.
- Ein Read-Key bekommt bei Schreibversuchen ein
403und ändert nichts. ORBITRA_INSECURE=1schaltet die TLS-Verifizierung ab — nur für die lokale Entwicklung.
Updates
MCP kommt mit dem Projekt mit, das reguläre Update (⚙ → Update oder git pull) zieht die neuen Dateien also automatisch. Nach einem Update, das Abhängigkeiten geändert hat, führe cd mcp && npm install aus. Hat sich die Tool-Liste in der neuen Version geändert, verbinde den Connector im Client neu, damit er die Tools neu einliest.
Schnellstart
Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, Prüfung, Kosten.
Guide lesen →DocsInstallation und Updates
Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.
Guide lesen →DocsMigration von Keitaro
Einstellungen per SQL-Dump von Keitaro zu Orbitra übertragen: was mitkommt, das Dump-Script, der Import und was du danach prüfen solltest.
Guide lesen →DocsMigration von Binom
Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.
Guide lesen →DocsFunktionen im Überblick
Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung — mit Links auf die Detailseiten.
Guide lesen →DocsKampagnen und Streams
Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.
Guide lesen →DocsCloaking (Referenz)
Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.
Guide lesen →DocsBrowser check
Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.
Guide lesen →DocsLandingpages (Referenz)
Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.
Guide lesen →DocsPWA und Web Push
PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.
Guide lesen →DocsPWA Funnel
Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.
Guide lesen →DocsConversion-Popups
Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.
Guide lesen →DocsSession-Aufzeichnungen und Heatmaps
Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.
Guide lesen →DocsContent Gallery
Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.
Guide lesen →DocsCreatives-Bibliothek
Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.
Guide lesen →DocsExterne PWA und Telegram-Kanäle
PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.
Guide lesen →DocsPostbacks und Conversions
Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.
Guide lesen →DocsKosten
Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.
Guide lesen →DocsPush- und Pop-Netzwerke
Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.
Guide lesen →DocsFacebook / Meta
Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.
Guide lesen →DocsDolphin / Fbtool
Facebook-Kosten über den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.
Guide lesen →DocsFB-Kommentar-Cleaner
Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.
Guide lesen →DocsTraffic-Quellen und Affiliate-Netzwerke
Die beiden Verzeichnisse am Funnel-Rand: Templates für rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.
Guide lesen →DocsReports, Logs und Metriken
Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklärt — von Clicks und Visits über ROI bis zur Scroll-Tiefe.
Guide lesen →DocsDomains und SSL
Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.
Guide lesen →DocsCloudflare
Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.
Guide lesen →DocsAdministration
Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.
Guide lesen →DocsTelegram-Bot
Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.
Guide lesen →DocsMCP: ein KI-Assistent im Tracker
Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natürlicher Sprache verwalten.
Guide lesen →