Sellantica MCP-Connector

Nutze deine Amazon-Ads-Daten und die Optimierungs-Engine von Sellantica in jedem MCP-kompatiblen KI-Assistenten (Claude, ChatGPT, Cursor und mehr)

Zuletzt aktualisiert: 29. September 2026

Was der Connector kann

Sellantica ist eine Plattform für das Management von Amazon Advertising (PPC) für Amazon-Verkäufer und Agenturen. Der Sellantica MCP-Server stellt dein Sellantica-Konto KI-Assistenten über das Model Context Protocol bereit. Nach der Verbindung kann dein KI-Assistent:

Kampagnen, Anzeigengruppen, Keywords, Produkt-Targets und Kunden-Suchbegriffe mit Ausgaben, Umsatz, ACoS, CTR und CPC für jeden Zeitraum auswerten.
Die Optimierungs-Engine erklären: offene Gebots- und Statusvorschläge, Budget-, Platzierungs- und Dayparting-Vorschläge sowie die zugrunde liegenden Einstellungen.
Keyword-Harvesting-Kandidaten, negative Keywords, das Audit der Kontostruktur und die Werbeabdeckung pro Produkt prüfen.
Gewinn und Verlust (P&L) auf ASIN- und Kontoebene (Umsatz, Werbeausgaben, COGS, Amazon-Gebühren, Marge, TACoS) sowie Lagerbestandsrisiken analysieren.
Änderungen vorbereiten (Gebote, Keywords, Negatives, Kampagnen, Anzeigengruppen, Produktanzeigen und mehr), die erst wirksam werden, nachdem du sie ausdrücklich freigegeben hast.

Voraussetzungen

Ein Sellantica-Konto auf app.sellantica.ai mit mindestens einem verbundenen Amazon-Ads-Profil.
Ein MCP-Client, der Remote-Server über Streamable HTTP mit OAuth unterstützt, zum Beispiel Claude (Web, Desktop und Mobil), Claude Code oder jeder andere MCP-kompatible Assistent bzw. jedes Agenten-Framework.

Server-URL: https://app.sellantica.ai/api/mcp

KI-Assistenten verbinden

Der Connector ist nicht an einen einzelnen Anbieter gebunden. Jeder Client, der MCP über Streamable HTTP spricht, kann sich mit der obigen Server-URL verbinden, per OAuth oder mit einem persönlichen API-Token. Die folgenden Schritte zeigen Claude als ein Beispiel; andere Assistenten folgen dem gleichen Muster (Remote-MCP-Server hinzufügen, URL eingeben, anmelden, Berechtigungen freigeben).

Claude im Web, auf Desktop und Mobil

Öffne Settings → Connectors und wähle Add custom connector (oder wähle Sellantica aus dem Connector-Verzeichnis, sobald es dort gelistet ist).
Gib https://app.sellantica.ai/api/mcp ein. Lass OAuth-Client-ID und -Secret leer; der Server registriert den Client automatisch.
Klicke auf Connect. Es öffnet sich ein Browserfenster, in dem du dich bei Sellantica anmeldest.
Lege auf dem Sellantica-Zustimmungsbildschirm fest, was der Assistent tun darf (siehe Berechtigungen), und bestätige.

Claude Code

claude mcp add --transport http sellantica https://app.sellantica.ai/api/mcp

Führe danach /mcp in Claude Code aus und authentifiziere dich im Browser.

Skripte und andere MCP-Clients

Clients, die den OAuth-Ablauf nicht ausführen können, können einen persönlichen API-Token verwenden. Erstelle ihn in Sellantica unter Profile → API tokens (er wird nur einmal angezeigt) und sende ihn als Bearer-Token:

{
  "url": "https://app.sellantica.ai/api/mcp/",
  "headers": { "Authorization": "Bearer slt_YOUR_TOKEN" }
}

Authentifizierung und Berechtigungen

