Server MCP WooCommerce per agenti di acquisto AI
Esponi il catalogo WooCommerce tramite un MCP pubblico e in sola lettura, così gli agenti compatibili possono scoprire prodotti, cercare in modo efficiente e verificare dati aggiornati senza credenziali amministrative.
La risposta diretta
KaliCart Bridge aggiunge al negozio una superficie MCP rivolta agli acquirenti sul dominio del merchant. Un client compatibile può scoprire gli strumenti catalogo, cercare schede sintetiche e recuperare i dettagli aggiornati di un prodotto selezionato. Il contratto pubblico resta in sola lettura: niente clienti, ordini privati, modifica prodotti o amministrazione.
Di quale MCP WooCommerce stiamo parlando?
WooCommerce 10.9 e KaliCart Bridge usano entrambi MCP, ma servono chiamanti e confini di fiducia diversi. Confonderli produce un’interfaccia pubblica inutilizzabile oppure una superficie amministrativa insicura.
| Ability native di WooCommerce | MCP di KaliCart Bridge | Come convivono |
|---|---|---|
| Sette ability canoniche, definite da schema e soggette a permessi per prodotti e ordini. Servono a operazioni autenticate tramite WordPress Abilities API e MCP Adapter. | Una superficie pubblica e deliberatamente limitata alla lettura del catalogo. Espone solo dati prodotto pubblicati dal merchant e non trasferisce poteri di scrittura. | Il merchant può usarli entrambi. Gli assistenti autorizzati usano le ability native per gestire il negozio; gli agenti di acquisto usano Bridge per discovery e verifica. Credenziali, policy e log restano separati. |
Cosa può fare un agente di acquisto
1. Scoprire gli strumenti del catalogo
Il client MCP identifica le funzionalità pubbliche senza indovinare route REST o analizzare la navigazione del tema.
2. Cercare record prodotto compatti
Query limitate restringono il catalogo per testo e filtri supportati, riducendo token, banda e carico sul server.
3. Verificare il prodotto selezionato
Una richiesta di dettaglio controlla identità, prezzo, valuta, disponibilità, URL canonico e varianti acquistabili sul negozio del merchant.
4. Proseguire nel checkout del merchant
L’agente riporta l’utente alla pagina prodotto o al checkout canonico. Opzioni, totali, pagamento e ordine restano a WooCommerce.
Dati commerciali utili alla decisione
| Segnale | Perché serve |
|---|---|
| Identità stabile | ID prodotto, SKU e URL canonico distinguono i candidati ed evitano duplicazioni. |
| Classificazione | Nome, categorie, brand e attributi strutturati supportano ricerca e confronto. |
| Dati dell’offerta | Prezzo, valuta, disponibilità e acquistabilità descrivono ciò che WooCommerce pubblica ora. |
| Dettaglio varianti | Le varianti acquistabili impediscono di promettere taglie o opzioni presenti solo nel testo. |
| Media e descrizione | I dettagli completi vengono richiesti per i finalisti, non per ogni risultato. |
| Confine d’azione | URL canonici e stato d’acquisto indicano quando deve subentrare il flusso del merchant. |
Perché ricerca e verifica sono separate
Un agente non ha bisogno di ogni campo per ogni prodotto. Bridge separa discovery economica e verifica dettagliata: la ricerca restituisce candidati compatti, mentre i dati completi vengono richiesti solo per la shortlist. Si riduce il traffico senza perdere il controllo live prima della raccomandazione.
Confini progettati per un endpoint pubblico
- Strumenti in sola lettura: niente scritture prodotto, clienti, ordini privati o amministrazione.
- Paginazione e limiti: una singola chiamata non può pretendere l’intero catalogo.
- Rate limiting e indicazioni di retry: i client conformi possono rallentare.
- Pubblicazione controllata dal merchant: sulla superficie rientrano solo dati WooCommerce volutamente pubblici.
- Nessun segreto amministrativo condiviso: la discovery non richiede consumer key o sessioni admin.
Il rapporto con WooCommerce 10.9
WooCommerce 10.9 ha sostituito la precedente architettura derivata dalle REST API con sette ability canoniche: query, creazione, aggiornamento ed eliminazione prodotti; query ordini, aggiornamento stato e aggiunta note. Il vecchio endpoint MCP specifico resta come percorso di transizione deprecato. Queste ability sono un importante livello gestionale autenticato, non un’interfaccia pubblica automatica per lo shopping.
Bridge non sostituisce né critica quel lavoro. Aggiunge la proiezione pubblica separata necessaria quando un agente arriva senza una connessione gestionale preconfigurata.
La discovery non garantisce l’adozione
Cosa non promette questa soluzione
- Nessun supporto automatico da ogni piattaforma AI o client MCP.
- Nessuna identità dell’agente, autorizzazione del consumatore, pagamento o controllo post-vendita.
- Nessun accesso pubblico a clienti, ordini o amministrazione WooCommerce.
- Nessuna correzione automatica di brand, identificatori, attributi o varianti incompleti.
- Nessuna sostituzione di checkout, spedizioni, imposte o pagamenti del merchant.
A chi serve
Merchant WooCommerce indipendenti e implementatori che vogliono una discovery compatibile con MCP senza trasformare un’API amministrativa in endpoint pubblico. È utile anche come fonte live verificabile dopo che un prodotto è stato trovato tramite feed, indice o conversazione.
Soluzioni correlate
API prodotti WooCommerce per agenti AI
Approfondisci il contratto in sola lettura usato per ricerca e verifica live.
Architettura merchantCommercio agentico per WooCommerce
Inserisci MCP nel percorso completo dalla discovery al checkout del merchant.
Domande frequenti
- Espone l’amministrazione WooCommerce?
- No. Gli strumenti MCP pubblici di Bridge sono in sola lettura e limitati ai dati catalogo volutamente pubblicati.
- È lo stesso server MCP incluso in WooCommerce 10.9?
- No. Le ability native sono capacità gestionali soggette a permessi; Bridge offre un confine catalogo separato per lo shopping.
- Gli agenti pubblici richiedono consumer key WooCommerce?
- No. La superficie catalogo non concede autorità amministrativa.
- Un agente può creare ordini o emettere rimborsi?
- No. Checkout, identità cliente, ordini e post-vendita sono fuori dal contratto MCP pubblico.
- Ogni assistente AI scoprirà il server?
- No. L’endpoint è disponibile ai client compatibili, ma ogni piattaforma decide cosa supportare.
- MCP basta con dati catalogo incompleti?
- No. MCP trasporta chiamate strutturate; non può inventare brand, identificatori, prezzi o varianti mancanti.