Modifica degli ordini Shopify e Catalog MCP: 7 attività AI in 4 secondi

Su oltre 10 milioni di ordini Shopify, circa 1 su 19 (5,2%) viene modificato dopo il checkout (Revize, 2026). Ecco come funziona Shopify Catalog MCP nella pratica: un merchant chiede a un assistente AI quali prodotti della collezione estiva hanno meno di 10 unità disponibili nel magazzino di Chicago. L’AI interroga il catalogo del negozio, incrocia le scorte per sede e restituisce un elenco filtrato in circa quattro secondi. Questa precisione conta anche oltre il riassortimento: su oltre 10 milioni di ordini Shopify, circa 1 su 19 (5,2%) viene modificato dopo il checkout (Revize, 2026), e ogni modifica richiede dati aggiornati sulle scorte per essere elaborata correttamente. Niente tabelle pivot. Niente esportazioni da Shopify Admin. Nessuno che debba incrociare i dati a mano.

Non è uno scenario dimostrativo. I team dei negozi Plus lo usano già in produzione.

C’è però un punto che molte spiegazioni tralasciano: «Catalog MCP» non è un prodotto Shopify distinto e già disponibile. È una funzionalità che configuri tu. Due definizioni semplici aiutano a capire il resto dell’articolo. Un’API è la porta attraverso cui un software chiede dati a un altro, un po’ come quando un cassiere scansiona un articolo per recuperarne il prezzo dal sistema. MCP (Model Context Protocol) è un linguaggio condiviso, rilasciato da Anthropic a novembre 2024, che permette a un assistente AI di usare queste porte senza creare un collegamento su misura per ciascuna. «Catalog MCP» significa semplicemente dare a un’AI accesso ai dati dei prodotti del tuo negozio tramite questo linguaggio condiviso.

La distinzione tra ciò che Shopify offre direttamente e ciò che configuri usando le sue API è fondamentale. Se la trascuri, rischi di basare un sistema su presupposti che non reggono in produzione. Questa guida spiega come funziona davvero, quali operazioni supporta a metà 2026, come si comportano le autorizzazioni in condizioni reali e cosa significa per i team che gestiscono le operazioni successive all’acquisto su larga scala.

Risposta rapida: Shopify Catalog MCP indica le operazioni che un agente AI può svolgere sui dati dei prodotti, sulle scorte, sulle collezioni e sui prezzi del tuo negozio tramite il Model Context Protocol. Funziona attraverso l’Admin API o la Storefront API di Shopify, collegate a un server MCP che configuri o sviluppi. A metà 2026, le operazioni di lettura (ricerca, filtri, verifica delle scorte, accesso ai metafield) sono ben supportate e pronte per la produzione. Le operazioni di scrittura (aggiornamenti dei prezzi, modifiche ai prodotti, modifiche alle varianti) funzionano con le autorizzazioni API appropriate, ma richiedono una configurazione attenta. Non è una funzionalità Shopify pronta all’uso: richiede un’integrazione, che può valere la pena realizzare.

Quali funzionalità offre Shopify Catalog MCP?#

Le funzionalità di Shopify Catalog MCP sono le operazioni che un agente AI può svolgere sui dati dei prodotti del tuo negozio dopo che hai collegato un server MCP alle API di Shopify. Il protocollo alla base, Model Context Protocol, è stato reso open source da Anthropic a novembre 2024 e da allora è diventato l’interfaccia standard del settore tra assistenti AI e fonti di dati esterne.

L’architettura è semplice. MCP si trova tra l’AI (Claude, GitHub Copilot, GPT-4o) e l’API di Shopify (Admin o Storefront). L’AI invia una richiesta in linguaggio naturale al server MCP. Il server la traduce in una chiamata GraphQL strutturata (GraphQL è il formato preciso delle query accettate dai sistemi Shopify). Shopify restituisce i dati. L’AI li presenta. In pratica, fai una domanda con parole comuni, uno strato intermedio la traduce nel linguaggio del negozio e poi traduce la risposta. Per ottenere il risultato non serve scrivere codice.

