MCP · Bol.com
Lezen en schrijven · met guardrails
Bol.com MCP-server voor Claude, ChatGPT en Cursor
Met de Bol.com MCP-server van Marktspan lezen Claude, ChatGPT, Cursor of elke MCP-client je Bol.com-shop in gewone taal en handelen ze erop: contributie checken, verspilde ad spend vinden en daarna prijzen, biedingen en budgetten aanpassen. Elke wijziging begint als preview en grote stappen vragen jouw expliciete bevestiging.
Bol.com MCP server-URL
https://marktspan.com/api/mcp
Bol.com koppelen aan Claude, ChatGPT of Cursor
Drie stappen, ongeveer vijf minuten. Dezelfde URL werkt in elke MCP-client.
- Maak een Marktspan-workspace en koppel je Bol.com NL- of BE-shop (eenmalig in de app).
- Claude: Instellingen → Connectors → Custom connector → plak https://marktspan.com/api/mcp. ChatGPT: developer mode → MCP-app aanmaken → dezelfde URL. Cursor: voeg de URL toe als remote MCP-server in mcp.json.
- Log in met Marktspan en kies of de assistent alleen mag lezen of ook wijzigingen mag doen.
Lezen: begrijp je Bol.com-shop
De assistent kiest de juiste tool. Antwoorden gebruiken dezelfde cijfers als je Marktspan P&L en Ad Pilot.
- Omzet, orders en contributie per dag, EAN of shop, na commissie, LVB-kosten en advertenties.
- Waarom omzet of winst van een product bewoog, met de oorzaak: Buy Box, voorraad, prijs, ads of kostprijs.
- Sponsored Products: spend, ACoS, TACoS, campagnes en zoektermen die geld kosten zonder orders.
- Zoekvraag op Bol.com: volume, trend, winnende biedingen en de beste subcategorieën.
- Finance: Bol-factuurregels per order en EAN (commissie, pick & pack, verzending, retouren).
- Wijzigingshistorie: elke bod- en budgetwijziging met oude en nieuwe waarde.
Schrijven: handel direct vanuit dezelfde chat
Koppel je met schrijfrechten, dan voert de assistent de wijziging uit die je net besprak.
- Bol-offerprijzen bijwerken voor één EAN of een hele lijst.
- Keywordbiedingen verhogen, verlagen, pauzeren of activeren.
- Campagnebudgetten, data, NL- en BE-targeting en kanalen aanpassen, of campagnes aan- en uitzetten.
- Nieuwe keywords toevoegen en zoektermen uitsluiten die budget verspillen.
- Een complete nieuwe campagne aanmaken vanuit een plan (gepauzeerd, zodat niets uitgeeft voordat je het checkt).
- Kostprijzen en productdata bijwerken vanuit een sheet, zodat je contributie klopt.
Guardrails op elke wijziging
Schrijven naar een live shop vraagt meer dan een ja. Deze checks draaien bij elke wijziging, in elke AI-client.
- Eerst een preview: elke wijziging draait als dry run. Niets bereikt Bol.com voordat je bevestigt.
- Huidig naast nieuw: de preview toont de huidige prijs, het huidige bod of budget, de nieuwe waarde en de wijziging in %.
- 50%-regel: elke prijs, elk bod of budget dat meer dan 50% afwijkt van de huidige waarde wordt gemarkeerd en geblokkeerd tot je die wijziging expliciet bevestigt.
- Biedlimieten: biedingen boven €7,50 vragen een extra bevestiging, biedingen boven €10 of ver boven het winnende marktbod krijgen een waarschuwing, en biedingen buiten Bols bereik van €0,20 tot €50 worden geweigerd.
- Afgebakende toegang: schrijfrechten zijn een aparte keuze bij het inloggen, alleen operators kunnen schrijven en producttoegangsgroepen bepalen welke EAN's mogen wijzigen. NL en BE worden nooit gemengd.
- Volledige audit trail: elke call wordt gelogd en je kunt de assistent vragen wat er wanneer veranderde.
Bol.com MCP-tools
Een selectie van wat de server aanbiedt. Je AI kiest de tool.
| Tool | Type | Wat je krijgt | Probeer te vragen… |
|---|---|---|---|
| query_metric | Lezen | Omzet, orders, contributie en voorraaddekking uit je Bol P&L, na commissie, LVB-kosten en advertenties. | Daalde de contributie op Bol NL vorige week? |
| query_metric · sales_pulse_diagnose | Lezen | Waarom omzet of winst van een product bewoog: Buy Box kwijt, uitverkocht, prijswijziging, minder ads, onder kostprijs. | Welke EAN's verloren deze maand de meeste omzet, en waarom? |
| get_ad_decision_pack | Lezen | TACoS, contributie, bodemprijs, kostprijs en voorraad per product voordat je een bod aanpast. | Kan ik meer bieden op mijn top 10 producten? |
| get_search_terms | Lezen | Zoektermen met kliks, kosten, conversies en ACoS. | Welke zoektermen kostten deze maand geld zonder orders? |
| search_keyword_demand | Lezen | Bol.com zoekvolume, trend en gemiddeld winnend bod. Werkt zonder gekoppelde shop. | Waar zoeken Nederlanders op rond 'airfryer'? |
| query_viz · bol_finance_report_lines | Lezen | Bol-factuurregels per order en EAN: commissie, pick & pack, verzending, retouren, correcties. | Hoeveel commissie rekende Bol in september op deze EAN? |
| get_ad_activity | Lezen | Elke bod- en budgetwijziging met oude waarde, nieuwe waarde, tijd en bron. | Wat is er deze week in mijn campagnes veranderd? |
| update_offer_prices | Schrijven | Bol-offerprijzen wijzigen. De preview toont huidige prijs, nieuwe prijs en wijziging in %. | Verhoog deze vijf EAN's met 5% en toon de preview. |
| update_keyword_bids | Schrijven | Keywordbiedingen zetten, of keywords pauzeren en activeren, met het huidige bod naast het nieuwe. | Verlaag biedingen op keywords met ACoS boven 40%. |
| update_campaign | Schrijven | Dag- of totaalbudget, aan of uit, start- en einddatum, NL- en BE-targeting, kanalen. | Verhoog het budget van mijn beste campagne naar €40 per dag. |
| create_keywords · create_negative_keywords | Schrijven | Exact- of phrase-keywords toevoegen, of zoektermen uitsluiten die budget verspillen. | Sluit de zoektermen uit die geld kostten zonder orders. |
| create_campaign | Schrijven | Een complete Sponsored Products-campagne bouwen vanuit een plan. Standaard gepauzeerd aangemaakt. | Maak een campagne voor mijn nieuwe airfryer-EAN's met €20 per dag. |
| import_product_sheet | Schrijven | Kostprijs, lifecycle, categorie, afmetingen en segmenten bijwerken vanuit een sheet, zodat je P&L klopt. | Hier is mijn nieuwe kostprijssheet, werk de kostprijzen bij. |
Voorbeeldworkflows
Van weekreview naar actie in één chat
Vraag hoe de contributie op Bol NL vorige week bewoog, zoom in op de EAN's erachter en verlaag de biedingen die zich niet meer terugverdienen. De preview toont elk bod voor en na.
Verspilde ad spend schrappen
Vraag welke zoektermen budget kostten zonder orders, sluit ze uit en pauzeer de keywords die geld blijven verliezen.
Veilig herprijzen
Vraag naar EAN's onder hun bodemprijs, bereid nieuwe prijzen voor en bekijk de preview. Een typfout die een prijs halveert, wordt door de 50%-regel tegengehouden.
FAQ
- Wat is een Bol.com MCP-server?
- Een MCP-server (Model Context Protocol) geeft AI-assistenten zoals Claude, ChatGPT en Cursor tools om data te lezen en te wijzigen. Een Bol.com MCP-server koppelt ze aan je Bol-verkoopaccount: orders, omzet, ads, zoekwoorden en prijzen.
- Hoe koppel ik Bol.com aan Claude?
- Koppel je Bol-shop in Marktspan, open in Claude Instellingen → Connectors → Custom connector, plak https://marktspan.com/api/mcp en log in met Marktspan.
- Werkt het met ChatGPT en Cursor?
- Ja. Elke client met remote MCP-ondersteuning werkt met dezelfde URL: ChatGPT (developer mode), Cursor, Claude Code, VS Code en meer.
- Kan de assistent prijzen, biedingen en budgetten op Bol wijzigen?
- Ja, als je bij het inloggen schrijfrechten geeft. Elke wijziging begint als preview met huidige en nieuwe waarden en gaat pas live na jouw bevestiging.
- Wat houdt een verkeerde wijziging tegen?
- Elke wijziging is eerst een dry run. Wijzigingen van meer dan 50% ten opzichte van de huidige prijs, het bod of budget worden geblokkeerd tot je ze expliciet bevestigt, hoge biedingen vragen extra bevestiging en elke call wordt gelogd.
- Moet ik Bol API-keys in mijn AI-app plakken?
- Nee. Je logt in bij Marktspan via OAuth. De Bol-koppeling staat in je workspace; de assistent krijgt nooit Retailer API-credentials.
Stuur je Bol.com-shop aan vanuit de assistent die je team al gebruikt
We lopen de connector-setup op jouw workspace door.