Zum Inhalt springen
MCP-Server · remote

Ihre Messdaten
aus Claude abfragen

Der Serge-MCP-Server verbindet Ihren LLM-Client — Claude Desktop, Claude im Web oder Cursor — mit Ihrem Serge-Workspace. Fragen Sie in natürlicher Sprache, welche KI-Assistenten Traffic auf Ihre Website geschickt haben, wie viel davon echte Kaufabsicht war und wo Sitzungen abgebrochen sind. Der Server liest Ihre Messdaten; er ändert nichts.

VerbindungsanleitungGitHubDeveloper-Hub
Springen
In Minuten verbinden

Erstellen Sie einen API-Schlüssel oder fügen Sie den Connector hinzu, richten Sie Ihren Client auf mcp.serge.ai und stellen Sie Ihre erste Frage.

Springen
Nur lesend, eingegrenzt

Die Tools sind auf Ihren Workspace eingegrenzt und lesen Ihre Messdaten. Es wird nichts geschrieben oder geändert.

Springen
Sieben Mess-Tools

Ihr Client erhält Tools, um Sites, Traffic, Kaufabsichts-Aufteilung, Verifizierung und gescheiterte Sitzungen abzufragen.

Ihren Client verbinden

Zwei Wege zur Authentifizierung. Wählen Sie einen — Sie brauchen nicht beide.

Variante A — API-Schlüssel

Erstellen Sie einen API-Schlüssel unter Einstellungen → API-Schlüssel. Er beginnt mit sk_serge_. Gewähren Sie ihm den Scope 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.

macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

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

Nutzen Sie dies, wenn Sie sich lieber anmelden als einen Schlüssel verwalten, oder wenn Sie sich von Claude im Web verbinden.

Tools, die Ihr Client erhält

Sieben nur lesende Tools, alle auf Ihren Workspace eingegrenzt. Ihr Client wählt anhand Ihrer Frage das passende aus.

whoami

Bestätigt, welchen Workspace und welche Scopes die Verbindung hat. Rufen Sie dies zuerst auf, wenn ein Tool Ihre Daten nicht sehen kann.

list_sites

Listet die unter Ihrem Workspace registrierten Sites mit Domains und IDs auf. Beginnen Sie hier, wenn Sie unsicher sind, welche Domain ein Tool erwartet.

get_traffic_overview

Fasst den KI-Assistenten-Traffic einer Site über einen Zeitraum zusammen: Sitzungen, Plattformen (ChatGPT, Claude, Perplexity, Gemini), Ergebnisse und häufigste Einstiegsseiten.

get_purpose_split

Teilt Assistenten-Sitzungen in Kaufabsicht, informativen und Crawler-Traffic auf, damit Sie echte Kundennachfrage von Bots unterscheiden können.

get_verification_breakdown

Zeigt pro Plattform, wie viele Sitzungen ihre Identität kryptografisch bewiesen haben gegenüber nur selbst erklärten.

find_failing_sessions

Listet Sitzungen auf, die eine Aufgabe abgebrochen haben oder abgesprungen sind, mit Fehlergrund und Einstiegs-/Ausstiegsseiten.

get_session_journey

Geht in eine einzelne Sitzung hinein — ihren seitenweisen Pfad, die Zeit pro Seite, Interaktionen und das Ergebnis.

Scopes

Ein API-Schlüssel trägt Scopes, die festlegen, welche Tools er aufrufen darf. Jedes Tool auf dieser Seite benötigt nur einen.

traffic:readLiest die Messdaten Ihres KI-Assistenten-Traffics. Erforderlich für jedes Tool: Traffic, Kaufabsichts-Aufteilung, Verifizierung und Sitzungen.

Weitere Scope-Schlüssel bleiben aus Datenkompatibilität auf älteren Schlüsseln zuteilbar, aber kein aktives Tool benötigt sie — traffic:read deckt alles auf dieser Seite ab.

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 abgesprungen sind, und wo sie abgebrochen haben.

Welche Plattformen haben ihre Identität auf yourstore.com kryptografisch verifiziert, und welche haben sie nur erklärt?

Fehlerbehebung

Ein Tool kann Ihre Daten nicht sehen

Bitten Sie Ihren Client, whoami aufzurufen. Es gibt den Workspace und die Scopes der Verbindung zurück — wenn die Scopes fehlen, erstellen Sie einen Schlüssel mit dem Scope traffic:read.

site_not_found

Die Domain ist nicht unter Ihrem Workspace registriert oder Sie haben sie anders geschrieben. Bitten Sie Ihren Client, list_sites aufzurufen, und verwenden Sie eine zurückgegebene Domain.

Wie es zu Serge passt

Der MCP-Server ist eine Leseoberfläche über dieselben Messdaten, die Sie im Serge-Dashboard sehen. Es ist der schnellste Weg, eine einzelne Frage zu stellen, ohne sich durch Filter zu klicken.

Serge platziert Ihre Anzeigen auf KI-Assistenten — beginnend mit ChatGPT — und verfolgt jeden Klick bis zu seinem Ergebnis auf Ihrer Website. Genau diese Messschicht stellt der MCP-Server bereit: die Sitzungen hinter den Zahlen, die Kaufabsichts-Aufteilung und die Verläufe, in denen Besuche abgebrochen sind.

Weiter

→ Die Schritt-für-Schritt-Verbindungsanleitung öffnen→ Den Developer-Hub öffnen