Shopify offre un server MCP ufficiale: @shopify/dev-mcp, disponibile su npm dall’inizio del 2025. È pensato per gli strumenti di sviluppo e dà agli assistenti AI accesso alla documentazione di Shopify, alle librerie di componenti e alle utilità per sviluppatori. Non è ciò che i merchant cercano quando parlano delle funzionalità MCP per il catalogo.

Operazioni come «mostrami tutti gli SKU esauriti» o «aggiorna contemporaneamente i prezzi di 40 varianti» sono offerte da server MCP creati dalla community o sviluppati su misura che si collegano all’Admin API (GraphQL) o alla Storefront API di Shopify. Entrambe le API sono consolidate e ben documentate. Lo strato MCP aggiunge l’interfaccia in linguaggio naturale e il registro degli strumenti necessari all’agente AI per chiamarle.

La guida a Universal Commerce Protocol spiega come la standardizzazione a livello di protocollo stia cambiando ciò che gli agenti AI possono fare nell’ecosistema del commercio.

Come funziona l’accesso al catalogo Shopify tramite MCP#

L’accesso al catalogo Shopify tramite MCP si basa su tre livelli: un client AI, un server MCP e un’API di Shopify. Ogni livello ha un compito preciso e può essere sostituito senza riscrivere gli altri. È questa modularità a rendere MCP utile con diversi strumenti AI e diverse configurazioni del negozio.

Il livello del protocollo: cosa fa MCP#

MCP definisce uno schema di «strumenti» (funzioni richiamabili) e «risorse» (oggetti dati leggibili). Quando un agente AI ha bisogno dei dati del catalogo, richiama uno strumento MCP come get_products o search_catalog. Il server MCP registra questi strumenti, gestisce l’autenticazione e indirizza a Shopify la chiamata API corrispondente.

Il livello API: Admin e Storefront#

In parole semplici, l’Admin API è l’ingresso riservato al personale del tuo negozio: offre accesso completo e permette di modificare prezzi, scorte e ordini. La Storefront API è la vetrina pubblica: consente la sola lettura ed è limitata a ciò che un cliente può vedere. Per lavorare sul catalogo, nella maggior parte dei casi serve l’ingresso riservato al personale. In termini tecnici, l’Admin API di Shopify si basa su GraphQL, supporta le operazioni di scrittura e gestisce aggiornamenti delle scorte, modifiche ai prodotti, scrittura dei metafield (campi dati personalizzati associati ai prodotti, come una guida alle taglie o un codice fornitore) e gestione delle collezioni. La Storefront API è rivolta al pubblico e consente solo la lettura: va bene per gli agenti AI che assistono i clienti durante gli acquisti, ma non basta per la gestione operativa del catalogo.

L’autenticazione avviene tramite un normale flusso OAuth o token di app private. La maggior parte delle implementazioni di server MCP per l’accesso al catalogo Shopify usa token di app private con le sole autorizzazioni necessarie. Il token dell’Admin API risiede nella configurazione dell’ambiente del server MCP, mai nel client AI.

Quali operazioni supporta Shopify Catalog MCP#

A metà 2026, le implementazioni in produzione di Shopify Catalog MCP supportano sette categorie distinte di operazioni sul catalogo. Non sono possibilità teoriche: i team dei negozi Plus le usano già.

