Docs

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).

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:

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.

  1. ⚙ → Users → API keys, Key anlegen (Read — nur Analytics, Write — plus Verwaltung).
  2. Den Link-Button neben dem Key anklicken — eine fertige URL landet in der Zwischenablage:
https://ваш-трекер.example.com/mcp.php?k=ВАШ_КЛЮЧ
  1. 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:

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

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.

← Zurück
Telegram-Bot
Alle Guides →
Orbitra Wiki
Quelle auf GitHub ansehen: github.com/fenjo26/Orbitra.link/wiki
Alle Guides
Docs

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 →
Docs

Installation und Updates

Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.

Guide lesen →
Docs

Migration 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 →
Docs

Migration von Binom

Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.

Guide lesen →
Docs

Funktionen 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 →
Docs

Kampagnen 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 →
Docs

Cloaking (Referenz)

Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.

Guide lesen →
Docs

Browser check

Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.

Guide lesen →
Docs

Landingpages (Referenz)

Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.

Guide lesen →
Docs

PWA und Web Push

PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.

Guide lesen →
Docs

PWA Funnel

Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.

Guide lesen →
Docs

Conversion-Popups

Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.

Guide lesen →
Docs

Session-Aufzeichnungen und Heatmaps

Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.

Guide lesen →
Docs

Content Gallery

Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.

Guide lesen →
Docs

Creatives-Bibliothek

Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.

Guide lesen →
Docs

Externe PWA und Telegram-Kanäle

PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.

Guide lesen →
Docs

Postbacks und Conversions

Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.

Guide lesen →
Docs

Kosten

Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.

Guide lesen →
Docs

Push- und Pop-Netzwerke

Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.

Guide lesen →
Docs

Facebook / Meta

Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.

Guide lesen →
Docs

Dolphin / 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 →
Docs

FB-Kommentar-Cleaner

Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.

Guide lesen →
Docs

Traffic-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 →
Docs

Reports, 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 →
Docs

Domains und SSL

Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.

Guide lesen →
Docs

Cloudflare

Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.

Guide lesen →
Docs

Administration

Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.

Guide lesen →
Docs

Telegram-Bot

Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.

Guide lesen →
Docs

MCP: 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 →