Übersicht
Mit dem Mandelbaum Analytics MCP können unterstützte KI-Assistenten Fragen zur Suchleistung der Projekte beantworten, die deinem Mandelbaum-Konto zugewiesen sind. Die Anmeldung erfolgt mit demselben Konto, das du für das Mandelbaum-Dashboard verwendest.
Die Analytics-Tools sind schreibgeschützt. Sie zeigen Suchvolumen, Klickrate, beliebte und schwache Suchanfragen sowie Produkt-Conversion-Funnels, können aber keine Projekteinstellungen oder Analytics-Daten ändern.
- MCP-Server-URL
- https://backend.mandelbaum.ai/mcp
- Name
- Mandelbaum Analytics
- Transport
- Streamable HTTP
- Authentifizierung
- OAuth 2.1 mit Browser-Anmeldung
- API-Key
- Nicht erforderlich
- OAuth-Client-ID oder -Secret
- Nicht erforderlich
Das brauchst du
- Ein Mandelbaum-Konto
- Mindestens ein Projekt, das diesem Konto zugewiesen ist
- Erfasste Such-Analytics für den Zeitraum, den du untersuchen möchtest
- Einen Client mit Unterstützung für Remote-MCP über Streamable HTTP und OAuth
Client verbinden
Wähle unten deinen Client aus. Alle Clients verwenden denselben Produktions-Endpunkt und öffnen Mandelbaum im Browser, um die OAuth-Authentifizierung abzuschließen.
Claude
Diese Schritte gelten für Claude im Web sowie für Remote-Connectors in Claude Desktop und den mobilen Claude-Apps.
- Öffne Claude und gehe zu Anpassen → Connectors
- Wähle + → Benutzerdefinierten Connector hinzufügen
- Trage Mandelbaum Analytics als Namen und https://backend.mandelbaum.ai/mcp als Remote-MCP-Server-URL ein; lasse die optionale Client-ID und das Client-Secret leer
- Wähle Hinzufügen und dann Verbinden und melde dich im Browser bei Mandelbaum an
- Wähle in einer Unterhaltung + neben dem Eingabefeld, öffne Connectors und aktiviere Mandelbaum Analytics
In Team- und Enterprise-Workspaces muss ein Owner oder Primary Owner den Connector zuerst in den Organisationseinstellungen hinzufügen. Jedes Mitglied authentifiziert sich danach mit dem eigenen Mandelbaum-Konto und sieht nur die zugewiesenen Projekte.
Claude Code
Füge den Remote-Server im User-Scope hinzu, damit er in jedem Claude-Code-Projekt verfügbar ist.
bash
claude mcp add --transport http --scope user \
mandelbaum-analytics https://backend.mandelbaum.ai/mcp- Führe den Add-Befehl im Terminal aus
- Starte Claude Code und gib /mcp ein
- Wähle mandelbaum-analytics und schließe die Browser-Anmeldung ab
- Prüfe mit dem Verifizierungsbefehl, ob der Server verbunden ist
Verbindung prüfen
claude mcp listChatGPT
ChatGPT verbindet Remote-MCP-Server über den Entwicklermodus und benutzerdefinierte Apps. Die Verfügbarkeit hängt von deinem Tarif und den Workspace-Einstellungen ab.
- Aktiviere den Entwicklermodus in den ChatGPT-Einstellungen
- Öffne Einstellungen → Plugins und erstelle eine App im Entwicklermodus; in verwalteten Workspaces muss sie eventuell ein Administrator erstellen
- Verwende Mandelbaum Analytics als Namen, beschreibe die App als schreibgeschützte Such-Analytics und trage https://backend.mandelbaum.ai/mcp als MCP-Server-URL ein
- Wähle OAuth und lasse Client-ID und Client-Secret leer
- Erstelle die App oder wähle Tools scannen und melde dich im Browser bei Mandelbaum an
- Starte einen neuen Chat, wähle + neben dem Eingabefeld, dann Mehr und aktiviere Mandelbaum Analytics
Wenn diese Optionen fehlen, bitte deinen Workspace-Administrator, den Entwicklermodus oder benutzerdefinierte Apps zu aktivieren. Nutze nach Änderungen an den Server-Tools erneut Aktualisieren oder Tools scannen.
Codex
Füge den Streamable-HTTP-Server hinzu und starte die OAuth-Anmeldung über die Codex CLI.
bash
codex mcp add mandelbaum-analytics --url https://backend.mandelbaum.ai/mcp
codex mcp login mandelbaum-analytics- Führe den Add-Befehl aus
- Führe den Login-Befehl aus
- Melde dich im Browser bei Mandelbaum an
- Nutze den Verifizierungsbefehl oder öffne /mcp in Codex
Verbindung prüfen
codex mcp listDie ChatGPT-Desktop-App, die Codex CLI und die Codex-IDE-Erweiterung teilen sich dieselbe lokale MCP-Konfiguration.
Cursor
Füge Mandelbaum Analytics zur globalen MCP-Konfiguration von Cursor hinzu, damit die Verbindung projektübergreifend verfügbar ist.
json
{
"mcpServers": {
"mandelbaum-analytics": {
"url": "https://backend.mandelbaum.ai/mcp"
}
}
}- Füge die JSON-Konfiguration in ~/.cursor/mcp.json ein
- Starte Cursor neu und öffne die MCP-Einstellungen
- Authentifiziere mandelbaum-analytics, wenn du dazu aufgefordert wirst
- Nutzer der Cursor Agent CLI können die Login- und List-Tools-Befehle ausführen
Verbindung prüfen
cursor-agent mcp login mandelbaum-analytics
cursor-agent mcp list-tools mandelbaum-analyticsAndere MCP-Clients
Jeder Client mit Unterstützung für Remote-MCP über Streamable HTTP und OAuth kann dieselben Verbindungsdaten verwenden.
text
Name: Mandelbaum Analytics
Transport: Streamable HTTP
URL: https://backend.mandelbaum.ai/mcp
Authentication: OAuth- Erstelle eine Remote-MCP-Server-Verbindung
- Trage den angezeigten Namen, Transport, die URL und Authentifizierungsmethode ein
- Lasse optionale OAuth-Client-Zugangsdaten leer
- Lasse den Client OAuth erkennen und schließe die Mandelbaum-Anmeldung im Browser ab
Clients, die nur lokale stdio-Server, statische Bearer-Token oder Legacy-SSE ohne OAuth unterstützen, können sich nicht direkt verbinden. Nutze die Remote-MCP- und OAuth-Funktion des Clients anstelle eines API-Key-Headers.
Verfügbare Analytics-Tools
Der Assistent wählt diese Tools anhand deiner natürlich formulierten Anfrage aus. Alle Analytics-Tools berücksichtigen die Projekte, die dem authentifizierten Konto zugewiesen sind.
- list-projects
- Verfügbare Projekte einschließlich der Domain für weitere Aufrufe.
- get-search-volume
- Suchanfragen, Produktklicks und Klickrate für einen Zeitraum.
- get-top-search-queries
- Bis zu 20 Suchanfragen mit dem höchsten Suchvolumen.
- get-low-performing-queries
- Bis zu 20 häufige Suchanfragen mit niedriger Produktklickrate.
- get-top-products
- Bis zu 10 Produkte mit den meisten suchbasierten Klicks oder Conversions.
- get-products-breakdown
- Klick-, Warenkorb- und Checkout-Funnel für bis zu 20 Top-Produkte.
Derselbe MCP-Server stellt außerdem ecommerce-search, get-locales-for-shop und get-facets-for-search-query bereit. Das sind Produktsuche-Tools; dass sie neben den Analytics-Tools erscheinen, ist normal.
Projekte, Zeiträume und Filter
Beschreibe dein gewünschtes Ergebnis in natürlicher Sprache. Der Assistent übersetzt die Anfrage in die unterstützten Argumente.
Projekt auswählen
Wenn dein Konto nur ein Projekt hat, ist die Domain optional. Bei mehreren Projekten lässt du sie zuerst auflisten und nennst die Domain in späteren Fragen. Domains funktionieren mit oder ohne https:// und tolerieren Unterschiede beim www.-Präfix.
Liste meine Mandelbaum-Projekte auf und zeige dann das Suchvolumen für shop.example.com.
Zeitraum auswählen
Datumsgrenzen werden in UTC berechnet. Benutzerdefinierte Zeiträume enthalten Start- und Enddatum, und das Startdatum muss vor dem Enddatum liegen.
- week
- Der aktuelle Tag und die vorherigen sechs Tage.
- month
- Der vorherige Monat bis jetzt; dies ist der Standard.
- quarter
- Die vorherigen 90 Tage bis jetzt.
- year
- Das aktuelle Kalenderjahr bis jetzt.
- custom
- Ein inklusiver Zeitraum mit startDate und endDate im Format YYYY-MM-DD.
Suchtypen filtern
Standardmäßig enthalten die Analytics alle Suchtypen. Bitte um einen oder mehrere dieser Werte, wenn du das Ergebnis eingrenzen möchtest.
- REGULAR
- Normale Textsuchen.
- SKU_EAN
- Suchen nach SKU oder EAN.
- TOP_PRODUCTS
- Automatisch angezeigte Top-Produkte.
- TOP_QUERY
- Suchen, die über einen vorgeschlagenen Top Query gestartet wurden.
Beispiel-Prompts
Formuliere deine Fragen natürlich. Der Assistent kann mehrere Tools aufrufen, um Zeiträume zu vergleichen oder eine breitere Analyse zu erstellen.
“Liste die Projekte auf, die für mein Mandelbaum-Konto verfügbar sind.”
“Wie viele Suchanfragen und Produktklicks hatte shop.example.com im letzten Monat, und wie hoch war die CTR?”
“Was waren in diesem Quartal die 20 beliebtesten Suchanfragen für shop.example.com?”
“Welche regulären Suchen hatten letzten Monat die niedrigste CTR? Zeige Suchen, Klicks und CTR.”
“Zeige die Top-Produkte aus der Suche und ihren Klick-Warenkorb-Checkout-Funnel.”
“Vergleiche Suchvolumen und CTR für shop.example.com zwischen 2026-05-01–2026-05-31 und 2026-06-01–2026-06-30.”
“Fasse die wichtigsten Probleme der Suchleistung zusammen und schlage vor, welche Suchanfragen oder Produkte ich zuerst untersuchen sollte.”
Interpretation der Metriken
Diese Definitionen sorgen für konsistente Ergebnisse über Clients und Analytics-Tools hinweg.
- Suchen
- Such-Sessions mit Ergebnissen gemäß der Definition des Mandelbaum-Analytics-Service.
- Klicks
- Der Suche zugeordnete Klicks auf Produktdetailseiten.
- CTR
- Produktklicks geteilt durch Suchen, multipliziert mit 100 und auf zwei Dezimalstellen gerundet.
- Top-Produkte
- Produkte nach zugeordneten Conversions. Der detaillierte Funnel trennt Produktentdeckung, Klicks, Warenkorb-Aktionen und Checkouts.
Fehlerbehebung
Die meisten Verbindungsprobleme entstehen durch den falschen Transport oder den Versuch, sich mit einem API-Key zu authentifizieren.
Der Client meldet 401 Unauthorized
Der MCP akzeptiert deinen normalen Mandelbaum-API-Key nicht. Öffne die MCP-Einstellungen des Clients und starte oder wiederhole die OAuth-Anmeldung im Browser. Prüfe, ob die URL mit /mcp endet.
Der Client fragt nach OAuth-Client-ID und -Secret
Lasse beide Felder leer, sofern ein verwalteter Unternehmens-Client sie nicht ausdrücklich verlangt. Der Server unterstützt dynamische Client-Registrierung, sodass unterstützte Clients sich selbst registrieren.
Die Verbindung steht, aber es werden keine Tools angezeigt
Prüfe Streamable HTTP als Transport, aktualisiere oder scanne die Tools neu und starte lokale Clients neu. Prüfe außerdem, ob ein Workspace-Administrator benutzerdefinierte MCP-Tools deaktiviert hat.
Das Tool meldet mehrere verfügbare Projekte
Bitte den Assistenten, list-projects aufzurufen, wähle eine zurückgegebene Domain und nenne sie in deiner nächsten Analytics-Frage.
Ein erwartetes Projekt fehlt
Das authentifizierte Konto hat keinen Zugriff auf das Projekt oder du bist mit einem anderen Konto angemeldet. Trenne die Verbindung, verbinde sie erneut und prüfe das Konto bei der Browser-Anmeldung.
Ein benutzerdefinierter Zeitraum wird abgelehnt
Nutze YYYY-MM-DD für beide Daten, setze den Zeitraum auf custom und stelle sicher, dass das Startdatum vor dem Enddatum liegt.
Das Ergebnis ist leer
Probiere einen größeren Zeitraum und entferne Suchtyp-Filter. Bleibt das Ergebnis leer, prüfe, ob das Projekt in diesem Zeitraum Such- und Conversion-Events erfasst hat.
Sicherheit und Datenschutz
Die Verbindung ist schreibgeschützt, aber Analytics-Ergebnisse enthalten weiterhin deine Geschäftsdaten. Verbinde Clients bewusst und prüfe deren Datenrichtlinien.
- Verbinde dich ausschließlich über https://backend.mandelbaum.ai/mcp
- OAuth-Token werden an den MCP-Client ausgegeben; der Assistent benötigt niemals dein Mandelbaum-Passwort oder deinen API-Key
- Tool-Ergebnisse werden an den gewählten KI-Client gesendet; prüfe daher die Datenverarbeitung des Anbieters und die Richtlinien deiner Organisation
- Der Zugriff folgt den Projekten, die deinem Mandelbaum-Konto zugewiesen sind; entfernst du einen Projektzugriff, sind spätere Analytics-Aufrufe für dieses Projekt nicht mehr möglich
- Um den Zugriff eines Clients zu entfernen, trenne oder lösche dessen MCP-Server und lösche die gespeicherte Authentifizierung im Client