1. Ricerca e filtri dei prodotti. Puoi effettuare ricerche per titolo, fornitore, tipo di prodotto, tag, fascia di prezzo o stato di pubblicazione. È lo strumento implementato più spesso e funziona in modo affidabile con tutte le versioni attuali delle API.
2. Query su varianti e opzioni. Puoi recuperare tutte le varianti di un prodotto con SKU, prezzi, quantità disponibili e combinazioni di opzioni (taglia, colore, materiale). È qui che gli agenti AI mostrano il loro valore su larga scala: per recuperare questi dati per 200 prodotti, a una persona servirebbero 10 minuti; un agente impiega pochi secondi.
3. Appartenenza alle collezioni. Puoi controllare a quali collezioni appartiene un prodotto oppure recuperare tutti i prodotti di una collezione. È utile per verifiche del catalogo, promozioni stagionali e gestione dei canali.
4. Scorte in tempo reale per sede. Puoi recuperare le scorte di più magazzini tramite gli oggetti inventoryLevel di Shopify. Le query sulle scorte per sede sono tra gli usi più utili di Catalog MCP per chi gestisce più magazzini e almeno 500 ordini al mese.
5. Lettura e scrittura dei metafield. I dati personalizzati dei prodotti memorizzati nei metafield (guide alle taglie, certificazioni, codici fornitore, metadati per il cross-selling) sono interamente leggibili e, con le autorizzazioni di scrittura, aggiornabili tramite MCP. Questo rende possibili flussi di arricchimento del catalogo che prima richiedevano interventi manuali in Shopify Admin o script personalizzati.
6. Aggiornamenti in blocco dei prodotti. Il supporto alle operazioni in blocco dell’Admin API è disponibile anche nelle implementazioni MCP. Gli agenti AI possono aggiornare prezzi, descrizioni o stato di pubblicazione in cataloghi di grandi dimensioni con un unico flusso di lavoro, registrando le modifiche per una verifica prima della conferma.
7. Accesso ai cataloghi B2B (Plus). I listini prezzi specifici per azienda e le assegnazioni dei cataloghi B2B (sottoinsiemi di prodotti e prezzi per gli account all’ingrosso) sono accessibili tramite l’Admin API su Shopify Plus. Un server MCP può verificare quali prodotti rientrano nel catalogo assegnato a un’azienda e controllare i prezzi B2B. È l’uso di Catalog MCP con il maggior potenziale per i negozi Plus che hanno un canale all’ingrosso importante.

Cosa significa Catalog MCP per le operazioni successive all’acquisto#

Le possibilità offerte da MCP non si fermano al catalogo. Quando un agente AI può leggere i dati dei prodotti e degli ordini attraverso la stessa interfaccia, i flussi di lavoro successivi all’acquisto cambiano sensibilmente. È qui che l’accesso al catalogo diventa utile anche ai team operativi.

Considera una richiesta di reso. In un unico flusso di lavoro, un agente collegato tramite MCP può leggere l’ordine originale, verificare la disponibilità attuale di un prodotto per un cambio, controllare che il prezzo non sia cambiato e proporre una soluzione. Senza MCP, servono tre schermate distinte di Shopify Admin e una persona che colleghi manualmente le informazioni.

Brand come Square Enix e Nude Project, che gestiscono un volume elevato di operazioni successive all’acquisto, incontrano proprio questo ostacolo: la distanza tra le richieste dei clienti dopo il checkout e ciò che il team operativo può fare senza passare continuamente da uno strumento all’altro. Per capire come funziona la gestione degli ordini su larga scala, l’accesso al catalogo tramite MCP colma il divario nel recupero dei dati prima ancora che debba intervenire una persona.

Catalog MCP e modifica degli ordini dopo l’acquisto si incontrano in un momento preciso: quando un cliente vuole sostituire una variante dopo il checkout, un agente che usa MCP può verificare che la variante sostitutiva sia disponibile prima di proporre il cambio. Questa verifica delle scorte in tempo reale può fare la differenza tra una modifica completata senza problemi e una che crea un’eccezione durante l’evasione dell’ordine.

Per modificare effettivamente l’ordine (cambiare le voci, adeguare i prezzi, aggiornare le istruzioni di evasione), strumenti come Revize gestiscono le operazioni di scrittura su Shopify. L’architettura è lineare: lettura del catalogo tramite MCP, modifica dell’ordine tramite un’app dedicata alle operazioni successive all’acquisto. Se stai valutando come permettere ai clienti di gestire autonomamente le modifiche dopo il checkout, la guida all’annullamento degli ordini Shopify spiega nel dettaglio cosa è possibile fare.

Commercio agentico e Catalog MCP: cosa è già disponibile e cosa arriverà#

A metà 2026, le funzionalità Shopify Catalog MCP già disponibili sono meno ampie di quanto suggerisca l’entusiasmo intorno al tema, ma più avanzate di quanto molti merchant pensino. Ecco una panoramica concreta.

