Serge mit Ihrem
LLM-Client verbinden
Diese Anleitung verbindet Claude, Cursor oder eine Backend-Integration über MCP mit Ihrem Serge-Workspace. Wählen Sie nur lesendes OAuth oder einen explizit eingegrenzten API-Schlüssel, prüfen Sie Workspace und Berechtigungen und lesen Sie danach Messdaten oder provisionieren Sie eine Site.
Einen Serge-Workspace und einen MCP-Client. Lesen nutzt traffic:read; automatisches Site-Provisioning benötigt zusätzlich einen API-Schlüssel mit sites:write.
Alle Clients verbinden sich mit https://mcp.serge.ai.
Nur lesende Messung in Claude oder Cursor sowie bewusstes Server-zu-Server-Site-Provisioning mit einem API-Schlüssel.
Authentifizierung wählen
Wählen Sie eine von zwei Methoden. Sie brauchen nicht beide.
Erstellen Sie unter Einstellungen → API-Schlüssel einen Schlüssel. Nutzen Sie traffic:read für Messdaten. Für AgentSolo-Provisioning wählen Sie die Vorlage mit genau sites:write + traffic:read. Bewahren Sie den Schlüssel serverseitig auf.
Fügen Sie https://mcp.serge.ai in Claude als Connector hinzu und melden Sie sich mit Ihrem Serge-Konto an. OAuth bleibt nur lesend: Es kann Daten abfragen, aber create_site nicht aufrufen.
Ihren Client konfigurieren
Öffnen Sie Ihre Claude-Desktop-Konfigurationsdatei (Cursor verwendet dasselbe JSON-Format in seinen MCP-Einstellungen):
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonFügen Sie Serge unter dem Objekt mcpServers hinzu. Ersetzen Sie den Platzhalter durch Ihren sk_serge_-Schlüssel:
Nutzen Sie stattdessen nur lesendes OAuth? Überspringen Sie die Konfigurationsdatei, fügen Sie in Claude https://mcp.serge.ai als Connector hinzu und melden Sie sich an. Provisioning benötigt weiterhin einen API-Schlüssel mit sites:write.
Neu starten und Verbindung prüfen
Starten Sie Ihren Client neu, damit er den neuen Server lädt. Die Serge-Tools sollten im Tool-Picker erscheinen.
Bestätigen Sie, dass die Verbindung an den richtigen Workspace gebunden ist, indem Sie Ihren Client whoami aufrufen lassen:
Es gibt Workspace und Scopes zurück. Messung benötigt traffic:read. Für AgentSolo-Provisioning müssen genau sites:write und traffic:read erscheinen; andernfalls erstellen Sie einen Ersatzschlüssel und rotieren sicher.
Ihre erste Frage stellen
Verwenden Sie natürliche Sprache. Ihr Client ordnet die Frage dem passenden Tool zu und ergänzt Zeitraum und Domain.
Antwortet ein Tool mit site_not_found, ruft eine nur lesende Verbindung list_sites auf. Mit einem Provisioning-Schlüssel rufen Sie create_site auf, fügen das zurückgegebene Snippet in die Tenant-Site ein, deployen und rufen check_install auf, bis receiving gemeldet wird.
Was Sie fragen können
Weitere Beispiel-Prompts
Auf welchen Einstiegsseiten landen KI-Assistenten auf yourstore.com am häufigsten?
Führ mich Seite für Seite durch eine abgebrochene oder kurze Absprung-Sitzung auf yourstore.com, ohne den Grund für ihr Ende abzuleiten.
Vergleiche den Kaufabsichts-Traffic auf yourstore.com über die letzten 7 Tage gegenüber den letzten 30.
Welche Sitzungen haben sich als ChatGPT deklariert, aber weder die Signatur- noch die veröffentlichte IP-Prüfung bestanden?
Signale gezielt untersuchen
Wenn aufgezeichnete Sitzungsverläufe wiederholt auf derselben Seite enden, nutzen Sie sie als Ausgangspunkt für eine Untersuchung – nicht als Diagnose. Fügen Sie die Belege mit einem Prompt wie diesem in Claude, Cursor oder Ihren Coding-Agenten ein: