MCP-Server · remote

Ihre Agenten-Analytics
aus Claude abfragen

Der Serge-MCP-Server verbindet Ihren LLM-Client — Claude Desktop, Claude im Web oder Cursor — mit Ihrem Serge-Agenten-Analytics-Workspace. Fragen Sie in natürlicher Sprache, welche KI-Agenten Ihren Shop besucht haben, wie viel davon echte Kaufabsicht war und wo Agenten den Checkout nicht abschließen konnten. Der Server liest Ihre Daten; er ändert nichts.

VerbindungsanleitungGitHubScanner-API-Docs
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 Analytics-Daten. Es wird nichts geschrieben oder geändert.

Springen
Acht Analytics-Tools

Ihr Client erhält Tools, um Scans, 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 die Scopes scans:read und 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

Acht 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_scan

Schlägt den letzten Scan für eine Domain nach — Gesamtwertung, Verdikt und einen Link zum Bericht.

get_traffic_overview

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

get_purpose_split

Teilt Agenten-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. Gewähren Sie das Minimum, das die Frage benötigt.

scans:readLiest Scan-Ergebnisse für Ihre Domains. Erforderlich für get_scan.
traffic:readLiest Agenten-Traffic-Analytics. Erforderlich für die Traffic-, Purpose-, Verifizierungs- und Sitzungs-Tools.

Replay-Scopes existieren intern, sind aber noch nicht im Dashboard zuteilbar — folgt in Kürze.

Beispiel-Prompts

Fügen Sie diese in Ihren verbundenen Client ein. Er ordnet jede Frage dem passenden Tool zu und ergänzt den Rest.

Wie viele KI-Agenten konnten diese Woche auf yourstore.com nicht zur Kasse gehen?

Wie hoch war in den letzten 7 Tagen der Anteil echter Kaufabsicht am Agenten-Traffic auf yourstore.com gegenüber Crawlern?

Ist laptop-x-15 für Agenten auf yourstore.com auffindbar? Zeig mir den letzten Scan.

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 scans:read und 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 Agenten-Analytics-Daten, die Sie im Dashboard sehen. Es ist der schnellste Weg, eine einzelne Frage zu stellen, ohne sich durch Filter zu klicken.

Wenn Sie einem echten Agenten beim Kaufversuch in Ihrem Live-Shop zusehen wollen — und genau sehen, wo er scheitert — ist das der Agent Journey Test im gehosteten Produkt. Der MCP-Server sagt Ihnen, was passiert ist; der Journey Test zeigt Ihnen, warum.

Weiter

→ Die Schritt-für-Schritt-Verbindungsanleitung öffnen→ Die Scanner-API-Docs öffnen→ Den öffentlichen Scanner ausführen