Zum Inhalt springen
MCP-Server / Verbindungsanleitung

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.

Benötigt

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.

Endpunkt

Alle Clients verbinden sich mit https://mcp.serge.ai.

Am besten für

Nur lesende Messung in Claude oder Cursor sowie bewusstes Server-zu-Server-Site-Provisioning mit einem API-Schlüssel.

1

Authentifizierung wählen

Wählen Sie eine von zwei Methoden. Sie brauchen nicht beide.

API-Schlüssel

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.

OAuth

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.

2

Ihren Client konfigurieren

Öffnen Sie Ihre Claude-Desktop-Konfigurationsdatei (Cursor verwendet dasselbe JSON-Format in seinen MCP-Einstellungen):

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

Fü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.

3

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.

4

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

Traffic„Wie viele KI-Assistenten haben diese Woche yourstore.com besucht, und welche Plattformen?“
Kaufabsicht„Wie hoch war der Anteil echter Kaufabsicht am Assistenten-Traffic auf yourstore.com gegenüber Crawlern?“
Sitzungsenden„Zeig mir Sitzungen auf yourstore.com, die als abgebrochen oder kurzer Absprung klassifiziert wurden, mit Einstiegs- und Ausstiegsseiten.“
Verifizierung„Wurde letzte Woche eine Plattform auf yourstore.com durch eine gültige HTTP-Nachrichtensignatur oder einen veröffentlichten Quell-IP-Bereich des Anbieters verifiziert?“

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:

Nächste Schritte