OAuth 2.1 mit PKCE und dynamische Client-Registrierung. Access-Tokens laufen nach 60 Minuten ab und werden automatisch erneuert; Refresh-Tokens werden rotiert.
Standardmäßig nur lesend. Wenn du Funktionen und Profile auf dem Zustimmungsbildschirm leer lässt, kann die Verbindung nur Daten lesen.
Schreibzugriff ist Opt-in pro Aktion und pro Amazon-Ads-Profil. Du wählst sie auf dem Zustimmungsbildschirm aus, und jeder Schreibvorgang wird im Moment der Ausführung erneut gegen deine aktuelle Sellantica-Rolle geprüft.
Der Umfang folgt deinem Konto. Der Assistent sieht nur die Profile, die dein Sellantica-Nutzer sehen kann, einschließlich Profilen, die über eine Agentur-Mitgliedschaft mit dir geteilt wurden.
Jederzeit widerrufbar unter Profile → API tokens in Sellantica; OAuth-Verbindungen werden dort als „Connected via OAuth“ aufgeführt. Du kannst den Connector auch in deinem KI-Client trennen.

So werden Änderungen sicher durchgeführt

Jeder Schreibvorgang folgt denselben drei Schritten:

Vorbereiten: Ein prepare_*-Tool validiert die Anfrage und liefert eine Vorschau. Bei Amazon und in Sellantica ändert sich nichts.
Freigeben: approve_write_v1 verlangt die exakte Bestätigungsphrase und den Token aus dieser Vorschau, sodass eine Freigabe nur für genau die Daten gilt, die du gesehen hast.
Ausführen: execute_write_v1 reiht die freigegebene Anfrage in die dauerhafte Schreib-Pipeline von Sellantica ein. Frage get_write_request_v1 ab, bis der finale Status gemeldet wird; „queued“ ist nicht dasselbe wie „von Amazon bestätigt“.

Prüfe die Vorschau immer, bevor du freigibst. Eine Anfrage, deren Aktion für dein Konto nicht für den Live-Versand freigeschaltet ist, wird nur als Vorschau protokolliert und geprüft und nie an Amazon gesendet.

Tool-Referenz

Fast jedes Tool benötigt eine profile_id (und, falls zwei deiner Profile dieselbe ID haben, einen profile_pk). Rufe zuerst list_profiles auf. Zeiträume sind standardmäßig die letzten 30 Tage; Listen-Tools paginieren mit limit (max. 200) und offset.

Nur lesende Tools

Tool	Zweck
`list_profiles`	Amazon-Ads-Profile, auf die du Zugriff hast
`get_profile_summary`	Leistungssummen für ein Profil
`get_campaigns`, `get_ad_groups`, `get_targets`	Kampagnenstruktur mit Kennzahlen
`get_search_terms`	Kunden-Suchbegriffe, die deine Anzeigen ausgelöst haben
`get_negative_targets`	Negative Keywords und negative Produkt-Targets
`get_optimization_suggestions`, `get_optimization_settings`	Gebots- und Statusentscheidungen und die zugrunde liegenden Engine-Einstellungen
`get_domain_proposals`	Budget-, Platzierungs-, Dayparting- und Gebotsvorschläge, die auf Prüfung warten
`get_automation_status`, `get_automation_activity`	Konfiguration des Automatikmodus und abgeschlossene Aktionen
`get_harvesting_candidates`, `get_harvest_destinations`	Keyword-Harvesting-Kandidaten und ihre zugeordneten Ziele
`get_target_suggestions`, `get_product_recommendations`	Keyword- und ASIN-Target-Ideen für ein Produkt
`get_bid_recommendations`, `get_target_bid_recommendations`	Gebotsempfehlungen von Amazon
`get_structure_audit`, `get_product_coverage`	Audit der Kontostruktur und Werbeabdeckung pro ASIN
`get_asin_pnl`, `get_pnl_summary`, `get_product_costs`	Gewinn und Verlust sowie Warenkosten
`get_inventory_planning`	Bestand, Reichweite in Tagen und Risiko eines Out-of-Stock
`get_dayparting`, `get_seasonality`, `get_custom_rules`	Zeitpläne, Saisonalitätsstatus und benutzerdefinierte Regeln
`get_change_history`	Wer was wann geändert hat
`get_write_request_v1`, `get_campaign_setup_job_v1`	Status vorbereiteter Schreibvorgänge und Kampagnen-Setup-Jobs

