Claude en WooCommerce koppelen: zo werkt het in de praktijk

Met een koppeling tussen Claude en WooCommerce via MCP zoekt Claude live bestellingen, producten en klanten in je winkel op terwijl je werkt, en kan hij, als je dat toestaat, een orderstatus wijzigen, een ordernotitie toevoegen of een voorraadniveau instellen. Dit artikel volgt een gewone dag in een winkel: welke prompts werken, wat Claude ermee doet, hoe alleen-lezen-connecties het veilig houden en waar de koppeling ophoudt.

Hoe ziet een koppeling tussen Claude en WooCommerce via MCP eruit?

Een koppeling tussen Claude en WooCommerce bestaat uit drie onderdelen op een rij: Claude, MCP Self-hosted op je eigen server en de REST API van je winkel. Claude Desktop of Claude Code verbindt met MCP Self-hosted via een seat-token. MCP Self-hosted bewaart de WooCommerce consumer key en secret in zijn .env en roept /wp-json/wc/v3 aan op je winkel. Binnen WordPress wordt niets geïnstalleerd.

Claude ziet de API-sleutels nooit. Hij ziet tools met namen als woocommerce_list_orders, bepaalt welke bij je vraag past en leest het antwoord. De installatiestappen staan op de pagina Claude aan WooCommerce koppelen en in de installatiegids voor WooCommerce MCP. Dit artikel gaat over wat er daarna gebeurt.

Welke winkelvragen beantwoordt een koppeling tussen Claude en WooCommerce?

Claude kan elke vraag beantwoorden waarvoor een lijst of een detailopvraging van bestellingen, producten of klanten volstaat. In alleen-lezen-modus heeft de koppeling vijf tools:

• woocommerce_list_orders: nieuwste eerst, gefilterd op status, een datumbereik (aangemaakt na of voor), een klant-ID of een zoekterm.
• woocommerce_get_order: één bestelling volledig, inclusief orderregels.
• woocommerce_list_products: gefilterd op zoekterm, categorie-ID of voorraadstatus (op voorraad, niet op voorraad, in nabestelling).
• woocommerce_get_product: één product met SKU, prijs en voorraad.
• woocommerce_list_customers: gefilterd op zoekterm of e-mailadres.

Lijsttools geven standaard 10 resultaten en maximaal 100 per pagina. Claude bladert zelf door langere lijsten als de vraag dat vraagt. Elk antwoord van de koppeling is de stand van de winkel op het moment dat je het vraagt, niet de stand van de laatste export.

Welke prompts werken in het dagelijkse winkelwerk?

Gewone vragen werken. Je beschrijft wat je nodig hebt, en Claude kiest de tool en de filters. Vier voorbeelden uit een gewone ochtend, met wat de koppeling achter elk voorbeeld doet.

De on-hold-wachtrij. Bestellingen in de wacht moeten door een mens bekeken worden, en ze een voor een openen in wp-admin kost tijd:

Show all orders that are on hold. Open each one and tell me what was ordered, by whom, and the order total.

Claude roept woocommerce_list_orders aan met status on-hold, daarna woocommerce_get_order voor elk resultaat, en geeft één samenvatting terug. Jij bepaalt wat er met elke bestelling gebeurt.

Een klantmail. Iemand vraagt waar zijn bestelling blijft:

Find the customer with email [email protected] and list her orders from the last 30 days with their status.

Hier koppelt Claude twee tools aan elkaar. woocommerce_list_customers met het e-mailadres levert het klant-ID op, daarna draait woocommerce_list_orders met dat ID en een after-datum. Je hebt het antwoord voor je reactie zonder het orderscherm te doorzoeken.

Een voorraadcheck vóór een actie:

Which products in category 12 are out of stock or on backorder?

Claude draait woocommerce_list_products één keer per voorraadstatus. Het categoriefilter gebruikt het categorie-ID, niet de naam, dus geef Claude het ID of laat hem eerst een product in die categorie opzoeken.

Een verzonden bestelling, op een lees-schrijfconnectie:

Order 4182 has shipped. Set it to completed and add a note for the customer with tracking number 3SABC123.

Claude roept woocommerce_update_order_status aan en daarna woocommerce_add_order_note. Ordernotities zijn standaard intern. De klant ziet de notitie alleen als Claude hem als klantnotitie markeert; daarom staat er in de prompt “for the customer”.

