MCP-Server / Verbindungsanleitung

Serge mit Ihrem
LLM-Client verbinden

Diese Anleitung verbindet Claude Desktop, Claude im Web oder Cursor über MCP mit Ihrem Serge-Agenten-Analytics-Workspace. Wählen Sie eine Authentifizierungsmethode, konfigurieren Sie den Client, prüfen Sie die Verbindung und stellen Sie Ihre erste Frage.

Benötigt

Einen Serge-Workspace mit mindestens einer registrierten Site und einen LLM-Client, der MCP spricht (Claude Desktop, Claude im Web oder Cursor).

Endpunkt

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

Am besten für

Einzelne Fragen zu Ihrem Agenten-Traffic zu stellen, ohne sich durch Dashboard-Filter zu klicken.

1

Authentifizierung wählen

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

API-Schlüssel

Erstellen Sie einen Schlüssel unter Einstellungen → API-Schlüssel (er beginnt mit sk_serge_) mit den Scopes scans:read und traffic:read. Am besten für Claude Desktop und Cursor, wo der Schlüssel in einer Konfigurationsdatei liegt.

OAuth

Fügen Sie https://mcp.serge.ai in Claude als Connector hinzu und melden Sie sich mit Ihrem Serge-Konto an. Am besten, wenn Sie sich lieber anmelden als einen Schlüssel verwalten, oder wenn Sie Claude im Web nutzen.

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:

Verwenden Sie stattdessen OAuth? Überspringen Sie die Konfigurationsdatei: Öffnen Sie in Claude die Connector-Einstellungen, fügen Sie https://mcp.serge.ai hinzu und schließen Sie die Anmeldung ab.

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 Ihren Workspace und die Scopes des Schlüssels zurück. Wenn die Scopes fehlen, erstellen Sie einen neuen Schlüssel mit scans:read und traffic:read.

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, lassen Sie Ihren Client list_sites aufrufen und verwenden Sie eine zurückgegebene Domain.

Was Sie fragen können

Traffic„Wie viele KI-Agenten haben diese Woche yourstore.com besucht, und welche Plattformen?“
Kaufabsicht„Wie hoch war der Anteil echter Kaufabsicht am Agenten-Traffic auf yourstore.com gegenüber Crawlern?“
Fehler„Zeig mir die Sitzungen, in denen Agenten den Checkout auf yourstore.com abgebrochen haben.“
Scan„Wie lautet die letzte Scan-Wertung für yourstore.com, und was sollte ich zuerst beheben?“

Weitere Beispiel-Prompts

Auf welchen Einstiegsseiten landen KI-Agenten auf yourstore.com am häufigsten?

Hat letzte Woche eine Plattform ihre Identität auf yourstore.com kryptografisch verifiziert?

Führ mich Seite für Seite durch eine gescheiterte Sitzung auf yourstore.com.

Vergleiche den Kaufabsichts-Traffic auf yourstore.com über die letzten 7 Tage gegenüber 30 Tagen.

Befunde in Korrekturen verwandeln

Sobald ein Sitzungsverlauf oder Scan einen Blocker aufdeckt, fügen Sie ihn in Claude, Cursor oder Ihren Coding-Agenten mit einem Prompt wie diesem ein:

Nächste Schritte