MCP-Server
Verbinde Claude oder einen anderen kompatiblen KI-Assistenten mit sellerfox, um deine Workspace-Daten im Chat auszuwerten. Der MCP-Server bietet dafür 22 schreibgeschützte Tools: Der Assistent kann Daten lesen, aber keine Workspace-Daten anlegen, ändern oder löschen.
Voraussetzungen
- Du hast einen bestätigten, weder gesperrten noch gelöschten sellerfox Account.
- Du bist aktiver Owner oder Admin in jedem Workspace, den du verbinden möchtest. Viewer und External können MCP nicht verwenden.
- Ein Owner oder Admin aktiviert MCP für jeden dieser Workspaces. Anschließend gibst du die Workspaces persönlich für deine Verbindung frei.
MCP-Client verbinden
Die folgende Anleitung führt dich von der Aktivierung in sellerfox bis zur ersten Frage in Claude. Die Original-Screenshots zeigen sellerfox und Claude auf Englisch. Die Anleitung nennt sellerfox-Schaltflächen auf Deutsch; die Claude-Menünamen bleiben Englisch.
1. MCP-Zugriff in sellerfox aktivieren
- Öffne als Owner oder Admin in jedem Workspace Einstellungen → Integrationen und wähle bei „MCP-Zugriff“ die Aktion „Zugriff aktivieren“.
- Bestätige die Hinweise im Dialog und wähle „Aktivieren“.
Der Dialog erklärt, dass Antworten vom verbundenen KI-Client oder dessen Anbieter verarbeitet werden können, auch außerhalb der EU und des EWR. sellerfox hat darauf keinen Einfluss. Du bestätigst außerdem, dass du zur Weitergabe der Workspace-Daten befugt bist – bei Agenturen einschließlich der Zustimmung des Verkäufers – und die Nutzung mit den geltenden Amazon-, Seller- und Agenturverträgen vereinbar ist.
2. sellerfox in Claude hinzufügen
Der Einstieg hängt von deinem Claude-Zugang ab:
| Claude-Zugang | Wo du den Konnektor hinzufügst |
|---|---|
| Persönlicher Zugang | Öffne Customize → Connectors, wähle „+“ und dann „Add custom connector“. |
| Team oder Enterprise | Ein Owner oder Primary Owner deiner Claude-Organisation öffnet Organization settings → Connectors und wählt Add → Custom → Web. Dieser Schritt gilt für die gesamte Claude-Organisation. |
Die beiden folgenden Aufnahmen zeigen den Einstieg für Team und Enterprise:
Gib dem Konnektor den Namen „Sellerfox“ wie in der Aufnahme und trage diese Server-URL ein:
https://api.sellerfox.com/mcpSpeichere mit „Add“. Bei Team und Enterprise verbindet sich danach jedes Mitglied selbst mit seinem sellerfox Account.
3. Verbinden und Workspaces freigeben
- Öffne in Claude Customize → Connectors und wähle deinen sellerfox-Konnektor.
- Wähle „Connect“. Im Browser öffnet sich die sellerfox-Anmeldung.
- Melde dich mit deinem sellerfox Account an und wähle „Continue“.
- Wähle mindestens einen verfügbaren Workspace, den Claude lesen darf. Du kannst mehrere Workspaces freigeben.
- Bestätige mit „Authorize“ und kehre zu Claude zurück. In der Desktop-App zeigt Claude anschließend die Verbindungsbestätigung:
Fehlt ein Workspace oder lässt er sich nicht auswählen, prüfe die MCP-Aktivierung, deine aktive Mitgliedschaft und deine Rolle in diesem Workspace.
4. Tool-Freigaben festlegen
Öffne in Claude erneut Customize → Connectors und wähle sellerfox. Dort legst du fest, welche Tools Claude verwenden darf und wann Claude vor einem Abruf nachfragen soll. In einer Claude-Organisation können die Vorgaben der Organisation diese Auswahl einschränken.
5. Verbindung im Chat prüfen
- Öffne einen Chat in Claude.
- Wähle neben dem Eingabefeld + → Connectors und aktiviere sellerfox für dieses Gespräch.
- Frage:
Auf welche sellerfox Workspaces kannst du zugreifen?
Claude kann jetzt die für diese Verbindung verfügbaren Workspaces auflisten. Nutze in weiteren Fragen den Namen des gewünschten Workspaces.
Andere MCP-Clients verbinden
Verwende dieselbe Server-URL in einem Client, der Remote-MCP-Server mit Browser-Anmeldung unterstützt. Aktiviere zuerst MCP in sellerfox und gib anschließend bei der Anmeldung die gewünschten Workspaces frei. Die Schritte zum Hinzufügen des Servers hängen vom Client ab.
Auswertungen starten
Nenne in deiner Frage den Workspace, den Marktplatz und den Zeitraum. Formuliere danach, was du vergleichen oder verstehen möchtest, zum Beispiel:
- "Fasse Umsatz, Werbeausgaben und Gewinn der letzten 30 Tage für meinen Workspace auf dem deutschen Marktplatz zusammen. Prüfe zuerst den Datenstand und nenne mögliche Lücken."
- "Welche Produkte hatten im letzten Monat auf dem deutschen Marktplatz den höchsten Umsatz? Vergleiche sie mit dem Vormonat."
- "Wie haben sich die organischen Rankings meiner verfolgten Keywords in den letzten vier Wochen entwickelt?"
Datenstand vor der Auswertung prüfen
Bitte den Assistenten, vor der Analyse nach Verbindungsproblemen und noch laufenden Datenimporten zu suchen. Solche Probleme können dazu führen, dass die Zahlen für den gewünschten Zeitraum zu niedrig ausfallen.
Du kannst die Prüfung direkt in deine Frage aufnehmen:
Prüfe zuerst den Datenstand meines Workspaces. Gibt es Verbindungsprobleme oder werden noch Daten geladen? Von wann sind die neuesten Verkaufs- und Werbereports je Marktplatz? Berücksichtige diese Hinweise bei der Auswertung.
sellerfox nennt dazu bekannte Verbindungsprobleme, laufende Importe sowie das Datum des ältesten und neuesten vorhandenen Verkaufs-, Traffic- und Werbereports je Marktplatz. Beachte beim Lesen der Antwort:
- Zwischen zwei Report-Daten können Lücken liegen. Der älteste und neueste Report belegen nicht, dass für jeden Tag dazwischen Daten vorhanden sind. Auch eine Antwort ohne Warnung bestätigt keine vollständigen Daten.
- 0 kann durch fehlende Reports entstehen. Wenn für einen Zeitraum Reports fehlen, bedeutet ein Ergebnis von 0 nicht automatisch, dass du 0 Verkäufe oder 0 Werbeausgaben hattest.
Die Prüfung der Report-Daten umfasst keine SQPR-, Keyword-Ranking- oder Profit-Daten.
Für SQPR kann der Assistent nur bereits geladene Wochen- oder Monatsreports auswerten. Lass dir den tatsächlich ausgewerteten Zeitraum nennen: SQPR-Abfragen beziehen sich immer auf vollständige Report-Wochen oder -Monate. Fehlende Reports kannst du im Search Term Analyzer prüfen und nachladen.
Wann welche Daten aktualisiert werden, findest du unter Datenaktualisierung.
Profit-Abfragen und Kostenzuordnung
Für den Gesamtgewinn frage nach dem gesamten Workspace ohne Produkt- oder Marktplatzfilter. Bei einer detaillierten Auswertung gelten diese Grenzen:
- Produktfilter schließen Kosten aus, die den gewählten Produkten nicht zugeordnet werden können. Ein Marktplatzfilter schließt Workspace-weite manuelle Kosten aus.
- Je SKU lassen sich Werbekosten und der daraus berechnete Nettogewinn nicht zuordnen. Für diese Werte kannst du nach ASIN oder Marktplatz auswerten.
- Verwende die gelieferten Gesamtsummen. Nicht zugeordnete Kosten sind darin bereits enthalten; Zwischensummen und einzelne Kostenbestandteile lassen sich nicht beliebig addieren.
- Erstattungen zählen im Zeitraum ihrer Abrechnung. Laufende Importe oder fehlende Warenkosten können das Ergebnis weiterhin beeinflussen.
Wie sich Gewinn und Kosten zusammensetzen, erklärt Profit Tracking.
Bestehende Verbindungen verwalten
Öffne in sellerfox unter „User Einstellungen“ den Bereich „Account: Verbundene Apps“. Dort siehst du deine Verbindungen und die freigegebenen Workspaces.
- Mit „Verwalten“ änderst du die Workspace-Auswahl. Auf einen entfernten Workspace kann der Client ab dem nächsten Abruf nicht mehr zugreifen.
- Mit „Widerrufen“ beendest du die Verbindung. Für weitere Abrufe musst du den Client erneut verbinden und autorisieren.
Wirst du aus einem Workspace entfernt und später wieder aufgenommen, musst du ihn erneut für die Verbindung freigeben.
Owner und Admins können die persönlichen MCP-Verbindungen anderer Nutzer derzeit weder im Dashboard einsehen noch einzeln widerrufen. Den Zugriff für den gesamten Workspace können sie über die MCP-Einstellung sperren. Wird ein Mitglied aus dem Workspace entfernt, verliert es sofort auch über den MCP-Client den Zugriff auf die Daten dieses Workspace.
Spätestens nach 180 Tagen musst du eine Verbindung neu autorisieren.
MCP für den gesamten Workspace deaktivieren
Mit „Zugriff deaktivieren“ unter Einstellungen → Integrationen blockierst du sofort jeden MCP-Abruf für diesen Workspace. Die persönlichen Verbindungen und Workspace-Freigaben bleiben bestehen. Nach dem erneuten Aktivieren können gültige Verbindungen wieder zugreifen, sofern Mitgliedschaft, Rolle und Freigabe weiterhin passen.
Aufrufprotokolle
sellerfox speichert MCP-Aufrufprotokolle bis zu 180 Tage. Bei Workspace-bezogenen Abrufen enthalten sie den Zeitpunkt, den Client, das Tool, den angefragten Workspace und ob ein Fehler aufgetreten ist. Die Protokolle sind derzeit nicht im Dashboard einsehbar.
Voraussetzungen für jeden Datenabruf
sellerfox prüft bei jedem Abruf von Workspace-Daten fünf Sicherheitsvoraussetzungen. Zusätzlich muss deine Verbindung gültig und darf nicht widerrufen sein.
- Dein sellerfox Account ist verfügbar. Dein sellerfox Account ist bestätigt und weder gesperrt noch gelöscht.
- Deine Mitgliedschaft ist aktiv. Du bist aktives Mitglied des angefragten Workspace. Eine ausstehende Einladung reicht nicht aus.
- Deine Rolle erlaubt MCP. Du bist Owner oder Admin in diesem Workspace. Viewer und External können MCP nicht verwenden.
- MCP ist im Workspace aktiviert. Ein Owner oder Admin hat den Zugriff unter Einstellungen → Integrationen bei „MCP-Zugriff“ aktiviert.
- Du hast den Workspace für die Verbindung freigegeben. Du hast den Workspace beim Verbinden des MCP-Clients oder später mit „Verwalten“ ausdrücklich ausgewählt.
Sobald eine dieser Voraussetzungen nicht mehr erfüllt ist, blockiert sellerfox den nächsten Datenabruf. Das gilt auch für bereits verbundene MCP-Clients.
Limits
Bei vielen Abfragen kann vorübergehend eine Nutzungsgrenze erreicht werden. Meldet dein MCP-Client zu viele Anfragen, warte die angegebene Zeit und versuche es erneut.
Bei fehlenden Workspaces, Verbindungsproblemen oder leeren Ergebnissen hilft Troubleshooting → MCP-Server.
Wenn Claude ein Verbindungsproblem meldet
Die Meldung "Connection issue" bezeichnet ein Verbindungsproblem. Die folgende Aufnahme zeigt ausdrücklich einen Fehlerzustand. Prüfe die Server-URL; bleibt die Meldung bestehen, kontaktiere den Support.
Tool-Übersicht
Die Tools decken Workspaces, Produkte, Marktplätze, Keywords, SQPR, Events, Best Seller Rank (BSR) und Profit Tracking ab. Die folgende Liste zeigt, welche Daten der Assistent abfragen kann.
| Tool | Was es liefert | Funktion |
|---|---|---|
| Workspaces und KPI-Definitionen | ||
get_workspaces | Zeigt die Workspaces, auf die diese Verbindung zugreifen kann. | MCP-Server |
get_workspace_info | Zeigt Marktplätze, Währung, Zeitzone, Datenstand sowie Verbindungs- oder Importprobleme. | MCP-Server |
get_kpi_definitions | Listet verfügbare KPIs, ihre Bezeichnungen, Einheiten und unterstützten Auswertungen. | MCP-Server |
| Produkte | ||
get_products | Findet Produkte nach Name, ASIN oder SKU, auf Wunsch auf einen Marktplatz eingegrenzt. | Produkte & Produktlisten |
get_product_kpis | Liefert aggregierte KPIs für ein oder mehrere Produkte über einen Zeitraum. | Produkte & Produktlisten |
get_product_trends | Liefert die zeitliche Entwicklung eines KPIs für ein oder mehrere Produkte. | Produkte & Produktlisten |
| Marktplätze | ||
get_marketplace_kpis | Liefert aggregierte KPIs auf Marktplatzebene. | Marktplatz-Dashboard |
get_marketplace_trends | Liefert die zeitliche Entwicklung ausgewählter KPIs auf Marktplatzebene. | Marktplatz-Dashboard |
| Keywords | ||
get_keywords | Listet die im Workspace verfolgten Keywords auf. | Keywords |
get_keyword_kpis | Liefert aggregierte KPIs für verfolgte Keywords über einen Zeitraum. | Keywords |
get_keyword_trends | Liefert die zeitliche Entwicklung der Rankings für verfolgte Keywords. | Keywords |
get_products_by_keyword_kpis | Liefert Produkte mit einem Ranking für ein verfolgtes Keyword sowie ihre KPIs. | Keywords |
| Search Query Performance (SQPR) | ||
get_sqpr_kpis | Liefert SQPR-KPIs aggregiert nach Suchanfrage. | SQPR Reports |
get_sqpr_trends | Liefert die zeitliche Entwicklung der SQPR-Daten für ausgewählte Suchanfragen. | SQPR Reports |
get_products_by_search_query_kpis | Liefert Workspace-Produkte mit geladenen SQPR-Daten für eine exakte Suchanfrage sowie ausgewählte SQPR-KPIs. | SQPR Reports |
| Events | ||
list_events | Listet Listing-, Katalog-, Buy-Box-Verlust- und Events zum Seller-Central-Kontostatus sowie selbst angelegte Events auf, sortiert vom neuesten zum ältesten. | Events |
| Best Seller Rank (BSR) | ||
get_bsr_trends | Zeigt den täglichen Verlauf des Best Seller Rank (BSR) für ein Produkt auf einem Marktplatz. | BSR Explorer |
get_bsr_ranks | Vergleicht den zuletzt verfügbaren Best Seller Rank (BSR) und Rangveränderungen mehrerer Produkte. | BSR Explorer |
| Profit Tracking | ||
get_profit_summary | Liefert Umsatz, Kosten und Gewinn für einen Zeitraum sowie ihre Anteile am Netto-Umsatz. | Profit Tracking |
get_profit_breakdown | Schlüsselt Erlöse, Erstattungen, Werbung, Gebühren und weitere Kosten in ihre Bestandteile auf. | Profit Tracking |
get_profit_by_product | Vergleicht Profit-KPIs nach Marktplatz, Parent-ASIN, Child-ASIN oder SKU, mit Gesamtsummen und nicht zugeordneten Kosten. | Profit Tracking |
list_income_expenses | Listet manuelle und von Amazon übernommene Einnahmen und Ausgaben in ihrer Ausgangswährung. Diese Einträge sind nur ein Teil der Gewinnrechnung. | Profit Tracking |
Verwandte Themen
- Berechtigungen – Zugriff und Rollen im Workspace.
- Datensicherheit – Datenweitergabe und Aufbewahrung.
- Webhooks – ausgewählte Daten regelmäßig an einen eigenen Endpunkt senden.
- Claude-Hilfe: Benutzerdefinierte Konnektoren – aktuelle Claude-Menüs und Voraussetzungen.