Cosa è già disponibile e pronto per la produzione:

• Flussi di lavoro sul catalogo basati soprattutto sulla lettura: ricerca, filtri, verifiche ed esportazione verso altri strumenti
• Monitoraggio delle scorte e verifiche della disponibilità per sede
• Lettura e scrittura dei metafield per arricchire il catalogo
• Operazioni di scrittura tramite l’Admin API (prezzi, descrizioni, stato) con le autorizzazioni appropriate
• Integrazione con client AI compatibili con MCP, tra cui Claude Desktop e GitHub Copilot

Cosa è ancora in evoluzione:

• Hosting MCP gestito direttamente da Shopify (la maggior parte delle implementazioni è ospitata in proprio o distribuita su piattaforme come Railway o Fly.io)
• Schemi standardizzati per gli strumenti MCP del catalogo (oggi ogni team definisce le proprie interfacce, creando difficoltà di integrazione quando si cambia client AI)
• Agenti AI rivolti ai consumatori che usano Catalog MCP per offrire consigli d’acquisto personalizzati in tempo reale su larga scala
• Un livello di prodotti agentici gestito direttamente da Shopify, che sembra figurare nella sua roadmap ma non è ancora stato rilasciato come prodotto per i merchant

La direzione è chiara. Shopify ha investito molto negli strumenti AI nel corso del 2025 e del 2026, e MCP è diventato il modo standard con cui AI e API comunicano. I merchant che comprendono l’architettura oggi, prima dell’arrivo di un prodotto pronto all’uso, partiranno avvantaggiati quando sarà disponibile.

Questo si collega direttamente alla guida per vendere su ChatGPT con le vetrine agentiche di Shopify: l’AI sta diventando un percorso d’acquisto che interagisce con il catalogo in tempo reale, e MCP rende possibile questa interazione.

Domande frequenti#

Catalog MCP è un prodotto specifico di Shopify?#

No, «Catalog MCP» non è il nome di un prodotto o di una funzionalità Shopify distinta. È un modo sintetico per indicare l’uso del Model Context Protocol per collegare gli agenti AI ai dati del catalogo Shopify: prodotti, varianti, collezioni e scorte. Puoi ottenere questa funzionalità collegando un server MCP all’Admin API o alla Storefront API di Shopify. Il server MCP ufficiale di Shopify (@shopify/dev-mcp) è destinato agli strumenti di sviluppo, non alle operazioni sul catalogo dei merchant. Tutto ciò che potresti chiamare «Catalog MCP» è realizzato dalla community o sviluppato su misura.

Che cos’è esattamente il Model Context Protocol?#

MCP è un protocollo aperto, rilasciato da Anthropic a novembre 2024, che standardizza la comunicazione tra modelli AI, strumenti esterni e fonti di dati. Puoi immaginarlo come un adattatore universale: invece di scrivere codice personalizzato affinché ogni integrazione AI comunichi con ciascuna API, MCP offre un’interfaccia condivisa. Le API di Shopify possono essere collegate a un server MCP, così qualsiasi client AI compatibile può chiamarle senza sviluppare un’integrazione specifica per ogni strumento AI che vuoi usare.

Mi serve uno sviluppatore per configurare Shopify Catalog MCP?#

Sì, a metà 2026 la configurazione dell’accesso a Shopify Catalog MCP richiede l’intervento di uno sviluppatore. Devi creare un’app Shopify personalizzata con le autorizzazioni API appropriate, distribuire o collegare un server MCP e configurare gli strumenti del catalogo che vuoi rendere disponibili. I pacchetti open source su npm (cerca shopify-mcp-server) velocizzano la configurazione, ma richiedono comunque hosting e configurazione dell’ambiente. Stanno emergendo soluzioni MCP per Shopify pronte all’uso e senza codice, ma non sono ancora diffuse.

Quali piani Shopify supportano Catalog MCP?#

