Ihre Messdaten
aus Claude abfragen
Der Serge-MCP-Server verbindet Claude, Cursor oder eine Backend-Integration mit Ihrem Workspace. Neun Operationen lesen Mess- und Installationsdaten. Der einzige Schreibzugriff, create_site, registriert eine Domain idempotent und gelingt nur mit einem API-Schlüssel mit sites:write.
Nutzen Sie OAuth für reine Leseabfragen oder einen eingegrenzten API-Schlüssel für Lesezugriff oder Site-Provisioning.
Neun Operationen sind nur lesend. Nur create_site schreibt und benötigt einen API-Schlüssel mit sites:write.
Neun Leseoperationen decken Setup und Messung ab; eine idempotente Operation registriert eine Site.
Ihren Client verbinden
Zwei Wege zur Authentifizierung. Wählen Sie einen — Sie brauchen nicht beide.
Variante A — API-Schlüssel
Erstellen Sie unter Einstellungen → API-Schlüssel einen Schlüssel. Für Messdaten gewähren Sie traffic:read. Für AgentSolo-Provisioning wählen Sie die Vorlage mit genau sites:write + traffic:read.
Fügen Sie dies in Ihre Client-Konfiguration ein. Der Pfad zur Claude-Desktop-Konfiguration steht unten; Cursor verwendet dasselbe Format in seinen MCP-Einstellungen.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonStarten Sie Ihren Client neu. Die Serge-Tools erscheinen im Tool-Picker.
Variante B — OAuth-Connector
Fügen Sie in Claude https://mcp.serge.ai als benutzerdefinierten Connector hinzu und melden Sie sich mit Ihrem Serge-Konto an. Claude durchläuft den OAuth-Flow und bindet die Verbindung an Ihren Workspace — kein API-Schlüssel zum Einfügen oder Rotieren.
OAuth bleibt nur lesend: Es kann Sites und Messdaten abfragen, aber create_site nicht aufrufen. Automatisches Provisioning benötigt einen API-Schlüssel mit sites:write.
Tools, die Ihr Client erhält
Zehn workspace-bezogene Tools: neun Leseoperationen und ein idempotenter Schreibzugriff, create_site. Ihr Client wählt das passende Tool für die Aufgabe.
list_sitesListet die unter Ihrem Workspace registrierten Sites mit Domains und IDs auf. Beginnen Sie hier, wenn Sie unsicher sind, welche Domain ein Tool erwartet.
create_siteRegistriert eine Tenant-Domain und gibt die vorhandene oder neue Site-ID, den Public Token und das einsetzbare Snippet zurück. Dies ist das einzige Write-Tool; Wiederholungen sind sicher und sites:write ist erforderlich.
check_installPrüft Ingest-Telemetrie mit passender Origin. Heartbeats bestätigen die Annahme einer Anfrage, nicht Browser-Ausführung oder Besitz; abgelehnte Origins sind ungeprüfte öffentliche Angaben.
get_traffic_overviewFasst den KI-Assistenten-Traffic einer Site über einen Zeitraum zusammen: Sitzungen, Plattformen (ChatGPT, Claude, Perplexity, Gemini), Ergebnisse und häufigste Einstiegsseiten.
get_purpose_splitTeilt Assistenten-Sitzungen in Kaufabsicht, informativen und Crawler-Traffic auf, damit Sie echte Kundennachfrage von Bots unterscheiden können.
get_traffic_sourcesSchlüsselt KI-Assistenten- und markierte Akquisitionsquellen über einen gewählten Zeitraum auf und bleibt dabei beim selben First-Party-Sitzungsinstrument.
get_verification_breakdownZeigt pro Plattform, wie viele Sitzungen entweder durch eine gültige HTTP-Nachrichtensignatur oder eine Quell-IP in einem veröffentlichten Anbieterbereich verifiziert wurden – im Vergleich zu nur selbst deklarierten.
find_failing_sessionsListet Sitzungen auf, die als abgebrochen oder als kurzer Einzelseiten-Absprung klassifiziert wurden, mit Einstiegs-/Ausstiegsseiten und Zeitangaben. Diese Labels nennen keine Ursache und beweisen keinen Aufgabenversuch.
get_session_journeyGeht in eine einzelne Sitzung hinein — ihren seitenweisen Pfad, die Zeit pro Seite, Interaktionen und das Ergebnis.
whoamiBestätigt, welchen Workspace und welche Scopes die Verbindung hat. Rufen Sie dies zuerst auf, wenn ein Tool Ihre Daten nicht sehen kann.
Scopes
Ein API-Schlüssel trägt explizite Scopes. Halten Sie Provisioning-Schlüssel schlank; Berechtigungen sind bei Erstellung fixiert und werden durch Rotation auf einen Ersatz geändert.
traffic:readErlaubt die acht Leseoperationen für Installation und Messung. whoami bleibt für jede authentifizierte Verbindung verfügbar.sites:writeErlaubt create_site, Domains in diesem Workspace zu registrieren. Nur einem vertrauenswürdigen serverseitigen Provisioner gewähren.OAuth gewährt nur Lese-Scopes. Es kann die neun Leseoperationen nutzen, aber nie create_site; Provisioning benötigt einen API-Schlüssel mit sites:write.
Beispiel-Prompts
Fügen Sie diese in Ihren verbundenen Client ein. Er ordnet jede Frage dem passenden Tool zu und ergänzt den Rest.
Welche KI-Assistenten haben diese Woche Traffic auf yourstore.com geschickt?
Wie hoch war in den letzten 7 Tagen der Anteil echter Kaufabsicht am Assistenten-Traffic auf yourstore.com gegenüber Crawlern?
Zeig mir die Sitzungen auf yourstore.com, die als abgebrochen oder kurzer Absprung klassifiziert wurden, mit Einstiegs- und Ausstiegsseiten.
Welche Plattformen wurden auf yourstore.com durch eine gültige HTTP-Nachrichtensignatur oder einen veröffentlichten Quell-IP-Bereich des Anbieters verifiziert, und welche haben sich nur selbst deklariert?
Fehlerbehebung
Bitten Sie Ihren Client, whoami aufzurufen. Für Messdaten muss traffic:read erscheinen. Für AgentSolo-Provisioning müssen sites:write und traffic:read erscheinen.
Die Domain ist nicht in Ihrem Workspace registriert oder anders geschrieben. Nur lesende Verbindungen rufen list_sites auf; ein Provisioning-Schlüssel kann create_site aufrufen, das Snippet installieren und danach check_install prüfen.
Wie es zu Serge passt
Neun MCP-Operationen lesen dieselben Installations- und Messdaten wie Serge. Die zehnte, create_site, ist eine enge Provisioning-Operation für vertrauenswürdige Backends und benötigt einen eigenen Write-Scope.
Serge unterstützt heute einen betreuten Werbeablauf: ChatGPT über Ihr eigenes OpenAI-Werbekonto. Der MCP-Server stellt Ihre separaten First-Party-Messdaten bereit, darunter erfasste Sitzungen und unterstützte Akquise-Marker; OpenAIs Plattformbericht und Kampagnenstatus stellt er nicht bereit.