MCP/API
MCP/API ist die einzige Programmierschnittstelle zu Qubix. Externe Clients — ein KI-Assistent, ein BI-Skript, ein Automatisierungswerkzeug — verbinden sich mit einem einzigen Endpunkt über MCP (Model Context Protocol) und rufen die auf dieser Seite aufgeführten Methoden auf. Jeder Aufruf läuft streng innerhalb Ihrer Berechtigungen: Ein Administrator erreicht das gesamte Konto, ein Buyer nur die Daten seines Teams.
Es gibt keine separate REST-API, die Sie erlernen müssten: Die Methoden, die Sie hier sehen, sind genau das, was der Endpunkt bereitstellt, sodass der Katalog niemals von der tatsächlichen Schnittstelle abweichen kann.
Dieselben Methoden treiben den eingebauten Assistenten an
Diese Methoden sind nicht nur für externe Clients gedacht. Der eingebaute Qubix-KI-Assistent — das Panel, das auf jedem Bildschirm des Adminbereichs ohne Einrichtung verfügbar ist — ruft genau denselben Katalog auf. Egal also, ob Sie den eingebauten Assistenten fragen oder Ihren eigenen KI-Agenten über MCP anbinden: Beide lesen Ihre Daten und führen Aktionen über dieselben Methoden aus, stets innerhalb Ihrer Berechtigungen.
- Eingebaut — der Assistent auf jeder Seite. Siehe KI-Analyst-Chat.
- Extern — verbinden Sie Claude, Cursor oder einen anderen MCP-Client. Siehe Eine externe KI anbinden.
Wo Sie es finden
Öffnen Sie im Adminbereich das Kontomenü (oben rechts, neben Ihrem Namen) und wählen Sie MCP/API.
Der Endpunkt
Alles geht an eine Adresse:
POST https://<your-domain>/api/mcp
Der Transport ist Streamable HTTP (JSON-RPC 2.0) — ein einziger Endpunkt, den vorgefertigte MCP-Clients nativ sprechen und den Sie auch direkt aus jeder Sprache aufrufen können (siehe Code-Beispiele unten).
Ihr API-Token
Der programmatische Zugriff verwendet ein persönliches Token (PAT) — direkt auf dieser Seite im Block API Token erstellt und verwaltet.
- Drücken Sie API-Token generieren (oder Neu generieren, falls Sie bereits eines haben).
- Kopieren Sie das Token sofort — es wird nur einmal angezeigt.
Das Token sieht aus wie qbx_…. Qubix speichert nur dessen Hash und kann es nie wieder anzeigen.
- Ein Token pro Benutzer. Es erbt Ihre Rolle und Berechtigungen, sodass Sie über die API genau dieselben Daten und Aktionen sehen wie in der Oberfläche.
- Neu generieren stellt ein neues Token aus, und das alte funktioniert sofort nicht mehr.
- Widerrufen löscht das Token und kappt jeglichen Zugriff, der es genutzt hat.
Ein persönliches Token ist gleichbedeutend mit einer Anmeldung als Sie selbst. Veröffentlichen oder teilen Sie es nicht. Falls es durchsickert, drücken Sie hier Neu generieren — das alte Token stirbt sofort.
Einen Client verbinden
Die meisten MCP-Clients benötigen eine kleine Konfiguration: den Endpunkt plus den
Authorization-Header. Während das Token direkt nach der Generierung angezeigt wird, trägt diese
Seite den echten Wert bereits in das Beispiel unten ein — kopieren Sie es unverändert.
{
"mcpServers": {
"qubix": {
"url": "https://<your-domain>/api/mcp",
"headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
}
}
}
Für die schrittweise Einrichtung eines bestimmten Assistenten (Claude Code, Claude Desktop, Cursor) siehe Eine externe KI anbinden.
Code-Beispiele
Um den Endpunkt aus Ihrem eigenen Code aufzurufen, senden Sie eine JSON-RPC-Anfrage mit den Auth- und Streamable-HTTP-Headern. Die Seite bietet fertige Snippets für cURL, JavaScript und Python — wechseln Sie den Tab und kopieren Sie. Zum Beispiel, um die verfügbaren Methoden aufzulisten:
curl -X POST 'https://<your-domain>/api/mcp' \
-H 'Authorization: Bearer qbx_YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
import requests
res = requests.post(
"https://<your-domain>/api/mcp",
headers={
"Authorization": "Bearer qbx_YOUR_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream",
},
json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)
Diese reinen Aufrufe veranschaulichen das Protokoll aus jeder Sprache. Fertige Clients (Claude, Cursor) benötigen sie nicht — sie verwenden die obige Konfiguration.
Was die API bereitstellt
Die Seite listet den vollständigen Methodenkatalog auf — heute etwa hundert Methoden — und jede ist mit Lesen oder Schreiben gekennzeichnet. Sie decken innerhalb Ihrer Berechtigungen ab:
- Analytik — das Dashboard, Geo, Offers, Networks, Traffic-Quellen, die Facebook-Bildschirme und den Besucher-Funnel sowie einen Drill-down für ein einzelnes Ad, eine Kampagne, ein Offer, ein Creative, eine PWA, eine Geo oder eine Traffic-Quelle.
- Creatives — semantische Suche und die leistungsstärksten Creative-Themen.
- Britva — Automatisierungsregeln, pausierte Ads und Auslöseverlauf ansehen; Regeln erstellen, bearbeiten und freigeben.
- Aktionen — Ads und Kampagnen pausieren und wieder aufnehmen; Offers, Networks, Traffic-Quellen, Tracker-Kampagnen, Pixel, Websites, Domains, PWAs und Push-Kampagnen verwalten.
- Freitext-Abfragen — eine schreibgeschützte Abfragemethode für Fragen, die die vorgefertigten Methoden nicht abdecken.
Jede Methode zeigt ihre Parameter und ob sie Daten verändert. Verwenden Sie das Suchfeld, um eine Methode nach Namen oder Beschreibung zu finden.
Ein Ad zu pausieren oder eine Regel oder ein Offer über die API zu löschen verändert Ihre laufenden Kampagnen. In Chat-Clients laufen solche Aktionen erst nach Ihrer Bestätigung — prüfen Sie das Vorgeschlagene, bevor Sie zustimmen.