Schreibende Tools (vorbereiten, dann freigeben und ausführen)

Tool	Änderung
`prepare_campaign_edit_v1`, `prepare_campaign_pause_v1`	Kampagnenname, -status, -budget, -datum; Pausieren
`prepare_campaign_placement_v1`	Gebotsanpassungen für Platzierungen
`prepare_campaign_structure_setup_v1`	Eine komplette neue Kampagnenstruktur für eine Liste von ASINs
`prepare_adgroup_create_v1`, `prepare_adgroup_edit_v1`	Anzeigengruppen erstellen oder bearbeiten
`prepare_keyword_create_v1`, `prepare_product_target_create_v1`	Neue Keyword- und Produkt-Targets
`prepare_target_bid_v1`	Gebot oder Status bestehender Targets
`prepare_negative_create_v1`, `prepare_negative_delete_v1`	Negatives hinzufügen oder entfernen
`prepare_product_ad_create_v1`, `prepare_product_ad_state_v1`	Produktanzeigen erstellen oder deren Status ändern
`prepare_harvest_apply_v1`, `prepare_optimization_decision_apply_v1`	Harvesting-Kandidaten oder Optimierungsentscheidungen anwenden
`prepare_budget_proposal_apply_v1`, `prepare_placement_proposal_apply_v1`, `prepare_dayparting_proposal_apply_v1`	Engine-Vorschläge anwenden
`prepare_coverage_fix_v1`	Lücken in der Produktwerbeabdeckung schließen
`prepare_optimization_settings_v1`, `prepare_automation_settings_v1`, `prepare_product_cost_v1`	Sellantica-Einstellungen und Warenkosten (kein Amazon-Aufruf)
`prepare_review_request_v1`	Amazon-Bewertungsanfrage für eine Bestellung
`approve_write_v1`, `execute_write_v1`	Jede vorbereitete Anfrage freigeben und einreihen

Beispiel-Prompts

„Welche meiner Sponsored-Products-Kampagnen hatten in den letzten 30 Tagen den höchsten ACoS, und welche Suchbegriffe haben die verschwendeten Ausgaben verursacht?“
„Zeig mir meinen Gewinn und TACoS auf ASIN-Ebene für den letzten Monat und markiere Produkte, die innerhalb von zwei Wochen ausverkauft sind.“
„Liste meine offenen Harvesting-Kandidaten auf und bereite die fünf besten Keywords zur Freigabe für mich vor.“

Limits

120 Anfragen pro Minute und Verbindung.
P&L-Tools akzeptieren höchstens 92 Tage pro Anfrage; andere Tools bis zu 366 Tage.
Die Daten stammen aus der letzten Synchronisierung von Sellantica mit Amazon; lesende Tools lösen keine Live-Aufrufe bei Amazon aus.

Fehlerbehebung

„Token is not authorized“ bei einem Schreibvorgang: Die Aktion oder das Profil wurde auf dem Zustimmungsbildschirm nicht erteilt. Trenne den Connector, verbinde ihn erneut und wähle sie dann aus.
Leere Profilliste: Verbinde zuerst ein Amazon-Ads-Konto in Sellantica oder bitte den Profilinhaber, es mit dir zu teilen.
Anmeldeschleife: Stelle sicher, dass du im Browserfenster, das sich bei der Verbindung öffnet, beim selben Sellantica-Konto angemeldet bist.

Daten und Datenschutz

Der Connector liest und schreibt Daten ausschließlich in deinem eigenen Sellantica-Konto. Jeder Tool-Aufruf wird zu Prüfzwecken protokolliert. Sellantica empfängt oder speichert keine Unterhaltungen mit deinem KI-Assistenten; es verarbeitet nur die an Sellantica gesendeten Tool-Aufrufe. Details findest du in unserer Datenschutzerklärung.

Support

Fragen oder Probleme: info@hof-digital.de oder über unsere Kontaktseite.

Zurück zur Startseite