Zeven concrete taken die een AI-assistent via de Shopware MCP-server overneemt, met voorbeeldprompt, tools, rechten en veelgemaakte fouten.
Met de Shopware MCP-server voert een AI-assistent zoals Claude of ChatGPT echte taken in uw webshop uit: rapporten maken, voorraad controleren, klanten vinden, verzendingen boeken, producteksten aanvullen, artikelen aanmaken en instellingen wijzigen. De server hoort sinds Shopware 6.7.14 vast bij de kern en werkt met de rechten van een integratie die u in de Administratie aanmaakt.
Elke wijziging draait eerst als voorbeeld. Shopware noemt dat een dry run: het model toont wat het zou wijzigen en schrijft pas na een tweede, bevestigde aanroep. De enige uitzondering is het uploaden van afbeeldingen, dat direct opslaat.
Het nut hangt minder af van de AI dan van goed ingerichte rollen. Wie voor elke taak een eigen integratie met een strakke allowlist aanmaakt, kan leestaken op de eerste dag gebruiken en schrijfrechten stap voor stap vrijgeven.
Dit artikel is bedoeld voor webshopeigenaren, e-commercemanagers en teamleiders klantenservice die een Shopware 6.7-shop beheren en willen weten welk werk een AI-assistent vandaag concreet overneemt. De basis van het protocol, de clients en de inrichting leest u in ons artikel MCP-server voor Shopware. Hier draait het om de praktijk: zeven taken met een voorbeeldprompt, de tools op de achtergrond, de benodigde rechten en de punten waarop u moet letten.
De MCP-server is een interface in uw shop waarmee een AI-assistent gegevens leest en na goedkeuring wijzigt. Hij draait onder /api/_mcp en gebruikt de Admin API, de beheerinterface van Shopware. Shopware introduceerde hem in versie 6.7.11 achter een feature flag, sinds 6.7.14 staat hij altijd aan. Volgens de release notes verbetert versie 6.7.16 van november 2026 onder meer de verwerking van grote toolantwoorden. Tot Shopware 6.8 geldt de server als experimenteel, toolnamen kunnen dus nog veranderen.
Shopware levert geen speciale opdrachten zoals “dagrapport” of “klant zoeken”. Er zijn generieke tools die met elke entiteit werken, dus met elk gegevenstype zoals product, bestelling of klant:
shopware-entity-search zoekt records, shopware-entity-read leest een enkel record, shopware-entity-schema toont de velden van een entiteit.shopware-entity-aggregate berekent sommen, gemiddelden, tellingen en verlopen direct in Shopware, zonder rijen over te dragen.shopware-entity-upsert maakt aan of wijzigt, shopware-entity-delete verwijdert, beide standaard als voorbeeld.shopware-order-state wijzigt de status van bestelling, betaling en levering, shopware-media-upload laadt afbeeldingen van een URL, shopware-system-config-read en shopware-system-config-write lezen en wijzigen instellingen, shopware-theme-config het thema.Daarbij komen resources met referentiegegevens zoals shopware://sales-channels, shopware://currencies of shopware://state-machines. Daaruit leest het model bijvoorbeeld welke statuswijzigingen voor een bestelling zijn toegestaan.
MCP is gebouwd voor de dialoog. Shopware beperkt de aanroepen op het admin-endpoint tot 300 per minuut en 1.000 per tien minuten. Voor het importeren van 20.000 prijzen blijft de Sync API via de Shopware Admin API de juiste weg. Ook processen die ’s nachts zonder mensen draaien, horen in een koppeling of een workflow, niet in een chat.
De meest voorkomende taak is meteen de veiligste: cijfers opvragen. In veel shops betekent dat nu bestellingen exporteren, in Excel filteren en een draaitabel bouwen. Met MCP stelt u de vraag direct.
Voorbeeldprompt: “Hoeveel omzet hadden we gisteren per verkoopkanaal, hoeveel bestellingen waren het en hoe hoog was de gemiddelde orderwaarde? Vergelijk met dezelfde weekdag vorige week.”
Het model leest de verkoopkanalen uit de resource, roept shopware-entity-aggregate aan op de entiteit order en berekent som en gemiddelde van amountTotal plus een telling, gefilterd op datum. Voor de weekvergelijking komt er een tweede aanroep bij. Shopware levert alleen de resultaten, geen afzonderlijke bestellingen. Dat houdt het antwoord klein en beschermt klantgegevens.
De integratie heeft alleen leesrechten op bestellingen en verkoopkanalen nodig. In de allowlist volstaan shopware-entity-schema, shopware-entity-search en shopware-entity-aggregate. Schrijvende tools ontbreken helemaal.
Wie zelf voorraad houdt, verliest omzet door lege schappen en kapitaal door volle. Een AI-assistent vervangt geen voorraadsysteem, maar levert in seconden een lijst waarvoor anders iemand moet filteren en sorteren.
Voorbeeldprompt: “Toon alle actieve producten met een voorraad onder 10, gesorteerd op verkochte aantallen van de afgelopen 30 dagen. Schat per product hoeveel dagen de voorraad nog strekt.”
Het model zoekt met shopware-entity-search producten met de filters active en stock kleiner dan 10. De verkochte aantallen bepaalt het via een aggregatie op orderregels. De dekking rekent het model zelf uit: voorraad gedeeld door de gemiddelde dagafzet. Die berekening moet u begrijpen, want ze komt niet uit Shopware.
Leesrechten op producten en bestellingen volstaan. Moet het model de voorraad na een levering ook corrigeren, dan komt shopware-entity-upsert met wijzigingsrecht op producten erbij. In de praktijk scheiden we dat in een eigen integratie voor het magazijn.
In de klantenservice kost niet het antwoord tijd, maar het bij elkaar zoeken: klantaccount vinden, bestelling openen, betaalstatus controleren, trackingnummer kopiëren. Precies dat neemt de assistent over.
Voorbeeldprompt: “Zoek de klant met bestelnummer 10482. Vat haar laatste drie bestellingen samen met datum, artikelen, betaalstatus, leverstatus en trackingnummer.”
Het model zoekt de bestelling met shopware-entity-search, leest haar met shopware-entity-read inclusief orderregels, betalingen en leveringen en zoekt daarna andere bestellingen van dezelfde klant. Uit het resultaat schrijft het een kort overzicht waarmee uw team antwoordt.
Leesrechten op bestelling, klant en levering, plus de drie leestools. Shopware raadt voor precies dit geval uitdrukkelijk een alleen-lezen integratie aan. De reden is prompt injection: bestelnotities, klantnamen of adresregels komen van klanten en kunnen tekst bevatten die het model tot andere acties wil verleiden. Rechten beperken de schade, maar voorkomen de misleiding niet.
Vanaf hier wijzigt de assistent gegevens. De taak is toch geschikt voor een vroege start, omdat de tool shopware-order-state alleen statuswijzigingen kent die Shopware sowieso toestaat.
Voorbeeldprompt: “Zet de levering van bestellingen 10501 tot en met 10512 op verzonden. Toon mij eerst de lijst met de huidige status.”
Het model leest de toegestane overgangen uit shopware://state-machines en roept shopware-order-state aan met deliveryAction: ship, eerst met dryRun=true. U ziet welke bestellingen hoe zouden veranderen. Pas na uw bevestiging volgt dezelfde aanroep met dryRun=false. Een aanroep kan bestelstatus, betaalstatus en leverstatus samen wijzigen, bijvoorbeeld bij een annulering met terugbetaling.
De rol heeft order:read nodig en, afhankelijk van de actie, wijzigingsrechten op bestelling, betaling of levering. Wie alleen verzendingen mag boeken, krijgt alleen order_delivery:update. Een annulering strandt dan al op de rechten, niet pas op de oplettendheid van een mens.
In bijna elke catalogus ontbreken beschrijvingen in de tweede taal, zijn metatitels leeg of dubbel en zijn eigenschappen onvolledig. Een taalmodel vult zulke gaten goed, als het duidelijke instructies krijgt.
Voorbeeldprompt: “Zoek alle actieve producten in de categorie Tuinmeubelen zonder metatitel. Stel voor de eerste 20 een metatitel voor van maximaal 60 tekens, patroon: productnaam, belangrijkste kenmerk, merk. Toon de voorstellen als tabel en sla nog niets op.”
Het model zoekt de producten, leest naam, eigenschappen en beschrijving en formuleert voorstellen. Na uw controle roept het shopware-entity-upsert aan, eerst als voorbeeld met de oude en nieuwe waarden, daarna bevestigd. Voor vertalingen noemt u de doeltaal. Het model schrijft dan in de vertaling van die taal.
Lees- en wijzigingsrechten op producten, geen rechten op bestellingen of klanten. In de allowlist staan de leestools en shopware-entity-upsert, maar niet shopware-entity-delete.
Nieuwe producten komen vaak als spreadsheet van de leverancier: artikelnummer, naam, inkoopprijs, adviesprijs, afbeeldings-URL. Elk artikel in de Administratie aanmaken kost een paar minuten. Voor een handvol artikelen loont een importkoppeling niet, maar bij 15 artikelen per week loont de assistent wel.
Voorbeeldprompt: “Maak deze acht artikelen aan als inactieve producten: naam, productnummer, voorraad 0, fabrikant Tuinwerk, btw-tarief 21 procent, brutoprijs volgens de tabel. Toon mij eerst het voorbeeld. Upload daarna de afbeelding uit de kolom Afbeeldings-URL als hoofdafbeelding.”
Shopware werkt intern met ID’s. Het model zoekt daarom eerst het ID van het btw-tarief en de fabrikant, leest de valuta uit shopware://currencies en bouwt dan de aanroep van shopware-entity-upsert. Het voorbeeld toont elk artikel met alle velden. Na de goedkeuring laadt shopware-media-upload de afbeeldingen en zet ze als hoofdafbeelding.
Producten aanmaken en wijzigen, btw-tarieven, fabrikanten en valuta lezen, plus media:create voor de upload. Omdat de upload zonder voorbeeld opslaat, krijgt alleen deze integratie de mediatool.
De systeeminstellingen van Shopware zijn omvangrijk en verspreid. Wie wil weten hoeveel producten een categoriepagina toont of welke sortering standaard is, klikt door meerdere menu’s. De assistent leest dat in een stap.
Voorbeeldprompt: “Welke instellingen gelden voor de productlijsten in het verkoopkanaal Storefront NL? Wijzig de standaardsortering naar prijs oplopend, maar toon mij eerst wat er verandert.”
shopware-system-config-read leest alle waarden onder de sleutel core.listing, desgewenst voor een bepaald verkoopkanaal. Voor de wijziging toont shopware-system-config-write in de dry run een voor-en-na-vergelijking. Na de bevestiging slaat het de nieuwe waarde op. Voor logo en kleuren is er shopware-theme-config, ook met voorbeeld.
system_config:read om te lezen, system_config:update om te wijzigen. Deze rechten horen in een integratie voor iemand die nu al instellingen beheert, meestal de shopmanager of het begeleidende bureau.
De belangrijkste beslissing valt voor de eerste prompt: welke integratie mag wat? Shopware raadt een integratie per taak of per rol in het team aan. De tabel toont hoe wij de zeven taken in projecten verdelen.
| Taak | Integratie | Tools in de allowlist | Schrijft gegevens |
|---|---|---|---|
| 1 Dagrapport | Rapportage | schema, search, aggregate | nee |
| 2 Voorraad | Rapportage of magazijn | schema, search, aggregate, bij magazijn upsert | alleen magazijn |
| 3 Klantenservice | Service alleen lezen | schema, search, read | nee |
| 4 Verzending en annulering | Service status | search, read, order-state | ja, met voorbeeld |
| 5 Producteksten | Catalogus | schema, search, read, upsert | ja, met voorbeeld |
| 6 Nieuwe artikelen | Catalogus | schema, search, read, upsert, media-upload | ja, afbeeldingen zonder voorbeeld |
| 7 Instellingen | Shopmanagement | system-config-read, system-config-write | ja, met voorbeeld |
De drie discovery-tools, waarmee een client andere tools vindt en toolsets activeert, komen in elke allowlist erbij. Belangrijk: het activeren van een toolset geeft geen rechten. De allowlist van de integratie blijft de grens. Een MCP-toegang hoort nooit bij een beheerdersaccount, want beheerders omzeilen de allowlist voor gebruikers.
Een hypothetisch voorbeeld op basis van onze ervaring: een retailer met 1.500 bestellingen per maand maakt elke maandag een weekrapport. Dat kost nu 60 minuten, met de assistent 10. De klantenservice behandelt 400 vragen per maand en bespaart per vraag ongeveer 2 minuten aan zoekwerk. Samen is dat ruim 3 uur voor de rapporten en ongeveer 13 uur in de service, dus zo’n 17 uur per maand.
Daar staan de inrichting met rollen, allowlists, promptsjablonen en training tegenover, die volgens onze ervaring 1.500 tot 5.000 euro kost, en de lopende kosten van de AI-clients, ongeveer 20 Amerikaanse dollar per gebruiker per maand voor Claude Pro of ChatGPT Plus. Bij een intern uurtarief van 40 euro verdient een inrichting aan de onderkant zich in twee tot drie maanden terug. Bij een kleine shop met 100 bestellingen per maand loont vooral het lezende deel, dat nauwelijks inrichting vraagt.
De zeven taken werken, maar niet zonder toezicht. Deze grenzen zien wij in de praktijk het vaakst.
Ook in Nederland en België geldt de AVG. Voor klantgegevens die naar Claude of ChatGPT gaan, heeft u een verwerkersovereenkomst nodig. Bij het aanmaken van producten gebruikt het model de btw-tarieven die als belastingregels in Shopware staan, in Nederland 21 procent en het verlaagde tarief van 9 procent. Voor taak 4 zijn de betaalmethoden van belang: iDEAL en Bancontact koppelt u bijvoorbeeld via de Mollie-plugin, en of een statuswijziging daar een terugbetaling start, bepaalt die plugin. Een bureau in Nederland of België vindt u via het landenfilter in de partnergids van Shopware. De bedragen in dit artikel zijn ervaringswaarden uit onze projecten in euro.
Voor retailers die geen eigen rollen en prompts willen beheren, zijn er alternatieven. De Shopware Copilot in de Administratie gebruikt hetzelfde MCP-endpoint met de rechten van de ingelogde gebruiker en vraagt om bevestiging voor wijzigingen. De agentische functies horen bij het extra abonnement Intelligence+. Het experimentele pakket SwagMcpMerchantTools levert kant-en-klare tools zoals merchant-revenue-report of merchant-customer-lookup, maar Shopware houdt zich het recht voor het te schrappen ten gunste van de Copilot. Ons artikel over Shopware AI geeft een overzicht van alle AI-functies van Shopware.
Nee. Vanaf Shopware 6.7.14 zit de MCP-server in de kern en staat hij altijd aan. U maakt een integratie met rol en allowlist aan en verbindt een client zoals Claude of ChatGPT. Plugins zoals AI Connect voegen voorbeeldweergaven, een auditlog en kant-en-klare configuraties toe.
Alleen als u dat toestaat. Alle schrijvende tools behalve de afbeeldingsupload draaien standaard als voorbeeld, en clients zoals Claude en ChatGPT leggen toolaanroepen ter goedkeuring voor. Wie beide uitschakelt, geeft de controle uit handen.
Met het dagrapport. Het heeft alleen leesrechten nodig, levert vanaf de eerste dag nut op en laat snel zien hoe nauwkeurig het model met uw gegevens werkt.
De native MCP-server ontbreekt in 6.6. Een aparte MCP-server die via de Admin API werkt, is mogelijk. Wij raden meestal een update naar 6.7 aan, omdat een aparte server na de update overbodig wordt.
De server zelf is gratis. Lopende kosten komen van de AI-clients. De inrichting met rollen, allowlists en training kost volgens onze ervaring 1.500 tot 5.000 euro.
Wilt u weten welke van de zeven taken in uw shop het meeste oplevert? Wij controleren uw Shopware-versie, stellen integraties met passende rollen en allowlists voor en richten samen met uw team de eerste promptsjablonen in. Voor voorbeelden en auditlog gebruiken we onze plugin AI Connect.
Neem contact op via ons contactformulier. Wilt u eerst weten waar uw shop nu staat, dan helpt onze gratis shopanalyse.
Besnik Bilalli is oprichter en CEO van solution25, het Shopware-bureau uit Bremen. Vóór de oprichting van het bureau in 2017 heeft hij zelf een webshop opgebouwd en uitgebreid tot meer dan 500 bestellingen per dag. Sindsdien begeleidt hij handelaren bij Shopware-projecten, van de eerste calculatie tot het lopende beheer. Vragen over het artikel beantwoordt hij graag persoonlijk: neem contact op.
Verantwoordelijk voor inhoud en actualisering: Besnik Bilalli. Stand: november 2026. Volgende inhoudelijke controle: februari 2027.