MCP · Bol.com
Lesen und Schreiben · mit Guardrails
Bol.com MCP Server für Claude, ChatGPT und Cursor
Mit dem Bol.com MCP Server von Marktspan lesen Claude, ChatGPT, Cursor oder jeder MCP Client Ihren Bol.com Shop in normaler Sprache und handeln danach: Deckungsbeitrag prüfen, verschwendetes Werbebudget finden und dann Preise, Gebote und Budgets ändern. Jede Änderung startet als Vorschau, und große Sprünge brauchen Ihre ausdrückliche Bestätigung.
URL des Bol.com MCP Servers
https://marktspan.com/api/mcp
Bol.com mit Claude, ChatGPT oder Cursor verbinden
Drei Schritte, etwa fünf Minuten. Dieselbe URL funktioniert in jedem MCP Client.
- Marktspan Workspace anlegen und Bol.com NL oder BE verbinden (einmalig in der App).
- Claude: Einstellungen → Connectors → Custom Connector → https://marktspan.com/api/mcp einfügen. ChatGPT: Developer Mode → MCP App anlegen → dieselbe URL. Cursor: URL als Remote MCP Server in mcp.json eintragen.
- Mit Marktspan anmelden und wählen, ob der Assistent nur lesen oder auch Änderungen vornehmen darf.
Lesen: Ihren Bol.com Shop verstehen
Der Assistent wählt das passende Tool. Antworten nutzen dieselben Zahlen wie Ihre Marktspan P&L und Ad Pilot.
- Umsatz, Bestellungen und Deckungsbeitrag pro Tag, EAN oder Shop, nach Provision, LVB-Gebühren und Werbekosten.
- Warum sich Umsatz oder Gewinn eines Produkts bewegt hat, mit Ursache: Buy Box, Bestand, Preis, Ads oder Kosten.
- Sponsored Products: Spend, ACoS, TACoS, Kampagnen und Suchbegriffe, die Geld ohne Bestellung kosten.
- Suchnachfrage auf Bol.com: Volumen, Trend, Gewinnergebote und die besten Unterkategorien.
- Finance: Bol-Rechnungszeilen pro Bestellung und EAN (Provision, Pick & Pack, Versand, Retouren).
- Änderungsverlauf: jede Gebots- und Budgetänderung mit altem und neuem Wert.
Schreiben: direkt im selben Chat handeln
Verbinden Sie mit Schreibrechten, setzt der Assistent die Änderung um, die Sie gerade besprochen haben.
- Bol-Angebotspreise für eine EAN oder eine ganze Liste aktualisieren.
- Keyword-Gebote erhöhen, senken, pausieren oder aktivieren.
- Kampagnenbudgets, Laufzeiten, NL- und BE-Targeting und Kanäle ändern oder Kampagnen an- und ausschalten.
- Neue Keywords hinzufügen und Suchbegriffe ausschließen, die Budget verschwenden.
- Eine komplette neue Kampagne aus einem Plan anlegen (pausiert, damit nichts ausgegeben wird, bevor Sie prüfen).
- Einstandspreise und Produktdaten aus einer Tabelle aktualisieren, damit der Deckungsbeitrag stimmt.
Guardrails bei jeder Änderung
Schreiben in einen Live-Shop braucht mehr als ein Ja. Diese Prüfungen laufen bei jeder Änderung, in jedem KI-Client.
- Erst die Vorschau: Jede Änderung läuft als Dry Run. Nichts erreicht Bol.com, bevor Sie bestätigen.
- Aktuell neben neu: Die Vorschau zeigt aktuellen Preis, aktuelles Gebot oder Budget, den neuen Wert und die Änderung in %.
- 50%-Regel: Jeder Preis, jedes Gebot und jedes Budget, das mehr als 50% vom aktuellen Wert abweicht, wird markiert und blockiert, bis Sie genau diese Änderung ausdrücklich bestätigen.
- Gebotsgrenzen: Gebote über 7,50 € brauchen eine zusätzliche Bestätigung, Gebote über 10 € oder weit über dem Gewinnergebot des Marktes erzeugen eine Warnung, und Gebote außerhalb von Bols Spanne von 0,20 € bis 50 € werden abgelehnt.
- Begrenzter Zugriff: Schreibrechte sind eine eigene Wahl bei der Anmeldung, nur Operatoren können schreiben, und Produktzugriffsgruppen legen fest, welche EANs geändert werden dürfen. NL und BE werden nie vermischt.
- Vollständiger Audit Trail: Jeder Aufruf wird protokolliert, und Sie können den Assistenten fragen, was sich wann geändert hat.
Bol.com MCP Tools
Eine Auswahl dessen, was der Server bereitstellt. Ihre KI wählt das Tool.
| Tool | Typ | Ergebnis | Beispielfrage |
|---|---|---|---|
| query_metric | Lesen | Umsatz, Bestellungen, Deckungsbeitrag und Bestandsreichweite aus Ihrer Bol P&L, nach Provision, LVB-Gebühren und Werbekosten. | Ist der Deckungsbeitrag auf Bol NL letzte Woche gesunken? |
| query_metric · sales_pulse_diagnose | Lesen | Warum sich Umsatz oder Gewinn eines Produkts bewegt hat: Buy Box verloren, ausverkauft, Preisänderung, weniger Ads, unter Kosten. | Welche EANs haben diesen Monat am meisten Umsatz verloren, und warum? |
| get_ad_decision_pack | Lesen | TACoS, Deckungsbeitrag, Mindestpreis, Stückkosten und Bestand pro Produkt, bevor Sie ein Gebot ändern. | Kann ich bei meinen Top 10 Produkten höher bieten? |
| get_search_terms | Lesen | Suchbegriffe mit Klicks, Kosten, Conversions und ACoS. | Welche Suchbegriffe haben diesen Monat Geld ohne Bestellung gekostet? |
| search_keyword_demand | Lesen | Bol.com Suchvolumen, Trend und durchschnittliches Gewinnergebot. Funktioniert ohne verbundenen Shop. | Wonach suchen Niederländer rund um 'airfryer'? |
| query_viz · bol_finance_report_lines | Lesen | Bol-Rechnungszeilen pro Bestellung und EAN: Provision, Pick & Pack, Versand, Retouren, Korrekturen. | Wie viel Provision hat Bol im September auf diese EAN berechnet? |
| get_ad_activity | Lesen | Jede Gebots- und Budgetänderung mit altem Wert, neuem Wert, Zeitpunkt und Quelle. | Was hat sich diese Woche in meinen Kampagnen geändert? |
| update_offer_prices | Schreiben | Bol-Angebotspreise ändern. Die Vorschau zeigt aktuellen Preis, neuen Preis und Änderung in %. | Erhöhe diese fünf EANs um 5% und zeig mir die Vorschau. |
| update_keyword_bids | Schreiben | Keyword-Gebote setzen oder Keywords pausieren und aktivieren, mit aktuellem Gebot neben dem neuen. | Senke die Gebote für Keywords mit ACoS über 40%. |
| update_campaign | Schreiben | Tages- oder Gesamtbudget, an oder aus, Start- und Enddatum, NL- und BE-Targeting, Kanäle. | Erhöhe das Budget meiner besten Kampagne auf 40 € pro Tag. |
| create_keywords · create_negative_keywords | Schreiben | Exact- oder Phrase-Keywords hinzufügen oder Suchbegriffe ausschließen, die Budget verschwenden. | Schließe die Suchbegriffe aus, die Geld ohne Bestellung gekostet haben. |
| create_campaign | Schreiben | Eine komplette Sponsored-Products-Kampagne aus einem Plan anlegen. Standardmäßig pausiert. | Leg eine Kampagne für meine neuen Airfryer-EANs mit 20 € pro Tag an. |
| import_product_sheet | Schreiben | Einstandspreis, Lifecycle, Kategorie, Maße und Segmente aus einer Tabelle aktualisieren, damit die P&L stimmt. | Hier ist meine neue Einkaufspreisliste, aktualisiere die Einstandspreise. |
Beispiel Workflows
Vom Wochenreview zur Korrektur in einem Chat
Fragen, wie sich der Deckungsbeitrag auf Bol NL letzte Woche entwickelt hat, in die EANs dahinter einsteigen und die Gebote senken, die sich nicht mehr rechnen. Die Vorschau zeigt jedes Gebot vorher und nachher.
Verschwendetes Werbebudget streichen
Fragen, welche Suchbegriffe Budget ohne Bestellung verbraucht haben, sie ausschließen und die Keywords pausieren, die weiter Geld verlieren.
Sicher umpreisen
EANs unter ihrem Mindestpreis abfragen, neue Preise vorbereiten und die Vorschau prüfen. Ein Tippfehler, der einen Preis halbieren würde, wird von der 50%-Regel abgefangen.
FAQ
- Was ist ein Bol.com MCP Server?
- Ein MCP Server (Model Context Protocol) gibt KI Assistenten wie Claude, ChatGPT und Cursor Tools zum Lesen und Ändern von Daten. Ein Bol.com MCP Server verbindet sie mit Ihrem Bol Verkäuferkonto: Bestellungen, Umsatz, Ads, Keywords und Preise.
- Wie verbinde ich Bol.com mit Claude?
- Bol Shop in Marktspan verbinden, in Claude Einstellungen → Connectors → Custom Connector öffnen, https://marktspan.com/api/mcp einfügen und mit Marktspan anmelden.
- Funktioniert das mit ChatGPT und Cursor?
- Ja. Jeder Client mit Remote MCP Unterstützung nutzt dieselbe URL: ChatGPT (Developer Mode), Cursor, Claude Code, VS Code und weitere.
- Kann der Assistent Preise, Gebote und Budgets auf Bol ändern?
- Ja, wenn Sie bei der Anmeldung Schreibrechte erteilen. Jede Änderung startet als Vorschau mit aktuellem und neuem Wert und geht erst nach Ihrer Bestätigung live.
- Was verhindert, dass eine falsche Änderung live geht?
- Jede Änderung ist zuerst ein Dry Run. Änderungen von mehr als 50% gegenüber aktuellem Preis, Gebot oder Budget bleiben blockiert, bis Sie sie ausdrücklich bestätigen, hohe Gebote brauchen eine zusätzliche Bestätigung, und jeder Aufruf wird protokolliert.
- Muss ich Bol API Keys in meine KI App einfügen?
- Nein. Sie melden sich per OAuth bei Marktspan an. Die Bol Verbindung liegt in Ihrem Workspace; der Assistent erhält nie Retailer API Zugangsdaten.
Steuern Sie Ihren Bol.com Shop aus dem Assistenten, den Ihr Team schon nutzt
Wir gehen das Connector Setup in Ihrem Workspace durch.