Catalog MCP tramite l’Admin API è disponibile con tutti i piani che supportano la creazione di app private, inclusi Plus, Advanced e Grow. L’Admin API in sé non prevede restrizioni legate al piano oltre ai requisiti per la creazione di app personalizzate. Detto questo, gli usi di Catalog MCP con il maggior valore (prezzi B2B, scorte in più sedi, operazioni in blocco su larga scala) si adattano soprattutto ai negozi Plus e Advanced che elaborano almeno 500 ordini al mese.

MCP può scrivere nel mio catalogo Shopify o consente solo la lettura?#

MCP può scrivere nel tuo catalogo Shopify, ma solo se il token API sottostante dispone delle autorizzazioni di scrittura e il server MCP mette a disposizione strumenti di scrittura. È una scelta di progettazione fatta a livello del server MCP, non del protocollo. Molti team iniziano consentendo solo la lettura come misura di sicurezza e aggiungono la scrittura dopo aver verificato a fondo i flussi di lettura. Le operazioni di scrittura più comuni includono aggiornamenti di titoli e descrizioni dei prodotti, modifiche ai prezzi, adeguamenti delle scorte e scrittura dei metafield. Di norma, l’eliminazione viene esclusa intenzionalmente dai server MCP in produzione.

Qual è la differenza tra Catalog MCP e Shopify Flow?#

Shopify Flow automatizza le operazioni in base agli eventi: «quando succede X, fai Y». Catalog MCP offre agli agenti accesso ai dati su richiesta: «ecco una domanda, trova la risposta usando i dati aggiornati del negozio». Risolvono problemi diversi. Flow è ottimo per le automazioni basate su regole (quando le scorte scendono sotto 5, invia un’email all’ufficio acquisti). MCP è più adatto alle operazioni dinamiche che richiedono contesto (esamina 80 prodotti segnalati e individua quelli che necessitano di un aggiornamento del prezzo in base alle regole attuali sui margini). Si completano a vicenda. Il tutorial sulla migrazione a Shopify Functions offre un contesto utile su come i diversi livelli di automazione si integrano nella piattaforma.

Quali autorizzazioni dell’Admin API richiede Catalog MCP?#

Le autorizzazioni minime per usare Catalog MCP in sola lettura sono read_products, read_inventory e read_product_listings. Per le operazioni di scrittura servono write_products e write_inventory. Se la tua implementazione di Catalog MCP accede anche agli ordini, per modificarli servono read_orders e write_orders. Concedi sempre solo le autorizzazioni necessarie, soprattutto per le automazioni gestite dall’AI. I token con autorizzazioni eccessive usati dagli agenti AI creano rischi di sicurezza inutili e difficili da verificare a posteriori.

Catalog MCP può gestire scenari B2B su Shopify?#

Sì, ma Catalog MCP per il B2B richiede Shopify Plus. I listini prezzi specifici per azienda, le assegnazioni dei cataloghi B2B e i sottoinsiemi di prodotti riservati all’ingrosso sono accessibili tramite l’Admin API del piano Plus. Un server MCP configurato con credenziali Plus può verificare quali prodotti rientrano nel catalogo assegnato a un’azienda, controllare i prezzi B2B e supportare agenti AI che assistono direttamente gli acquirenti all’ingrosso. È l’uso di Catalog MCP con il maggior potenziale per i negozi Plus che gestiscono un canale all’ingrosso importante accanto al negozio DTC.

Quali client AI funzionano con Shopify Catalog MCP?#

Qualsiasi assistente AI che supporta lo standard MCP può collegarsi a un server MCP per il catalogo Shopify. A metà 2026, tra questi ci sono Claude Desktop (Anthropic), GitHub Copilot in VS Code e le installazioni aziendali di GPT-4o configurate per supportare i client MCP. La configurazione è semplice: indichi al client AI l’endpoint del tuo server MCP. Gli strumenti del catalogo esposti dal server diventano funzioni richiamabili nel contesto dell’AI. Una volta distribuito il server, non serve codice personalizzato per integrare l’AI sul lato client.

Le query sui dati del catalogo tramite MCP hanno un costo in termini di prestazioni?#

