WooCommerce MCP instellen

Voor WooCommerce MCP instellen heb je drie dingen nodig: de WooCommerce-entitlement op je mcp-core-licentie, een REST API-sleutelpaar uit je winkel en vier regels in .env. Na een herstart kan Claude bestellingen, producten en klanten opvragen en lezen. Schrijftools blijven verborgen tot een seat op read-write staat.

Wat heb je nodig voordat je WooCommerce MCP instelt?

Je hebt een draaiende mcp-core-installatie nodig en de WooCommerce-add-on op dezelfde licentie. Is mcp-core nog niet geïnstalleerd, volg dan eerst de installatiehandleiding van mcp-core en kom daarna terug om WooCommerce MCP in te stellen.

• Een actieve mcp-core-licentie met de entitlement tool:woocommerce. Koop de WooCommerce MCP-server-add-on als je die nog niet hebt.
• Een WooCommerce-winkel die bereikbaar is via HTTPS. De tool authenticeert met HTTP Basic, en dat is alleen veilig via HTTPS.
• Beheerderstoegang tot die winkel, om de REST API-sleutels aan te maken.
• Minstens één seat in Mijn account → MCP Self-hosted met de WooCommerce-tool aangevinkt.

Heb je de add-on na je eerste installatie gekocht? Dan is er geen nieuwe download nodig. De add-on wordt aan je bestaande licentie toegevoegd, en je krijgt een e-mail met de env-variabelen die de tool nodig heeft.

Waar haal je de WooCommerce REST API-sleutels vandaan?

Je maakt de sleutels in de winkel zelf aan, onder WooCommerce → Instellingen → Geavanceerd → REST API. Klik op “Sleutel toevoegen”, geef een omschrijving zoals “mcp-core”, kies de gebruiker namens wie de sleutel werkt en kies de rechten. Dit is het enige deel van het instellen van WooCommerce MCP dat in de winkel zelf gebeurt.

• Lezen is genoeg als Claude alleen dingen hoeft op te zoeken.
• Lezen/Schrijven is nodig voor de schrijftools: bestelstatus, bestelnotities en voorraad.

WooCommerce toont de consumer key (begint met ck_) en de consumer secret (begint met cs_) één keer. Kopieer beide meteen naar je .env. Ben je de secret kwijt, trek de sleutel dan in en maak een nieuwe aan.

Welke env-variabelen gebruikt WooCommerce MCP?

De tool leest vier variabelen voor één winkel, plus één voor meerdere winkels. De .env in je download bevat de verplichte regels al, leeg, en de optionele als commentaar.

Een minimaal .env-blok voor één winkel:

WOOCOMMERCE_STORE_URL=https://shop.example.com
WOOCOMMERCE_CONSUMER_KEY=ck_xxxxxxxxxxxxxxxx
WOOCOMMERCE_CONSUMER_SECRET=cs_xxxxxxxxxxxxxxxx

De tool roept /wp-json/wc/v3 aan op die URL. Je kunt deze waarden ook opslaan in Mijn account → MCP Self-hosted → Tools. Daar worden ze versleuteld bewaard, een draaiende mcp-core pikt ze op zonder nieuwe download, en ze gaan voor op dezelfde sleutels in .env.

Hoe verbind je meerdere winkels via WooCommerce MCP?

Zet WOOCOMMERCE_CONNECTIONS op een JSON-array met één object per winkel. Zodra die is ingesteld, worden de drie losse variabelen genegeerd, niet samengevoegd.

WOOCOMMERCE_CONNECTIONS=[{"id":"shop-a","label":"Main store","url":"https://shop-a.example.com","consumerKey":"ck_...","consumerSecret":"cs_..."},{"id":"shop-b","label":"Outlet","url":"https://shop-b.example.com","consumerKey":"ck_...","consumerSecret":"cs_..."}]

Elke regel heeft id, url, consumerKey en consumerSecret nodig; label is optioneel. Bij twee of meer winkels krijgt elke WooCommerce-tool een verplichte parameter store, en Claude kiest de winkel op basis van de id. Houd de id’s kort en stabiel. Met één winkel bestaat die parameter niet.

Read-only of read-write: wat verandert er in WooCommerce MCP?

In read-only-modus worden de schrijftools helemaal niet geregistreerd, dus Claude ziet ze nooit. De modus stel je per seat in: wanneer je een seat toevoegt in Mijn account → MCP Self-hosted → Seats, kies je per tool read-only of read-write. WOOCOMMERCE_MODE is alleen de fallback. Het verschil tussen een tool kopen en de modus ervan lees je in entitlements vs. toolmodi.

Lijsttools geven standaard 10 resultaten terug en maximaal 100 per pagina. woocommerce_update_stock werkt alleen op producten waarbij “Voorraad beheren” aan staat; de tool zet die instelling niet voor je aan. Bestelnotities zijn intern, tenzij Claude ze markeert als notitie voor de klant.

Hoe start je de tool en test je WooCommerce MCP?

Draai het updatescript vanuit de map die je hebt uitgepakt. Het pullt de image en herstart mcp-core met je nieuwe .env.

./mcp-update.sh

Net de add-on gekocht en verschijnt de tool niet? Forceer een licentiecheck in plaats van op de volgende te wachten:

docker exec mcp-core npm run refresh-license

Open daarna Claude en vraag om mcp_status aan te roepen. Die ingebouwde tool toont de licentiestatus, je seat en de tools ervan met hun modi. Vraag als eerste echte test om “de laatste vijf bestellingen”. Hoe je een client aan de juiste seat koppelt, lees je in MCP-seats.

Welke foutmeldingen zie je bij het instellen van WooCommerce MCP?

De meeste problemen komen door ontbrekende waarden, ongeldige JSON of sleutelrechten. De meldingen hieronder komen rechtstreeks uit de tool.

• Helemaal geen WooCommerce-tools: het containerlog meldt “No WooCommerce store is configured”. Vul de drie losse variabelen of WOOCOMMERCE_CONNECTIONS in en draai ./mcp-update.sh. Controleer ook de entitlement en of de seat WooCommerce aangevinkt heeft.
• “WOOCOMMERCE_CONNECTIONS is not valid JSON” of “is missing url/consumerKey/consumerSecret”: corrigeer de array. Zet hem op één regel, gebruik dubbele aanhalingstekens en geen komma aan het eind.
• “Multiple WooCommerce stores are configured — pass the store parameter” of “Unknown WooCommerce store”: Claude gebruikte een verkeerde of geen id. De melding noemt de ingestelde id’s.
• “WooCommerce [id] API error 401”: verkeerde key of secret, of de sleutel is ingetrokken. Maak een nieuw sleutelpaar aan en controleer of de URL HTTPS gebruikt.
• Een schrijftool faalt terwijl lezen werkt: de sleutel heeft alleen leesrechten. Maak een sleutel met Lezen/Schrijven aan en vervang beide waarden.

WooCommerce MCP is ingesteld als mcp_status de tool toont en een testvraag bestellingen teruggeeft. Voor de andere add-ons ga je terug naar de MCP-installatiehandleidingen.