Hoe houdt een alleen-lezen-connectie de koppeling veilig?

In alleen-lezen-modus worden de schrijftools helemaal niet geregistreerd, dus Claude ziet ze niet en kan ze niet aanroepen. Je kiest de modus per seat, als je de seat toevoegt in Mijn account → MCP Self-hosted → Seats. Alleen-lezen is de standaard voor WooCommerce.

Een seat is één persoon of apparaat met een eigen token, eigen tools en een eigen modus per tool. In een winkel komt dat overeen met rollen. De supportcollega die “waar blijft mijn bestelling” beantwoordt, krijgt alleen-lezen. Wie de fulfilment doet, krijgt Mag wijzigingen aanbrengen en kan bestellingen op afgerond zetten. Raakt er een laptop zoek, dan trek je dat ene token in en blijven de andere seats werken. MCP-seats legt de tokens en de modi per tool uit.

De winkel voegt een tweede slot toe. Je maakt de REST API-sleutel aan onder WooCommerce → Instellingen → Geavanceerd → REST API en kiest daar de rechten. Met een sleutel met alleen leesrechten mislukt elke schrijfaanroep, ook op een lees-schrijfconnectie. Begin met een leessleutel en alleen-lezen-connecties, laat het team een week vragen stellen, en bepaal daarna wie schrijftoegang nodig heeft.

Wat doet de koppeling tussen Claude en WooCommerce niet?

Hij doet precies wat zijn acht tools doen, en niets meer. Mag wijzigingen aanbrengen voegt drie acties toe aan de vijf leestools: een orderstatus bijwerken, een ordernotitie toevoegen en de voorraad van een product instellen. Dat is de volledige lijst.

• Geen producten aanmaken of verwijderen, en geen prijswijzigingen.
• Geen bestellingen aanmaken, en geen klantgegevens bewerken.
• Geen terugbetalingstool, geen kortingscodes, geen instellingen.
• Voorraadwijzigingen werken alleen bij producten waarbij “Voorraad beheren” aanstaat. De tool zet die instelling niet voor je aan; hij geeft in plaats daarvan een waarschuwing.

Een koppeling tussen Claude en WooCommerce houdt je winkel ook niet in de gaten. Er is geen planning en geen trigger: Claude roept een tool aan als een prompt erom vraagt, en alleen dan. Heeft je werkwijze een tool nodig die nog niet bestaat, dan kun je een add-on op maat aanvragen.

Kan één koppeling meerdere winkels bedienen?

Ja. In plaats van de drie variabelen voor één winkel stel je WOOCOMMERCE_CONNECTIONS in: een JSON-array met één item per winkel, elk met een eigen id. Bij twee of meer winkels krijgt elke WooCommerce-tool een verplichte store-parameter, en Claude kiest de winkel aan de hand van dat id. Een prompt als deze werkt dan over winkels heen:

Compare the number of processing orders in shop-a and shop-b today.

In Mijn account voeg je extra winkels toe onder het tabblad Tools van je licentie. Op het tabblad Seats kies je daarna per seat welke winkels die kan bereiken, zodat een collega die maar voor één merk werkt alleen die winkel ziet.

Wat kost een koppeling tussen Claude en WooCommerce?

Je hebt twee licenties nodig. MCP Self-hosted kost € 217,80 excl. btw: € 180,00 per jaar, inclusief 3 seats en 1 activatie. De WooCommerce-add-on kost € 157,30 excl. btw: € 130,00 per jaar. Een extra seat kost € 18,15 excl. btw: € 15,00 per jaar. Je betaalt jaarlijks terugkerend via Mollie, en EU-btw wordt bij het afrekenen afgehandeld. De productpagina van de WooCommerce MCP-server toont de tools en de actuele voorwaarden, en MCP Self-hosted behandelt de server zelf. Draai je Docker liever niet zelf, dan wordt de MCP Hosted-seat per maand gefactureerd, met de eerste maand gratis.

Een koppeling tussen Claude en WooCommerce is het nuttigst voor terugkerende opzoekingen: de on-hold-wachtrij, de klant die naar een bestelling vraagt, de voorraadcheck. Begin met een alleen-lezen-connectie en een leessleutel, gebruik de prompts hierboven, en geef alleen meer toegang aan de mensen die dat nodig hebben. De installatiegids is de volgende stap.