Eine externe AI anbinden (MCP)
Neben dem integrierten AI-Analysten kann Qubix an Ihren eigenen AI-Assistenten angebunden werden — Claude Desktop, Claude Code, Cursor oder jeden Client, der MCP (Model Context Protocol) unterstützt. Der Assistent beantwortet dann Fragen zu Ihren Kampagnen anhand von Live-Daten — mit genau demselben Zugriff und denselben Berechtigungen, die Sie in der Oberfläche haben.
Was Sie benötigen
- Ein persönliches Token (PAT) — erstellen Sie es auf der Seite MCP/API. Mehr — MCP/API.
- Ihre Qubix-Adresse in der Form
https://<your-domain>/api/mcp.
Das Token wird nur im Moment der Erstellung angezeigt. Kopieren Sie es sofort und bewahren Sie es sicher auf — Qubix speichert nur dessen Hash und kann es nicht erneut anzeigen. Verloren? Drücken Sie Neu generieren, um ein neues zu erhalten (das alte funktioniert sofort nicht mehr).
Wie man die Anbindung herstellt
Sie benötigen zwei Dinge: die Adresse https://<your-domain>/api/mcp und den Header
Authorization: Bearer <your-token>. Der Rest hängt vom Client ab.
Claude Code (CLI)
claude mcp add --transport http qubix https://<your-domain>/api/mcp \
--header "Authorization: Bearer qbx_YOUR_TOKEN"
Starten Sie Claude Code neu — die Qubix-Tools werden im Chat verfügbar.
Claude Desktop
Öffnen Sie Settings → Connectors → Add custom connector, setzen Sie die Adresse
https://<your-domain>/api/mcp und fügen Sie den Header Authorization: Bearer qbx_YOUR_TOKEN hinzu.
Cursor
Fügen Sie den Server zu ~/.cursor/mcp.json (oder zur .cursor/mcp.json des Projekts) hinzu:
{
"mcpServers": {
"qubix": {
"url": "https://<your-domain>/api/mcp",
"headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
}
}
}
Was der Assistent kann
Nach der Anbindung kann der Assistent Ihre Analytik lesen und Aktionen ausführen — alles im Rahmen Ihrer Berechtigungen:
- Analytik — das Dashboard, Geo, Angebote, Netzwerke, Traffic-Quellen, die Facebook-Screens, der Besucher-Trichter sowie ein Drill-down für jede einzelne Anzeige, Kampagne, jedes Angebot, Werbemittel, jede PWA, Geo oder Traffic-Quelle.
- Werbemittel — semantische Suche („finde Werbemittel wie ein Fake-Chat-Screenshot") und die leistungsstärksten Werbemittel-Themen.
- Britva — die Automatisierungsregeln, pausierte Anzeigen und die Auslösehistorie anzeigen; Regeln erstellen, bearbeiten und freigeben.
- Aktionen — Anzeigen und Kampagnen pausieren und fortsetzen; Angebote, Netzwerke, Traffic-Quellen und Tracker-Kampagnen verwalten.
- Freiform-Abfragen — für Fragen, die die vorgefertigten Tools nicht abdecken.
Der Assistent sieht genau das, was Sie in der Oberfläche sehen: ein Administrator erhält das gesamte Konto, ein Buyer nur die Daten seines Teams. Aktionen sind durch Ihre Berechtigungen beschränkt — genau wie im Adminbereich.
Eine Anzeige pausieren, eine Regel oder ein Angebot über den Assistenten löschen, verändert Ihre echten Kampagnen. In Chat-Clients werden solche Aktionen nur nach Ihrer Bestätigung ausgeführt — lesen Sie, was der Assistent vorschlägt, bevor Sie zustimmen.
Sicherheit
- Das Token ist Ihr Zugangsschlüssel — behandeln Sie es wie ein Passwort, legen Sie es nicht in geteilten Dateien oder öffentlichen Repositories ab.
- Ein Token pro Nutzer. Um den Zugriff zu widerrufen, öffnen Sie die Seite MCP/API und drücken Sie Widerrufen (oder Neu generieren, um es zu ersetzen).