Questa è la prima parte di una serie in tre parti su WooCommerce MCP. Questo post spiega cos’è MCP, come funziona e come iniziare con le abilità integrate. La seconda parte riguarda la creazione delle tue prime abilità personalizzate. La terza parte approfondisce con demo avanzate e considerazioni sulla produzione.
Mi sono approfondito in qualcosa di veramente entusiasmante in WooCommerce: il Integrazione del protocollo del contesto del modello (MCP). MCP è stato distribuito per la prima volta come beta nella 10.3 ed è maturato nel corso dei rilasci. Ora, con WooCommerce 10.7 e WordPress 6.9+, lo stack è abbastanza solido da poterci costruire sopra alcune cose davvero utili. Quindi, sono andato avanti e ho fatto esattamente questo.
Immagina questo: stiamo chattando con un assistente AI e diciamo qualcosa del tipo “Mostrami i miei prodotti a basso stock” O “Crea un prodotto chiamato Felpa con cappuccio invernale per $ 39,99.” Il nostro negozio WooCommerce risponde, fa il lavoro e restituisce i risultati. Nessun clic sulla dashboard di WordPress, nessuna chiamata API REST manuale. Solo conversazioni naturali che si trasformano in azioni reali del negozio.
Questo è ciò che consente MCP. In questo post utilizzerò Codice Claudio come assistente AI, ma MCP funziona con qualsiasi client compatibile: Cursore, VS Code o qualsiasi altra cosa che parli il protocollo MCP. Usa quello che funziona meglio per te.
Esploriamolo insieme!
Pensaci MCP come traduttore universale tra gli strumenti di intelligenza artificiale e il nostro negozio WooCommerce. Normalmente, se vogliamo che l’intelligenza artificiale interagisca con il nostro negozio, dovremmo:
- Crea integrazioni API REST personalizzate.
- Gestire noi stessi l’autenticazione.
- Scrivi un sacco di codice per analizzare le risposte.
MCP cambia tutto questo. È uno standard open source che consente agli assistenti AI come Claude, Cursor o VS Code di parlare direttamente con sistemi come WooCommerce utilizzando il linguaggio naturale.
Con MCP:
- L’intelligenza artificiale può scoprire cosa può fare il nostro negozio.
- L’intelligenza artificiale può eseguire tali azioni in sicurezza.
- Tutto funziona entro le nostre autorizzazioni esistenti.
Quindi quando diciamo: “Elenca tutti i prodotti sotto i 20$ USD”, MCP lo traduce in qualcosa che WooCommerce comprende, lo esegue in modo sicuro e restituisce i risultati.
Tre elementi lavorano insieme per far sì che ciò accada e si basano tutti sulla sicurezza WooCommerce esistente.
Gli elementi costitutivi
API delle funzionalità WordPress
IL API delle funzionalità WordPress è un modo con cui i plugin di WordPress registrano le “abilità”, fondamentalmente cose che possono fare. Pensatelo come un menu: WooCommerce dice a WordPress: “Ecco tutto quello che posso fare” e gli assistenti AI possono leggere quel menu e scegliere ciò di cui hanno bisogno. Ogni abilità ha un nome come:
woocommerce/products-list: elenca tutti i prodottiwoocommerce/orders-create: crea un nuovo ordine
L’API Abilities fornita in WordPress 6.9 come funzionalità principale. Fornisce un registro standardizzato a cui qualsiasi plug-in può collegarsi, quindi WooCommerce non ha più bisogno di raggrupparlo separatamente. Coloro che sviluppano abilità personalizzate sono registrati su wp_abilities_api_init gancio (più su questo nella seconda parte della serie).
Adattatore MCP WordPress
IL Adattatore MCP è il traduttore. Prende i messaggi MCP dagli assistenti AI e li converte in qualcosa che WordPress capisce. Consideratelo come l’intermediario che parla sia del “protocollo AI” che di “WordPress”.
API REST di WooCommerce
Le attuali funzionalità MCP si collegano agli endpoint API REST esistenti. Ciò significa che le autorizzazioni API REST esistenti continuano a controllare tutto e la sicurezza rimane esattamente la stessa.
In futuro, le abilità potrebbero andare oltre REST e fare cose ancora più potenti. Ma per ora, questo ci fornisce una base solida e sicura.
Il flusso della comunicazione
Quando digitiamo “elenca tutti i prodotti” in Claude Code, ecco cosa succede passo dopo passo:
AI Client (Claude, etc.)
↓ (MCP protocol over stdio/JSON-RPC)
Local MCP Proxy (mcp-wordpress-remote)
↓ (HTTP/HTTPS requests with authentication)
Remote WordPress MCP Server (mcp-adapter)
↓ (WordPress Abilities API)
WooCommerce Abilities
↓ (REST API calls or direct operations)
WooCommerce CoreIn parole povere, Claude Code invia un messaggio a un piccolo strumento proxy in esecuzione sulla nostra macchina. Il proxy lo converte in una richiesta web sicura e la invia all’endpoint MCP del nostro sito WordPress. L’adattatore MCP cerca quale capacità eseguire, la richiamata della capacità viene eseguita (interrogazione di ordini, prodotti, ecc.) e il risultato ritorna allo stesso modo.
Il proxy locale (@automattic/mcp-wordpress-remote) è piccolo Node.js strumento che installiamo una volta durante la configurazione e poi dimentichiamolo. Il suo compito è quello di tradurre tra il modo in cui comunicano i client AI (stdio) e il modo in cui funziona WordPress (HTTP).
MCP è arrivato come beta in WooCommerce 10.3 con funzionalità di prodotto e ordine. L’aggiornamento da allora è stata la migrazione dell’adattatore MCP v0.3.0 nella versione 10.4, che ha aggiornato il livello di trasporto. Da allora, la superficie MCP è rimasta stabile fino alle versioni 10.5, 10.6, 10.6.1 e 10.7, che è ciò su cui stiamo lavorando.
MCP è ancora presente anteprima per sviluppatoriquindi le abilità integrate sono limitate al prodotto e all’ordine CRUD (crea, leggi, aggiorna, elimina). Ma le basi sono solide, ed è qui che entrano in gioco le abilità personalizzate.
Fuori dagli schemi, WooCommerce viene fornito con nove abilità MCP:
Prodotti:
woocommerce/products-listproducts-getproducts-createproducts-updateproducts-delete
Ordini:
woocommerce/orders-listorders-getorders-createorders-update
Questo è già abbastanza potente per creare flussi di lavoro davvero interessanti. Ma è dove la cosa diventa davvero interessante Abilità personalizzateed è ciò in cui approfondiremo la seconda parte di questa serie.
Prerequisiti
- Un luogo di sosta (WooCommerce MCP è in anteprima per sviluppatori)
- WooCommerce 10.7 (o 10.3+)
- WordPress 6.9+ (per l’API Abilities principale)
- Node.js 22+ (richiesto dalla versione più recente
mcp-wordpress-remote) - Chiave API REST con autorizzazioni read_write
- Un client MCP (userò Claude Code). Nota: Claude Code richiede un piano Claude Pro o Max ($20/mese+) o crediti API Anthropic. Non è disponibile nel livello gratuito.
Abilitazione dell’MCP
Opzione 1: Vai a Amministratore WP > WooCommerce > Impostazioni > Avanzato > Caratteristiche e abilitare WooCommerce MCP.
Opzione 2: Abilita tramite WP-CLI
wp option update woocommerce_feature_mcp_integration_enabled yes
Impostazione della connessione
Crea una chiave API
- Nella dashboard di amministrazione WP del tuo negozio, vai a WooCommerce > Impostazioni > Avanzato > API REST.
- Clic Aggiungi chiave.
- Imposta le autorizzazioni su Leggere/Scrivere.
- Salva la chiave e il segreto del consumatore.
Configura il codice Claude
Apri il Terminale ed esegui:
claude mcp add woocommerce_mcp \
--env WP_API_URL=https://yourstore.com/wp-json/woocommerce/mcp \
--env CUSTOM_HEADERS='{"X-MCP-API-Key": "YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET"}' \
-- npx -y @automattic/mcp-wordpress-remote@latestImportante:
- Sostituire
yourstore.comcon l’URL del sito di gestione temporanea effettivo. - Sostituisci il
YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRETparte con le effettive credenziali API. - Riavvia Claude Code per caricare la nuova configurazione.
Per lo sviluppo locale con HTTP: Per testare localmente senza HTTPS, aggiungi questo filtro:
add_filter( 'woocommerce_mcp_allow_insecure_transport', '__return_true' );Esploriamo le abilità predefinite fornite con WooCommerce. Funzionano immediatamente senza codice personalizzato.
Elenca tutti i prodotti
Chiedi al cliente AI: “Elenca tutti i prodotti nel negozio.”
Cosa succede dietro le quinte:
- MCP chiama l’abilità:
woocommerce/products-list - Restituisce i dati del prodotto con nomi, prezzi, stato delle scorte, ecc.
Crea un prodotto
Prova questo: “Crea un prodotto denominato “Demo Felpa con cappuccio” al prezzo di $ 29,99.”
Chiamate MCP:
- Capacità:
woocommerce/products-create - Risultato: un nuovo prodotto appare nel negozio!
Aggiorna un prodotto
Dire: “Aggiorna il prezzo della felpa demo a $ 39,99.”
Chiamate MCP:
- Capacità:
woocommerce/products-update - Il prezzo cambia istantaneamente!
Crea un ordine
Tentativo: “Crea un ordine per l’ID prodotto 56 con quantità 2.”
Chiamate MCP:
- Capacità:
woocommerce/orders-create - Viene creato un nuovo ordine!
Abbastanza sorprendente, vero? Queste funzionalità integrate rendono naturale la gestione del negozio assistita dall’intelligenza artificiale. E questo è solo l’inizio!
Nella seconda parte, andremo oltre le funzionalità integrate e creeremo abilità personalizzate da zero, tra cui un dashboard di analisi delle vendite di oggi, un avviso di scorte in esaurimento e uno strumento di ricerca clienti. Ci vediamo lì!
Kamlesh è un ingegnere della felicità presso WooCommerce. Ama aiutare i clienti a ottenere il massimo da WordPress e WooCommerce: più vede cosa è possibile per loro, più si entusiasma. Al di fuori di Woo, lo troverai ad esplorare nuove tecnologie o gadget, a viaggiare senza piani fissi o a guardare il cricket con un’intensità irragionevole.
