Hoe het Model Context Protocol werkt, welke clients het ondersteunen en wat de native MCP Server in Shopware 6.7 doet: tools, rechten, goedkeuringen, risico’s, inrichting en kosten.
Een MCP Server is een gestandaardiseerde koppeling waarmee AI-assistenten zoals Claude of ChatGPT toegang krijgen tot de data en functies van een systeem. Anthropic heeft het onderliggende Model Context Protocol in november 2024 als open standaard gepubliceerd; sinds december 2025 is het ondergebracht bij de Linux Foundation.
Shopware 6.7 bevat een eigen MCP Server, die sinds versie 6.7.14 zonder extra instelling actief is. Hij draait onder /api/_mcp, gebruikt de rechten van de Admin API, de beheerkoppeling van Shopware, en maakt zoeken, analyseren en, na goedkeuring, wijzigen van producten, bestellingen en instellingen mogelijk.
De techniek is gratis, de inspanning zit in rechten, goedkeuringen en logging. Een nette inrichting met rollen en een audit-log dat elke actie vastlegt, kost naar onze ervaring 1.500 tot 5.000 €, maatwerktools voor eigen processen 5.000 tot 20.000 €.
Vóór de oprichting van solution25 hebben wij zelf een webshop naar meer dan 500 bestellingen per dag gebracht, en sinds 2017 realiseren wij Shopware-projecten, inmiddels ook koppelingen met Claude, ChatGPT en het workflowplatform n8n. Met AI Connect, onze MCP Connector voor Shopware, hebben wij een eigen extensie ontwikkeld die deze verbinding beveiligt met rollen, goedkeuringen en logboek.
Omdat de MCP Server tot de kern behoort, speelt in elke actuele Shopware-webshop de vraag wie daarmee wat mag lezen en wijzigen. Dit artikel is bedoeld voor webshopeigenaren en e-commercemanagers met een eigen Shopware 6-webshop die Claude, ChatGPT of n8n willen koppelen aan producten, bestellingen en rapportages, en voor de developers die dat uitvoeren.
Na het lezen kunt u beslissen of de MCP Server, de Copilot in de Shopware-administratie, n8n of de Admin API bij uw taak past, en een toegang inrichten die niet meer mag dan nodig. Alle prijzen per oktober 2026, exclusief btw.
Het Model Context Protocol (MCP) is een open standaard die AI-toepassingen verbindt met externe databronnen en tools. Anthropic heeft het op 25 november 2024 gepubliceerd, samen met SDK’s, oftewel programmeerbibliotheken, en de eerste servers voor Google Drive, Slack, GitHub, Git, Postgres en Puppeteer (aankondiging van Anthropic).
Het uitgangspunt: in plaats van voor elke combinatie van AI-assistent en vakapplicatie een eigen integratie te bouwen, spreekt elk systeem één keer MCP en is daarmee bereikbaar voor alle clients. Op 9 december 2025 heeft Anthropic het protocol overgedragen aan de Agentic AI Foundation onder de paraplu van de Linux Foundation, met Block en OpenAI als medeoprichters, en noemde daarbij meer dan 10.000 actieve openbare MCP Servers en ruim 97 miljoen SDK-downloads per maand (bericht over de overdracht).
MCP volgt een client-serverarchitectuur met drie rollen (beschrijving van de architectuur):
De communicatie verloopt via JSON-RPC 2.0, dus via gestructureerde berichten. Het protocol regelt alleen deze uitwisseling, niet hoe de AI de context gebruikt.
Omgekeerd kan een server de client vragen om bij de gebruiker na te vragen (elicitation), bijvoorbeeld om een wijziging te laten bevestigen.
Bij stdio start de client de server als lokaal proces en wisselt berichten uit via de standaardinvoer en -uitvoer. Streamable HTTP stuurt elk bericht als HTTP-POST naar een endpoint en maakt externe servers met veel clients tegelijk mogelijk (transports in de specificatie). Het oudere transport HTTP+SSE (Server-Sent Events) geldt sinds protocolversie 2025-03-26 als verouderd.
MCP hanteert versies op datum; actueel is revisie 2026-07-28 (versiebeheer). Die maakt het protocol stateless: de afstemming van versie en mogelijkheden aan het begin van een verbinding vervalt (changelog). Shopware heeft deze revisie nog uitgeschakeld en werkt met de bestaande verbindingsopbouw, die actuele clients nog steeds ondersteunen.
Inmiddels ondersteunen alle grote AI-assistenten het protocol, met verschillen in transport, aanmelding en goedkeuringen.
| Client | MCP-ondersteuning | Goedkeuring van schrijftoegang |
|---|---|---|
| Claude.ai en Claude Desktop | Externe servers als “Custom Connector” op alle abonnementen (Free: één connector), lokale servers via configuratiebestand of .mcpb-extensie | Elke toolaanroep wordt ter goedkeuring voorgelegd |
| Claude Code | stdio, HTTP en SSE; configuratie via commando of .mcp.json; OAuth-login via /mcp | Projectservers moeten worden bevestigd, toolrechten via permissions |
| ChatGPT | Developer Mode met volledige MCP-client op Plus, Pro, Business, Enterprise en Edu; SSE en Streamable HTTP; OAuth of zonder aanmelding | Schrijfacties vereisen standaard een bevestiging |
| OpenAI Responses API en Agents SDK | Externe servers als tooltype “mcp”, in de Agents SDK ook stdio en Streamable HTTP | require_approval per tool, standaard is goedkeuring |
| Cursor | stdio, SSE, Streamable HTTP; .cursor/mcp.json; OAuth | Vraagt standaard vóór elke toolaanroep |
| n8n | MCP Client Tool in de AI-Agent-node, MCP Server Trigger, instance-MCP-server voor externe clients | Geen bevestigingsvraag in de workflow, goedkeuringen bouwt u zelf |
| Shopware Copilot | Verbindt met het MCP-endpoint van de eigen webshop | Voorbeeld via dry-run, wijziging pas na goedkeuring |
Bronnen: Claude Connectors, Claude Code, ChatGPT Developer Mode, OpenAI API, Cursor, n8n Trigger, n8n instance-server. Developers kiezen meestal voor Claude Code of Cursor, vakafdelingen voor Claude Desktop of ChatGPT; processen zonder menselijke tussenkomst lopen via n8n.
MCP geeft een taalmodel toegang tot echte systemen. De specificatie bevat daarom eigen beveiligingsrichtlijnen, en de clients passen goedkeuringen toe. De belangrijkste punten voor webshopeigenaren:
Shopware heeft eerst geëxperimenteerd met een apart Node.js-pakket (shopware-admin-mcp op GitHub, inmiddels gearchiveerd). Sinds juni 2026 levert Shopware een native MCP Server mee met de kern, gebouwd op de Symfony MCP Bundle van het PHP-framework onder Shopware (documentatie van de Shopware MCP Server).
Het endpoint voor de administratie is /api/_mcp, dat voor de Storefront /store-api/_mcp, beide via Streamable HTTP. Shopware markeert de server tot versie 6.8 als experimenteel; toolnamen kunnen dus nog veranderen. Actueel is volgens endoflife.date versie 6.7.15.1 van 2 oktober 2026.
De kern bevat geen speciale tools voor “product aanmaken” of “klant zoeken”, maar generieke tools op basis van de Admin API die met elke entiteit werken (tools-referentie). Daarnaast zijn er resources met referentiedata zoals verkoopkanalen, valuta en state machines, plus de prompt shopware-context.
| Toolset | Tools | Toegang | Benodigde rechten |
|---|---|---|---|
| Discovery | shopware-tool-search, shopware-toolsets-list, shopware-toolset-enable | Zoeken en activeren in de sessie | geen |
| Entity | shopware-entity-schema, shopware-entity-search, shopware-entity-read, shopware-entity-aggregate, shopware-entity-upsert, shopware-entity-delete | Lezen, analyseren, schrijven, verwijderen | Lezen, aanmaken, wijzigen of verwijderen per entiteit |
| System-Config | shopware-system-config-read, shopware-system-config-write | Lezen, schrijven | system_config:read respectievelijk system_config:update |
| Media | shopware-media-upload | Schrijven, zonder dry-run | media:create, bij productafbeelding daarnaast product:update |
| Order | shopware-order-state | Status van bestelling, betaling en levering wijzigen | order:read plus update-rechten per actie |
| Theme | shopware-theme-config | Lezen of schrijven | theme:read respectievelijk theme:update |
Alle schrijvende tools draaien standaard als dry-run: het model krijgt een voorbeeld van de wijziging en moet de aanroep herhalen met dryRun=false om die uit te voeren. De enige uitzondering is de media-upload, die direct uploadt.
Per integratie en per gebruiker beheert u een allowlist van de toegestane tools, resources en prompts. Die vormt de beveiligingsgrens tijdens runtime, want het activeren van een toolset kent geen rechten toe. Beheerders omzeilen de gebruikers-allowlist; daarom hoort een MCP-toegang nooit bij een admin-account.
Daarnaast begrenst Shopware de aanroepen: 300 per minuut en 1.000 per tien minuten op het admin-endpoint, 120 en 600 op het Store API-endpoint (configuratie). Voor massawijzigingen blijft de Sync API, waarmee Shopware veel records in één aanroep wegschrijft, de betere weg.
De Copilot, de chatassistent in de administratie, verbindt met het MCP-endpoint van de webshop en werkt met de rechten van de aangemelde handelaar. Wijzigende tools roept hij eerst aan als dry-run, toont een goedkeuringskaart en voert de wijziging pas na bevestiging uit (Copilot Tool Approval).
Volgens Shopware staat de Copilot vanaf versie 6.7.1.0 open voor alle handelaren, ook in de Community Edition; de agentische functies zijn sinds 6.7.15.0 stabiel (Release News oktober 2026). Ze horen bij Shopware Intelligence+, het AI-aanvullingsabonnement van Shopware, voor 19 € per maand, in de Community Edition 29 € (Shopware over AI-functies, prijspagina).
Voor handelaren zonder developers zijn de generieke Entity-tools omslachtig, omdat het model eerst het schema moet opvragen en daarna criteria in het formaat van de Admin API moet opbouwen. Shopware levert daarom het experimentele pakket swag/mcp-merchant-tools met kant-en-klare workflows zoals merchant-order-summary en merchant-revenue-report, dat echter ten gunste van de Copilot weer kan vervallen (Shopware Extensions).
Onze plugin AI Connect (MCP Connector voor Shopware) bouwt voort op de native server en vult aan wat in de praktijk ontbreekt: kant-en-klare configuraties voor Claude Desktop, Claude Code en OpenAI Codex worden in de administratie aangemaakt, elke verbinding gebruikt een Shopware-ACL-rol, elke wijziging verschijnt vóór de uitvoering als voorbeeld, en het audit-log maakt activiteiten herleidbaar naar tool, modus, resultaat en account. Daarnaast is er een zoekfunctie in natuurlijke taal voor medewerkers en klanten, met een eigen API-sleutel bij OpenAI of Anthropic.
Afbeelding: De grafiek laat zien op welke punten een toolaanroep wordt gestopt of herleid; wie rol en allowlist strikt afbakent en goedkeuringen niet generiek verleent, beperkt de fouten van het model. Bron: developer.shopware.com (MCP Server, Tools Reference, Configuration), solution25.com/mcp-connector; stand oktober 2026
Alles wat de Admin API kan, laat zich via MCP in natuurlijke taal aansturen, altijd binnen de rechten van de integratie. Deze use cases hebben zich in projecten bewezen:
Hoe concreter de prompt entiteit, periode en gewenste output noemt, hoe minder wedervragen er ontstaan. Een verzameling geteste prompts per team betaalt zich snel terug.
MCP is niet de enige manier om Shopware met AI of andere systemen te verbinden. De tabel zet de vijf gangbare manieren op een rij.
| Manier | Geschikt voor | Sterke punten | Grenzen |
|---|---|---|---|
| MCP Server (native in Shopware) | Interactief werken in de chat, analyses, onderhoud met goedkeuring | In de kern inbegrepen, ACL, dry-run, alle MCP-clients | Experimenteel tot 6.8, rate limits, inhoudelijke tools alleen via extensie |
| n8n | Terugkerende processen zonder mens, systemen van derden | Kant-en-klare Shopware-nodes, AI-agent met MCP Client Tool, self-hosting | Goedkeuringen en foutafhandeling bouwt u in de workflow |
| Admin API direct | Eigen software, massa-imports, ERP-koppelingen | Volledige controle, Sync API, geen tokenkosten | Ontwikkeling nodig, geen dialoog in natuurlijke taal |
| Shopware Nexus | Eventgestuurde workflows tussen Shopware, ERP en CRM | Door Shopware beheerd, triggers op entiteitsevents, tegoed in het abonnement | Bèta, geen AI- of MCP-node, geen self-hosting |
| Shopware Copilot | Start zonder configuratie in de administratie | Geen inrichting, goedkeuring ingebouwd, data volgens Shopware in Europa | Alleen in de administratie, agentische functies via Intelligence+ |
Onze n8n-nodes voor Shopware dekken producten, klanten en bestellingen af; typische workflows toont het artikel over het automatiseren van Shopware 6 met n8n. Omdat de MCP Client Tool van n8n sinds nodeversie 1.2 standaard HTTP Streamable spreekt (broncode van de node), kan een AI-agent in n8n de Shopware MCP Server direct aanspreken.
Shopware Nexus koppelt volgens de documentatie in de bèta onder meer Microsoft Dynamics Business Central, Slack en S3; een MCP- of AI-node is daar niet beschikbaar. Hoe de Admin API direct werkt, leggen wij uit op onze pagina over de Shopware Admin API; een overzicht van AI-koppelingen geeft het AI-integratieplatform voor Shopware.
claude mcp add --transport http shopware https://ihr-shop.de/api/_mcp --header "sw-access-key: …" --header "sw-secret-access-key: …". In Claude Desktop en Cursor voert u hetzelfde endpoint met het type streamable-http en de beide headers in het configuratiebestand in (Getting Started van Shopware). In n8n verbindt u de AI Agent via de MCP Client Tool met header-authenticatie.Een typische opzet uit onze adviestrajecten, als scenario met ervaringswaarden: een handelaar met circa 4.000 artikelen wil Claude gebruiken voor analyses, klantenservice en catalogusbeheer. In plaats van één admin-toegang richten wij drie integraties in.
| Integratie | Wie haar gebruikt | Allowlist (korte namen van de tools) | Rechten van de rol |
|---|---|---|---|
| Analyse | Directie in Claude Desktop | schema, search, read, aggregate | Bestelling en product lezen |
| Service | Team klantenservice | schema, search, read, order-state | Bestelling en klant lezen, leverstatus wijzigen |
| Catalogus | Webshopmanager | schema, search, read, upsert, media-upload | Product lezen en wijzigen, media aanmaken, geen verwijderrechten |
De media-upload, die zonder voorbeeld opslaat, krijgt alleen de catalogus; klantgegevens ziet alleen de service. De inrichting van deze drie toegangen inclusief training ligt naar onze ervaring aan de onderkant van de genoemde 1.500 tot 5.000 €.
Hetzelfde principe passen wij buiten AI-projecten toe: voor een Duitse logistieke klant hebben wij een magazijnportaal met rolgebaseerd orderbeheer en koppeling met SAP, HubSpot en Shopware gebouwd. Daar zorgen rolgebaseerde rechten ervoor dat gevoelige informatie alleen toegankelijk is voor bevoegd personeel, en audit-logs maken handelingen herleidbaar.
Als hulpmiddelen dienen het audit-log van een extensie zoals AI Connect of een eigen logging, het kostenoverzicht van uw AI-aanbieder en in n8n de lijst met uitvoeringen. Deze richtwaarden hebben zich bij ons bewezen:
Controleer de waarden in de eerste vier weken wekelijks, daarna maandelijks en na elke Shopware-update. Bijsturen is nodig zodra de goedkeuringsquote daalt, een steekproef afwijkt of een beproefde prompt na een update geen passende tool meer vindt.
Kosten ontstaan bij de AI-client, bij aanvullende functies van Shopware en bij de inrichting.
| Kostenpost | Bedrag | Bron |
|---|---|---|
| MCP Server in Shopware | 0 €, vanaf 6.7.14 in de kern inbegrepen | Shopware-documentatie |
| Claude voor individuele gebruikers | Pro 20 US-dollar per maand (17 bij jaarbetaling), Max vanaf 100, Team vanaf 20 per gebruiker | claude.com/pricing |
| ChatGPT voor individuele gebruikers | Plus 20 US-dollar per maand, Developer Mode vanaf Plus | openai.com |
| API-gebruik, bijvoorbeeld vanuit n8n | Claude Sonnet 5.5: 2 US-dollar per miljoen input-tokens, 10 US-dollar per miljoen output-tokens; OpenAI rekent bij externe MCP Servers alleen tokens af | Anthropic, OpenAI |
| n8n Cloud | Starter 20 € per maand bij jaarbetaling, Pro 50 €; Community Edition zelf gehost zonder licentiekosten | n8n.io/pricing |
| Shopware Intelligence+ | 19 € per maand, Community Edition 29 €, voor agentische Copilot-functies | shopware.com/de/preise |
| Inrichting door een bureau | 1.500 tot 5.000 € voor rollen, allowlists, clientconfiguratie, audit-log en training | Ervaringswaarde solution25 |
| Maatwerktools | 5.000 tot 20.000 € afhankelijk van aantal en complexiteit van de processen | Ervaringswaarde solution25 |
De inrichtingskosten hangen vooral af van hoeveel rollen en clients u nodig heeft. Wat Shopware-bureaus in principe rekenen, staat in het artikel over prijzen van Shopware-bureaus; de totale kosten van een webshop behandelt ons artikel over de kosten van Shopware.
Maatwerktools lonen als een proces dagelijks draait: een tool “Retour aanmaken” die bestelling, terugbetaling en magazijnboeking in één stap met één goedkeuring afhandelt, bespaart meer tijd dan tien generieke Entity-aanroepen. Zulke tools ontstaan als plugin of app (Shopware-pluginontwikkeling).
Onze inschatting: Voor de meeste Shopware-handelaren is de native MCP Server met een integratie die alleen leest de juiste start, omdat rollen, allowlist en dry-run al ingebouwd zijn en er geen licentiekosten zijn. Schrijfrechten kennen wij pas toe na een testperiode op staging, en webshops op 6.6 adviseren wij een update in plaats van een aparte MCP Server, die met 6.7 overbodig wordt.
Een MCP Server is een programma dat een AI-toepassing via het Model Context Protocol tools, data en sjablonen aanbiedt en de aanroepen uitvoert die de client na goedkeuring verstuurt. Bij Shopware is de MCP Server een onderdeel van de webshop en bereikbaar onder /api/_mcp.
MCP is een open standaard die AI-toepassingen verbindt met tools en data. Een hosttoepassing zoals Claude of ChatGPT vraagt de tools van een server op en presenteert ze aan het taalmodel. Kiest het model een tool, dan voert de host de aanroep na uw goedkeuring uit en geeft het resultaat terug aan het model.
Het MCP-project onderhoudt referentieservers zoals Filesystem, Git, Fetch, Memory en Time (GitHub) en een openbare directory. In e-commerce zijn naast de native Shopware-server de instance-server van n8n en het MCP-endpoint per Shopify-webshop relevant (Shopify).
Officiële SDK’s zijn er onder meer voor TypeScript, Python, PHP, Java en Go (SDK-overzicht). U definieert tools met naam, beschrijving en invoerschema en kiest stdio of Streamable HTTP als transport. In Shopware vult u de bestaande server aan: plugins registreren tools als Symfony-service, apps declareren ze in het bestand Resources/mcp.xml, telkens met ACL-rechten en een dryRun-parameter voor de goedkeuring.
Zo veilig als hun rechten en hun configuratie. De specificatie beschrijft aanvallen zoals het doorgeven van tokens, prompt injection via toolresultaten en gemanipuleerde lokale servers, en vereist goedkeuringen door de gebruiker. In Shopware komen daar ACL-rollen, allowlists per integratie, dry-run vóór elke wijziging en rate limits bij.
Het protocol is vrij beschikbaar, de Shopware MCP Server is vanaf versie 6.7.14 in de kern inbegrepen. Lopende kosten ontstaan bij de client, ongeveer 20 US-dollar per maand voor Claude Pro of ChatGPT Plus; de inrichting met rollen, allowlists en audit-log ligt naar onze ervaring op 1.500 tot 5.000 €.
Ja, via de Developer Mode in Plus, Pro, Business, Enterprise en Edu. Omdat ChatGPT alleen via OAuth of zonder aanmelding verbindt, is een gateway vóór de webshop nodig die OAuth afhandelt, en de webshop moet openbaar via HTTPS bereikbaar zijn.
Wilt u weten welke taken in uw webshop via een MCP Server kunnen worden uitgevoerd en welke rechten daarvoor nodig zijn? Neem contact met ons op: wij controleren uw Shopware-versie, stellen rollen en allowlists voor en richten AI Connect in met goedkeuringen en audit-log. Aan het eind heeft elk team een eigen toegang die alleen ziet en wijzigt wat zijn taak vereist.
Heeft u al een webshop en wilt u eerst weten waar die vandaag staat? Onze gratis shopanalyse laat u binnen twee werkdagen als pdf zien waar uw webshop omzet verliest, van laadtijd en SEO tot zichtbaarheid in AI-assistenten.
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 naar meer dan 500 bestellingen per dag gebracht. Sindsdien begeleidt hij handelaren bij Shopware-projecten, van de eerste calculatie tot de lopende werking. Vragen over het artikel beantwoordt hij graag persoonlijk: neem contact op.
Verantwoordelijk voor inhoud en actualisering: Besnik Bilalli. Stand: oktober 2026. Volgende inhoudelijke controle: januari 2027.