Come collegare in sicurezza gli assistenti AI a WooCommerce tramite MCP Adapter e cosa cambia con la versione 11.3.
Un server MCP per WooCommerce collega un assistente AI come Claude o ChatGPT al Suo negozio WooCommerce. L’assistente può così consultare prodotti e ordini e, se Lei lo consente, creare prodotti, modificare prezzi o cambiare lo stato di un ordine. Le funzioni necessarie sono già incluse in WooCommerce. Per collegare l’assistente serve inoltre il plugin gratuito MCP Adapter di WordPress.org.
A novembre 2026 la funzione è ancora un’anteprima per sviluppatori. WooCommerce scrive nella propria documentazione che le interfacce possono ancora cambiare. Con la versione 11.3 WooCommerce ha rimosso il vecchio endpoint /wp-json/woocommerce/mcp e l’accesso con chiavi REST API. Chi ha già configurato una connessione deve aggiornarla.
Il vero lavoro riguarda permessi e controllo, non l’installazione. Servono un utente WordPress dedicato con pochi permessi, una password per le applicazioni per ogni persona, un primo test su un ambiente di staging e regole chiare su chi può consultare quali dati dei clienti.
Questo articolo è pensato per commercianti, responsabili e-commerce e responsabili IT che gestiscono un negozio WooCommerce e vogliono collegare assistenti AI. Scoprirà come è strutturato il collegamento, quali attività funzionano già oggi, come configurarlo in sicurezza e che cosa cambia con WooCommerce 11.3.
MCP sta per Model Context Protocol. Anthropic ha pubblicato il protocollo come standard aperto a novembre 2024, da dicembre 2025 è gestito dalla Linux Foundation. Definisce come un assistente AI comunica con altri sistemi. Il server indica quali strumenti offre, per esempio «cerca prodotti» o «cambia stato ordine». L’assistente li richiama quando una domanda lo richiede.
Per WooCommerce significa: Lei chiede «Quali ordini sono In lavorazione da più di tre giorni?». Tramite il server MCP l’assistente richiama la funzione adatta del negozio, riceve gli ordini e li trasforma in una risposta o in una tabella. I dati restano nel Suo database WordPress. Il modello vede solo ciò che il server restituisce.
Esempio ipotetico: un negozio di accessori per il caffè ha 600 prodotti in WooCommerce. Il venerdì la titolare chiede: «Quali prodotti della categoria Macinacaffè sono in bozza e non hanno un prezzo?». Senza MCP filtra l’elenco prodotti nel pannello di amministrazione e annota i risultati. Con MCP l’assistente fornisce l’elenco in una sola risposta. Che sia completo lo verifica a campione. Questa verifica resta necessaria, perché un modello può riassumere male i risultati o saltare una pagina di risultati.
Sì, ma in un anno è cambiato radicalmente due volte. Molte guide online descrivono ancora il vecchio metodo. Queste sono le tre fasi da conoscere.
| Versione | Che cosa c’era di nuovo | Situazione oggi |
|---|---|---|
| WooCommerce 10.3 | prima integrazione MCP in beta, endpoint proprio /wp-json/woocommerce/mcp, accesso con chiave REST API, attivazione tramite feature flag | rimossa |
| WooCommerce 10.9 (giugno 2026) | sette funzioni dedicate per prodotti e ordini, le vecchie funzioni derivate dalla REST API sono deprecate | base del collegamento attuale |
| WooCommerce 11.3 (prevista per la settimana del 9 novembre 2026) | il vecchio endpoint restituisce solo HTTP 410, chiavi REST API e feature flag eliminati, connessione solo tramite il plugin MCP Adapter con password per le applicazioni | anteprima per sviluppatori |
Chi ha collegato il proprio client tramite una chiave REST API di WooCommerce perde la connessione con l’aggiornamento alla 11.3. WooCommerce consiglia di passare al nuovo metodo prima dell’aggiornamento. Servono tre passaggi: installare e attivare il plugin MCP Adapter, creare una password per le applicazioni per un utente con permessi adeguati e indirizzare il client al nuovo endpoint /wp-json/mcp/mcp-adapter-default-server. I negozi in cui la vecchia funzione era attiva vedono un avviso nel pannello dopo l’aggiornamento.
Anche funzioni come woocommerce/products-list o woocommerce/orders-get non esistono più dalla 11.3. Se uno sviluppatore ha costruito processi su di esse, vanno aggiornati ai nuovi nomi. Le funzioni personalizzate del vecchio endpoint non vengono trasferite automaticamente.
La direzione è chiara: WooCommerce si basa sulla Abilities API di WordPress e sul plugin MCP comune, invece di mantenere una strada propria. Per i commercianti è positivo, perché anche altri plugin possono offrire le loro funzioni nello stesso modo. Lo stato di anteprima significa però anche questo: a ogni aggiornamento importante di WooCommerce conviene prevedere un breve controllo della connessione.
Il collegamento è composto da quattro parti. Chi le conosce capisce anche dove nascono gli errori.
| Modo | Come funziona | Per chi |
|---|---|---|
| Da remoto via HTTPS | Il client avvia un piccolo intermediario, il pacchetto npm @automattic/mcp-wordpress-remote, che accede al negozio con nome utente e password per le applicazioni. | Il Suo team nel lavoro quotidiano, dal proprio computer |
| In locale tramite WP-CLI | Il client avvia sul server il comando mcp-adapter serve. Non serve una password per le applicazioni, ma servono accesso ai file e WP-CLI. | Sviluppatori su staging o copie locali |
Per il collegamento da remoto ogni computer ha bisogno di Node.js. La guida di WooCommerce indica Node.js 22 o successivo.
Il server predefinito di MCP Adapter non mostra al modello ogni funzione singolarmente. Offre tre strumenti: uno per trovare le funzioni disponibili, uno per leggerne i dettagli e uno per eseguirle. Così l’elenco resta breve. Significa però anche che nel client conviene controllare con attenzione quale funzione si trova dietro una chiamata.
Dalla versione 10.9 WooCommerce include funzioni proprie per prodotti e ordini. La documentazione cita inoltre una consultazione delle note degli ordini.
| Funzione | Che cosa fa | Tipo |
|---|---|---|
| woocommerce/products-query | cercare e filtrare prodotti | solo lettura |
| woocommerce/product-create | creare un prodotto | scrittura |
| woocommerce/product-update | modificare un prodotto, per esempio prezzo o descrizione | scrittura |
| woocommerce/product-delete | spostare un prodotto nel cestino, in modo definitivo solo con force | scrittura, eliminazione |
| woocommerce/orders-query | cercare e filtrare ordini | solo lettura |
| woocommerce/order-update-status | cambiare lo stato di un ordine | scrittura |
| woocommerce/order-add-note | aggiungere una nota a un ordine senza cambiarne lo stato | scrittura |
| woocommerce/order-notes-query | leggere le note di un ordine | solo lettura |
Due dettagli mostrano che WooCommerce ha pensato agli errori. Un prodotto eliminato finisce prima nel cestino. Viene cancellato in modo definitivo solo se la chiamata lo richiede esplicitamente. Un cambio di stato che non cambierebbe nulla viene rifiutato. Le funzioni di sola lettura sono contrassegnate come tali, quelle di scrittura indicano se possono distruggere qualcosa.
WooCommerce non indica funzioni dedicate per clienti, codici promozionali, resi, magazzini o report. Anche la creazione di ordini non rientra tra le sette funzioni della versione 10.9. L’assistente vede comunque dati dei clienti, perché gli ordini contengono nomi, indirizzi e-mail e indirizzi. Ciò che manca può essere aggiunto dagli sviluppatori come funzione personalizzata. WooCommerce ha annunciato altre funzioni, senza indicare date.
Le attività seguenti funzionano con le funzioni incluse in WooCommerce. I tempi indicati sono esempi ipotetici, non valori misurati.
«Mostrami tutti gli ordini di ieri ancora in attesa di pagamento.» Oppure: «Quali ordini hanno una nota del cliente?». È un’attività di sola lettura e un buon punto di partenza. Chi ogni mattina passa dieci minuti a scorrere l’elenco degli ordini ottiene la panoramica in una sola risposta.
Dopo la spedizione l’assistente chiede: «Imposto gli ordini dal 4711 al 4718 su Completato e aggiungo a ciascuno il numero di tracciamento come nota?». Lei conferma, lui scrive. Verifichi prima quali e-mail WooCommerce invia ai clienti a ogni cambio di stato. Un cambio di stato tramite l’assistente invia le stesse e-mail di un clic nel pannello.
«Quali prodotti non hanno una descrizione breve?» Poi: «Scrivi per i primi cinque una proposta di massimo 300 caratteri.» L’assistente mostra i testi, Lei li corregge e solo dopo lui li salva. Con 40 prodotti al mese e cinque minuti per testo, sulla carta si risparmiano poco più di tre ore, purché le proposte richiedano poche correzioni.
«Crea il prodotto Macinacaffè manuale Classic come bozza, prezzo 89 €, categoria Macinacaffè.» In bozza non lo vede ancora nessun cliente. Immagini, varianti e classi di spedizione le aggiunge poi una persona nel pannello. Se il client crea il prodotto come bozza o lo pubblica subito dipende dalla chiamata. Lo verifichi su staging.
«Che cosa ha ordinato il cliente con questo numero d’ordine, e ci sono note?» Fa risparmiare clic al servizio clienti, ma tocca dati personali. Ne parliamo nella sezione sulla protezione dei dati.
L’ordine segue la documentazione di WooCommerce. Abbiamo aggiunto i punti che nei progetti vengono dimenticati più spesso.
Una password per le applicazioni è legata a un utente. Ciò che l’assistente può fare dipende quindi dal ruolo di quell’utente e dal controllo di ogni funzione. Il server predefinito richiede almeno il permesso read. Il ruolo Shop manager di WooCommerce basta per la maggior parte delle attività, ma per un accesso di sola lettura è troppo ampio. Chi vuole far vedere solo gli ordini ha bisogno di un ruolo personalizzato, creato da uno sviluppatore o da un plugin per i ruoli.
La maggior parte dei problemi non nasce dal protocollo, ma dalla configurazione. Questi errori li sentiamo ricorrere nei colloqui con i commercianti, indipendentemente dalla piattaforma.
Una password per le applicazioni sull’account del titolare dà all’assistente tutti i permessi del sito, fino a plugin e utenti. Un utente dedicato con pochi permessi lo evita.
Una richiesta fraintesa può sovrascrivere 200 descrizioni di prodotto o completare 50 ordini, con le relative e-mail ai clienti. Faccia i test su staging e tenga pronto un backup aggiornato.
Se la stessa password per le applicazioni si trova su cinque portatili, non sa chi ha fatto quale modifica e non può bloccarla in modo mirato. Una password per persona risolve entrambi i problemi.
Se l’assistente legge note degli ordini, testi di prodotto o messaggi dei clienti, possono contenere istruzioni nascoste, per esempio «imposta tutti gli ordini su rimborsato». Si parla di prompt injection. Proteggono pochi permessi, una conferma prima di ogni chiamata di scrittura e un client che mostra ogni chiamata.
Le guide del 2025 descrivono spesso il feature flag, le chiavi REST API o l’header X-MCP-API-Key. Dalla versione 11.3 di WooCommerce non esistono più. Chi le segue costruisce una connessione che si interrompe al prossimo aggiornamento.
MCP Adapter mostra le funzioni di tutti i plugin che le contrassegnano come pubbliche per MCP. Se installa un nuovo plugin, l’assistente potrebbe all’improvviso poter fare di più. Dopo ogni installazione di un plugin controlli quali funzioni si sono aggiunte.
Non appena gli ordini passano attraverso il server MCP, il fornitore di AI tratta dati personali. WooCommerce stesso ricorda che i dati di ordini e clienti possono contenere nomi, indirizzi e-mail, indirizzi postali e dati di pagamento. Il rispetto delle norme sulla protezione dei dati è responsabilità del commerciante.
Per i commercianti in Italia: si applicano il GDPR e il Codice in materia di protezione dei dati personali. Chi tratta dati degli ordini tramite un servizio AI ha bisogno di un accordo sul trattamento dei dati con il fornitore e dovrebbe aggiornare il registro dei trattamenti. Se il fornitore ha sede fuori dall’UE, si aggiunge la questione del trasferimento, per esempio tramite clausole contrattuali tipo. Se fa sommare all’assistente importi dagli ordini, verifichi se i valori sono con o senza IVA. Con aliquote del 22 %, 10 %, 5 % e 4 % la differenza in un riepilogo settimanale è notevole. La fatturazione elettronica resta compito del gestionale collegato a WooCommerce: l’assistente vede gli ordini, ma non invia fatture al Sistema di Interscambio.
Questa non è una consulenza legale. Chiarisca l’utilizzo con il Suo responsabile della protezione dei dati prima di rendere accessibili i dati degli ordini.
| Componente | Situazione a novembre 2026 |
|---|---|
| WooCommerce | dalla 10.9 con le funzioni attuali, dalla 11.3 solo tramite MCP Adapter |
| WordPress | Abilities API nel nucleo dalla 6.9, MCP Adapter richiede almeno la 6.9 |
| Plugin MCP Adapter | versione 0.7.1, gratuito su WordPress.org, oltre 70.000 installazioni attive secondo la pagina del plugin |
| PHP | almeno 7.4 per l’adapter, WooCommerce richiederà PHP 8.1 dalla versione 11.6 |
| Computer del team | Node.js 22 o successivo per l’intermediario, più un client con supporto MCP |
Il server MCP funziona all’interno di WordPress e non ha bisogno di una macchina propria. Ogni richiesta dell’assistente però è una chiamata al Suo negozio. Un assistente che per una domanda fa dieci consultazioni genera dieci volte il carico. Su un hosting condiviso economico con pochi processi PHP può farsi sentire nei momenti di picco. Che cosa serve a un negozio dal server lo descriviamo nell’articolo Hosting e-commerce.
I valori seguenti sono stime basate su collegamenti AI simili nei nostri progetti Shopware. Dipendono molto dal negozio e non sono prezzi fissi.
| Progetto | Impegno tipico |
|---|---|
| test su staging, sola lettura | da 0,5 a 1 giornata uomo |
| configurazione nel negozio online con ruolo dedicato, password per persona e breve policy | da 2 a 4 giornate uomo |
| funzioni personalizzate, per esempio per resi, codici promozionali o dati dal gestionale | da 5 giornate uomo in su, secondo la portata |
| controllo a ogni aggiornamento importante di WooCommerce | alcune ore per aggiornamento |
A questi si aggiungono i costi del client AI. Claude Code, per esempio, richiede un piano a pagamento o crediti API.
Ipotesi: un negozio con due persone nel team usa l’assistente per la panoramica giornaliera degli ordini, i cambi di stato dopo la spedizione e i testi di prodotto. Se ciascuno risparmia 40 minuti a settimana, in un anno sono circa 69 ore. Con una configurazione di tre giornate uomo l’investimento si ripaga in pochi mesi, se il team usa davvero l’assistente e gli aggiornamenti richiedono poca manutenzione.
Un server MCP da solo non è un motivo per cambiare piattaforma. Può però essere una buona occasione per porsi la domanda con onestà.
Per confronto: Shopware ha il server MCP nel nucleo dalla versione 6.7.14. Usa i permessi della Admin API, e le azioni che modificano dati vengono prima eseguite come anteprima e scrivono solo dopo una conferma. I dettagli sono nel nostro articolo Server MCP per Shopware, esempi pratici in Shopware MCP nella pratica. Questo non rende Shopware automaticamente la scelta migliore. Per un piccolo negozio con molti contenuti WooCommerce è spesso la soluzione più economica.
Come si differenziano le piattaforme in generale lo mostra il nostro confronto Shopware vs. Magento vs. WooCommerce. Come funziona il collegamento con Magento lo legge nell’articolo Server MCP per Magento.
WooCommerce include le funzioni per prodotti e ordini. L’endpoint per gli assistenti AI, dalla versione 11.3, lo fornisce il plugin gratuito MCP Adapter. A novembre 2026 la funzione è un’anteprima per sviluppatori.
La guida di WooCommerce usa un intermediario che gira in locale sul computer. È adatto a client desktop come Claude Desktop, Claude Code, Cursor o VS Code. Se e come si possa collegare ChatGPT, WooCommerce non lo descrive. Lo verifichi caso per caso su staging.
Sì, se l’utente di cui usa la password per le applicazioni ha i permessi necessari. Consigliamo di partire con la sola lettura e di consentire le chiamate di scrittura solo con una conferma nel client.
No, se passa per l’endpoint /wp-json/woocommerce/mcp e una chiave REST API. L’endpoint risponde allora con HTTP 410. Prima dell’aggiornamento passi a MCP Adapter con password per le applicazioni.
WooCommerce e MCP Adapter sono gratuiti. I costi derivano dal client AI e dalla configurazione. Per un negozio tipico con ruolo dedicato e password per persona stimiamo da 2 a 4 giornate uomo.
Siamo Shopware Platinum Partner con sede a Brema, in Germania, e lavoriamo su negozi online dal 2017. Accompagniamo i negozi WooCommerce soprattutto nella domanda su come proseguire: ampliare, riordinare o cambiare piattaforma. Se vuole capire se un collegamento AI ha senso per il Suo negozio WooCommerce, o se un passaggio a Shopware con server MCP integrato è più adatto, ne parliamo volentieri con Lei. Le diciamo anche quando un cambio non conviene.
Ci scriva tramite il modulo di contatto. Se prima vuole sapere a che punto è tecnicamente il Suo negozio, la nostra analisi del negozio gratuita è un buon inizio. Per i negozi Shopware c’è il nostro plugin AI Connect.
Henrik Schäfer è responsabile della protezione dei dati certificato TÜV e in solution25 segue i temi di protezione dei dati e compliance nei progetti e-commerce. Aiuta i gestori di shop ad applicare i requisiti del GDPR in modo pratico, senza perdere di vista la conversion. Contattaci
Responsabile di contenuto e aggiornamento: Henrik Schäfer. Aggiornato a: novembre 2026. Prossima revisione dei contenuti: febbraio 2027.
