Cookie voorkeuren beheren
Spartoo gebruikt cookies die strikt noodzakelijk zijn voor de functionele werking van de website, evenals voor de personalisatie van de inhoud en de analyse van het webverkeer. Onze partners gebruiken cookies om gepersonaliseerde advertenties weer te geven op basis van uw browsgedrag en uw profiel. Als je hieronder op "Accepteren en sluiten" klikt,accepteert u dit en gaat u ermee akkoord dat wij deze informatie mogen delen met derden, zoals onze marketingpartners. Kunt u uw voorkeuren op elk moment in uw klantenaccount wijzigen. Als u op "weigeren" klikt, worden alleen de cookies gebruikt die strikt noodzakelijk zijn voor de functionele werking van de website. Voor meer informatie kunt u onze privacyverklaring lezen.
Gratis levering en retour
Gratis levering en retour
Spartoo
account
Favorieten
0 winkelmand
Menu

Spartoo MCP-server: een AI-assistent koppelen aan de catalogus

Spartoo biedt een MCP-server (Model Context Protocol) waarmee een AI-assistent (Claude, ChatGPT, Cursor...) de catalogus van de site in alleen-lezen modus kan raadplegen: productzoeken, productdetails en beschikbare filters. De prijzen en voorraad zijn die van Spartoo, in EUR.

Serveradres

Spartoo MCP-serveradres:

https://www.spartoo.nl/mcp

Er is één server per site en per land: elke site heeft zijn eigen adres, met zijn eigen catalogus, prijzen en valuta. Gebruik het adres van de site waarop u producten wilt zoeken.

Technische specificaties

  • Transport: Streamable HTTP (POST-verzoeken, JSON-antwoorden).
  • Authenticatie: geen. Geen account of API-sleutel vereist.
  • Ondersteunde MCP-protocolversies: 2025-11-25, 2025-06-18, 2025-03-26.

Verbind uw AI-assistent

  • Claude: voeg een aangepaste connector toe vanuit de connectorinstellingen door het serveradres op te geven. Er is geen authenticatie vereist.
  • Claude Code: voer het volgende commando uit in een terminal:
    claude mcp add --transport http spartoo https://www.spartoo.nl/mcp
  • ChatGPT: als uw abonnement het toevoegen van een aangepaste MCP-connector toestaat, voert u het serveradres in, zonder authenticatie.
  • Andere MCP-clients (Cursor, VS Code...): declareer een externe MCP-server van het type HTTP (Streamable HTTP) met het serveradres. De procedure hangt af van de client: raadpleeg de documentatie hiervan.

Zodra de server is verbonden, stelt u eenvoudig uw vraag aan de assistent, bijvoorbeeld: "Vind witte damessneakers in maat 38 op Spartoo".

Aangezien de tools alleen-lezen zijn, kunt u ze instellen op "Altijd toestaan" in de instellingen van de connector (Claude) of in de machtigingen van uw client, om te voorkomen dat u bij elke zoekopdracht om toestemming wordt gevraagd.

Beschikbare tools

De tools zijn alleen-lezen. Typische volgorde: beschikbare zoekfilters ontdekken, producten zoeken met deze filters, en vervolgens de details van een gekozen product weergeven.

list_filters → search_products → get_product

list_filters

Geeft een lijst met beschikbare waarden om een zoekopdracht te verfijnen: merken, kleuren, maten, geslachten, categorieën (met aantal producten indien bekend), prijsbereik en het totaal aantal producten. Te gebruiken vóór het zoeken naar producten, om keuzes voor te stellen of te controleren of een waarde bestaat. Een zoekopdracht die te breed is (zonder categorie, merk of bekend trefwoord) wordt geweigerd met een bericht: deze moet dan worden gepreciseerd.

Argumenten: query (verplicht), gender, brand, color, size, price_min, price_max

search_products

Zoek producten met vrije tekst, zoals die zou worden ingevoerd in de zoekmachine van de site en in de taal daarvan. Woorden voor merk, categorie, kleur en geslacht worden filters; optionele argumenten vervangen of verfijnen de zoekopdracht (maat op voorraad, prijs in de valuta van de site, sortering). De resultaten zijn gepagineerd (tot 50 producten per pagina) en geven aan hoe de zoekopdracht werd begrepen.

Argumenten: query (verplicht), gender, brand, color, size, price_min, price_max, sort, page, page_size

get_product

Geeft de volledige productfiche terug, of maximaal 10 producten om ze te vergelijken, op basis van de ID's die door de zoekopdracht zijn geretourneerd: beschrijving, prijs, maten en hun beschikbaarheid, foto's, andere kleuren van hetzelfde model en kenmerken (materialen, hakhoogte, land van fabricage...).

Argumenten: product_id, product_ids

Beperkingen

  • Geen aankoop: de server staat niet toe om bestellingen te plaatsen of een winkelwagentje te beheren. Elk geretourneerd product bevat de link naar de pagina op de site.
  • Geen klantaccount: alleen openbare catalogusgegevens zijn toegankelijk (geen bestellingen, adressen of andere accountgegevens).
  • Zoekopdrachten worden uitgevoerd in de taal van de site: formuleer ze zoals in de zoekmachine van Spartoo.

Gegevens en privacy

De server vraagt geen persoonlijke gegevens en heeft geen toegang tot klantaccounts. Voor servicebewaking en beveiliging wordt elke aanroep gelogd met: de gedetecteerde AI-assistent (clientnaam en versie), de user-agent, het IP-adres, de aangeroepen methode en tool met hun argumenten, de status en de duur van de respons. De inhoud van de antwoorden wordt niet gelogd.

Voor meer informatie kunt u onze privacyverklaring raadplegen.

Ondersteuning

Heb je een vraag of probleem met de MCP-server? Neem contact op met onze klantenservice.

Ontdek de Spartoo-applicatie...
Klik hier

Wordt lid van ons panel en maak kans op 100€

Volg ons

Copyright © 2006 - 2026