Sì, rispetto alle chiamate API dirette c’è una latenza aggiuntiva, in genere inferiore a due secondi per le query standard sul catalogo. Il protocollo MCP aggiunge un passaggio tra il client AI, il server MCP e l’API di Shopify. Per le applicazioni della vetrina in tempo reale, dove è essenziale rispondere in meno di un secondo, le chiamate dirette alla Storefront API restano la scelta migliore. Nei flussi operativi in cui un’AI svolge un’analisi in più passaggi sui dati del catalogo (verifiche, revisione dei prezzi, arricchimento), questa latenza è trascurabile rispetto al valore ottenuto. Progetta Catalog MCP per i flussi operativi, non per migliorare i tempi di caricamento delle pagine della vetrina.

Come gestisco la sicurezza del mio server Shopify Catalog MCP?#

Tratta il tuo server MCP come qualsiasi servizio che conserva credenziali dell’Admin API. Usa token di app private con le sole autorizzazioni necessarie, ruota regolarmente le credenziali, registra tutte le chiamate agli strumenti MCP per poterle verificare e non esporre mai l’endpoint del server MCP senza autenticazione. Il protocollo MCP non aggiunge alcuna crittografia oltre a HTTPS. I controlli di accesso del server definiscono il perimetro di sicurezza. Per i negozi Plus che trasmettono tramite MCP prezzi B2B sensibili o dati di prodotti in bozza, questi controlli devono essere un requisito preciso.

Posso usare Catalog MCP per i consigli sui prodotti in tempo reale nella vetrina?#

Sì, ma per questo caso d’uso specifico la Storefront API è più adatta. La Storefront API consente solo la lettura, ha una latenza inferiore per i dati pubblici e non richiede credenziali a livello di amministrazione. Un server MCP collegato alla Storefront API funziona bene per gli agenti AI che rispondono a domande come «ce l’avete nella mia taglia?» o assistono i clienti durante gli acquisti tramite conversazione. Catalog MCP basato sull’Admin API è più adatto ai flussi operativi in cui servono accesso in scrittura, visibilità sui prodotti in bozza o dati sui prezzi B2B. Scegli l’API in base all’uso previsto.

Se Shopify Catalog MCP è nella tua roadmap, ecco cosa fare questa settimana:

1. Verifica gli accessi API attuali. Se hai un’app privata Shopify con credenziali dell’Admin API, hai già la base necessaria. Controlla quali autorizzazioni possiede e quali operazioni di scrittura può eseguire.
2. Inizia con la sola lettura. Cerca su npm pacchetti shopify-mcp-server mantenuti attivamente. Assicurati che le query su prodotti e scorte funzionino in modo affidabile prima di aggiungere operazioni di scrittura. Catalog MCP in sola lettura offre già un grande valore operativo.
3. Definisci con precisione lo schema degli strumenti. Gli strumenti esposti dal server MCP dovrebbero corrispondere alle operazioni di cui il tuo team ha davvero bisogno, senza includere ogni possibile chiamata API. La precisione evita che l’ambito si allarghi e riduce la superficie esposta ai rischi di sicurezza.
4. Fai test con dati reali del catalogo prima di collegare un agente AI con autorizzazioni di scrittura. Verifica che le query restituiscano i risultati attesi, che le sedi delle scorte vengano individuate correttamente e che la lettura dei metafield copra la tua struttura di dati personalizzati.
5. Se le operazioni successive all’acquisto fanno parte del tuo flusso di lavoro AI, verifica se la tua implementazione MCP gestisce i dati degli ordini oltre a quelli del catalogo. Spesso la lettura del catalogo e la modifica degli ordini devono funzionare insieme.

Aggiornato ad agosto 2026. Revize è un’app Shopify che consente ai clienti di modificare autonomamente gli ordini dopo l’acquisto: possono cambiare l’indirizzo di spedizione, sostituire una variante o un prodotto, annullare l’ordine e ottenere un rimborso o un credito negozio prima dell’evasione, senza aprire una richiesta all’assistenza. Scopri come consentire ai clienti di modificare autonomamente i propri ordini Shopify oppure trova Revize sullo Shopify App Store.