MCP · Claude · Bol.com
Claude.ai · Desktop · Claude Code
Bol.com in Claude: de gehoste Bol MCP-connector
Om Bol.com aan Claude te koppelen, voeg je de gehoste MCP-server van Marktspan (https://marktspan.com/api/mcp) toe als custom connector in Claude en log je in met Marktspan. Claude analyseert dan je Bol-shop — orders, contributie na commissie en LVB-kosten, Sponsored Products, zoekvraag en factuurregels — met dezelfde cijfers als je P&L.
URL voor de Claude-connector
https://marktspan.com/api/mcp
De Bol.com-connector toevoegen aan Claude
Dezelfde URL werkt in Claude.ai, Claude Desktop en Claude Code. Koppel eerst je Bol-shop in Marktspan en zet MCP aan onder Instellingen → MCP.
- Claude.ai en Desktop: Instellingen → Connectors → Custom connector toevoegen → naam Marktspan → plak https://marktspan.com/api/mcp → Verbinden en log in met Marktspan.
- Team en Enterprise: een owner voegt de connector één keer toe in de organisatie-instellingen; elk lid logt in met een eigen Marktspan-account en rol.
- Claude Code: `claude mcp add --transport http marktspan https://marktspan.com/api/mcp`, daarna `/mcp` om in te loggen.
- Start een nieuwe chat en vraag “Welke Bol-shops kun je zien?” om de koppeling te checken.
Waar Claude goed in is met Bol-data
Claude is sterk in lange analyses in meerdere stappen. Stel een vraag en Claude koppelt de tools: shops ophalen, contributie, EAN's, ads, en dan de samenvatting.
- Een daling in contributie op Bol NL verklaren: welke EAN's, welke kostenpost, en of voorraad of ads veranderden.
- Een wekelijks Bol-rapport schrijven op live cijfers in plaats van een geplakte export.
- Bol NL en BE naast elkaar vergelijken zonder de data te mengen.
- Bol-factuurkosten per order en EAN afstemmen (finance-rol).
Gehoste connector vs. een lokale Bol MCP-server
Community Bol MCP-servers draaien op je eigen computer met je Retailer API client ID en secret en geven ruwe API-antwoorden terug. De connector van Marktspan is gehost, logt in via OAuth, houdt Bol-credentials in je workspace en antwoordt met opgeschoonde EUR-data waarin orders, kosten, ads en facturen al gekoppeld zijn.
Standaard read-only
Claude kan lezen en analyseren, maar je Bol-listings, prijzen of biedingen niet wijzigen. Biedwijzigingen lopen via Ad Pilot-goedkeuring of beheerste write-tools op geschikte plannen, altijd eerst met een dry run.
Tools die Claude gebruikt voor Bol.com
Een selectie. Claude kiest de tool op basis van je vraag. Ads-tools vereisen het Scale-plan; factuurregels vereisen een finance- of admin-rol.
| Tool | Plan | Wat je krijgt | Vraag Claude… |
|---|---|---|---|
| whoami | Start+ | Je workspace en de Bol.com NL- en BE-shops die de assistent ziet. | Welke Bol-shops kun je zien? |
| query_metric | Start+ | Omzet, orders, stuks en contributie per dag, EAN of shop. | Top 10 EAN's op contributie op Bol NL vorige maand. |
| get_search_terms | Growth+ | Sponsored Products-zoektermen met kliks, kosten, conversies en ACoS. | Welke zoektermen kostten deze week geld zonder orders? |
| search_keyword_demand | Start+ | Bol.com zoekvolume, trend en gemiddeld winnend bod. | Hoe groot is de vraag naar 'luchtbevochtiger' en wanneer piekt die? |
| query_viz · bol_finance_report_lines | Start+ · finance-rol | Bol-factuurregels: commissie, fulfilment, verzending en retouren per order en EAN. | Hoeveel commissie rekende Bol in september op EAN 8712345678906? |
Bol.com-workflows in Claude
Oorzaak van een slechte week
“De contributie op Bol NL daalde vorige week 18%. Zoek de EAN's die dat veroorzaken, check voorraad en ad spend per EAN en vat samen in vijf punten.”
Memo voor een nieuwe categorie
Laat Claude Bol-bladcategorieën rangschikken op vraag, bestsellers en winnende biedingen ophalen voor de top twee en de unit economics bij je doelprijs schatten.
Facturen afstemmen
Vraag Claude om Bol-commissie en fulfilmentkosten per order voor een product in een maand op te sommen en regels te markeren die afwijken van het commissietarief.
FAQ
- Is er een officiële Bol.com-connector voor Claude?
- Nee. bol.com publiceert geen Claude-connector of MCP-server. Marktspan host een Bol MCP-server die je als custom connector aan Claude toevoegt.
- Hoe koppel ik Bol.com aan Claude?
- Koppel je Bol-shop in Marktspan, open in Claude Instellingen → Connectors → Custom connector toevoegen, plak https://marktspan.com/api/mcp en log in met Marktspan.
- Werkt het in Claude Code en Claude Desktop?
- Ja. Claude Desktop gebruikt dezelfde connector-instellingen als Claude.ai. In Claude Code voeg je de URL toe met `claude mcp add --transport http`.
- Kan Claude Bol-facturen en commissie lezen?
- Ja, voor gebruikers met een finance- of admin-rol: Bol-factuurregels per order en EAN met commissie, fulfilment, verzending en retourkosten.
- Krijgt Claude mijn Bol API-keys?
- Nee. Claude logt in bij Marktspan via OAuth. De Bol-koppeling en de credentials blijven in je workspace.
- Werkt dezelfde server in ChatGPT?
- Ja. Zie de pagina Bol.com in ChatGPT voor de stappen in ChatGPT.
Zet je Bol.com-shop in Claude
We voegen de connector samen toe in een kort gesprek.