Shopify Catalog MCP nel 2026: cosa possono fare gli strumenti ufficiali

Shopify documenta ora due interfacce ufficiali per Catalog MCP: Global Catalog cerca prodotti tra i vari merchant Shopify, mentre Storefront Catalog è limitato a un singolo merchant. Entrambe sfruttano le funzionalità di catalogo dell’Universal Commerce Protocol (UCP) di Shopify e offrono strumenti per la ricerca, la consultazione e la selezione delle varianti dei prodotti. L’interfaccia Catalog MCP documentata è destinata alla ricerca dei prodotti; non espone operazioni di scrittura del catalogo o di gestione degli ordini tipiche di Shopify Admin.

Il 13 ottobre 2026, Shopify ha annunciato anche Shop MCP, che aggiunge funzionalità relative a carrelli, checkout e consultazione degli ordini per utenti autenticati tramite una connessione MCP separata. Ciò modifica il panorama dell’agentic commerce, ma non trasforma Catalog MCP in uno strumento di modifica basato su Admin API.

Risposta rapida: Utilizza Catalog MCP per individuare prodotti e selezionare varianti, avvalendoti del Global Catalog per ricerche trasversali tra più merchant Shopify e dello Storefront Catalog per ricerche all’interno di un singolo negozio. Le funzionalità di checkout e di consultazione degli ordini per utenti autenticati fanno capo ad altre interfacce commerciali, tra cui Shop MCP.

Quali funzionalità offre Shopify Catalog MCP?#

Catalog MCP è un’interfaccia ufficiale di Shopify che consente agli agenti IA di individuare e recuperare informazioni sui prodotti. Il Global Catalog effettua ricerche tra i merchant Shopify idonei, mentre lo Storefront Catalog opera all’interno del negozio di un singolo merchant. Entrambi implementano le funzionalità di catalogo UCP di Shopify e utilizzano i medesimi tre strumenti MCP, differenziandosi tuttavia per ambito di applicazione e campi di risposta in base all’interfaccia.

Il flusso tipico si articola in due fasi. Innanzitutto, search_catalog individua prodotti a partire da una query testuale, un’immagine o identificatori di prodotto, mentre lookup_catalog risolve gli ID noti di prodotti o varianti. Successivamente, get_product restituisce i dettagli del prodotto selezionato, le combinazioni di opzioni disponibili e i link per il checkout. Ciò consente la scoperta dei prodotti e la selezione delle varianti senza dover concedere all’agente un accesso esteso alle Admin API.

Il pacchetto distinto @shopify/dev-mcp è dedicato alla documentazione e agli strumenti per sviluppatori Shopify. È separato sia da Catalog MCP che da Shop MCP; quest’ultimo aggiunge funzionalità relative a carrello, checkout e consultazione degli ordini per utenti autenticati.

Come funziona l’accesso al catalogo Shopify tramite MCP#

Il livello del protocollo: cosa fa MCP#

MCP definisce il modo in cui un client scopre e chiama gli strumenti esposti da un server. UCP definisce la capacità commerciale e la forma delle richieste e delle risposte del catalogo. Nell’attuale Catalog MCP di Shopify, l’agente invia una richiesta all’endpoint di Shopify, include l’URL del suo profilo agente UCP e riceve gli strumenti consentiti dalle funzionalità dichiarate in quel profilo. Questo è un servizio Shopify ospitato; non è necessario creare un server MCP personalizzato semplicemente per richiamare gli strumenti del catalogo documentati.

Il livello API: Admin e Storefront#

Shopify documenta due endpoint Catalog MCP:

• Catalogo globale: https://catalog.shopify.com/api/ucp/mcp effettua ricerche tra i commercianti Shopify.
• Catalogo vetrina: https://{storeDomain}/api/ucp/mcp cerca il negozio di un commerciante.

Entrambi richiedono un profilo agente e non richiedono una chiave API per le richieste standard. Gli strumenti restituiscono i dati di rilevamento del catalogo; non sono un proxy per l’Admin API. Per le modifiche al prodotto o all’ordine, un’app o un’integrazione separata deve utilizzare le API e le autorizzazioni Shopify appropriate. L’accesso al catalogo è limitato, i risultati di ricerca e le immagini dei prodotti non devono essere memorizzati nella cache e alcuni attributi di risposta sono etichettati come dedotti da Shopify e potrebbero essere incompleti o variare in termini di precisione. Leggi la documentazione del catalogo e le linee guida per l’utilizzo di Shopify prima di utilizzare i risultati in un’esperienza rivolta al cliente.

Quali operazioni supporta Shopify Catalog MCP#

Gli strumenti Catalog MCP documentati coprono queste attività:

1. Ricerca per testo: trova prodotti da una richiesta di prodotto in linguaggio naturale.
2. Ricerca per ID immagine o prodotto simile: Il Catalogo globale supporta query di immagini e ID prodotto per l’individuazione di somiglianze.
3. Filtrare i risultati del rilevamento: utilizza i filtri supportati come disponibilità, prezzo, destinazione o origine della spedizione e attributi del prodotto.
4. Cerca ID conosciuti: recupera i dati correnti del catalogo del prodotto o delle varianti; una ricerca nel catalogo globale può risolvere fino a 50 identificatori, mentre il Storefront Catalog ne supporta fino a 10.
5. Ispeziona un prodotto: get_product restituisce i dettagli completi per un prodotto, comprese le combinazioni di opzioni e i segnali di disponibilità.
6. Perfeziona la scelta di una variante: passa le opzioni selezionate, come colore o taglia, per trovare la variante corrispondente e il relativo link di pagamento.
7. Cerca all’interno o all’interno di un negozio: scegli Catalogo globale per la scoperta di più commercianti o Catalogo vetrina per il set di prodotti di un singolo commerciante.

Queste sono funzioni di scoperta. Gli strumenti del catalogo non aggiornano i prezzi dei prodotti, non scrivono metacampi, non modificano l’inventario, non modificano gli ordini né eseguono il pagamento.

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

Catalog MCP può aiutare un agente a trovare un prodotto o a ispezionarne le opzioni elencate, ma non legge gli ordini Shopify né esegue modifiche post-acquisto. Mantieni queste responsabilità separate: utilizza gli strumenti agente documentati di Shopify per la scoperta dei prodotti e utilizza un’app di gestione degli ordini o un’integrazione con ambito adeguato per le modifiche degli ordini.

L’app di modifica degli ordini dei clienti di Revize fornisce modifiche self-service prima dell’evasione, all’interno di una finestra di modifica impostata dal commerciante. Il commerciante sceglie le azioni disponibili; il cliente modifica tramite il blocco dell’app Revize abilitato nello stato dell’ordine Shopify o nella pagina di ringraziamento oppure tramite il collegamento Edit Order nell’e-mail di conferma. Revize convalida l’inventario attivo per gli scambi di varianti. Una finestra temporale da sola non garantisce l’evasione; il commerciante deve configurare la modalità e le regole di attesa appropriate. Consulta la Guida alla modifica degli ordini di Shopify per l’editor degli ordini nativo.

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

Gli attuali strumenti agente di Shopify hanno ruoli distinti:

• Catalog MCP: ricerca di prodotti, ricerca, dettagli e scoperta di varianti tramite il catalogo globale o del negozio.
• Shop MCP: un server MCP separato annunciato il 13 ottobre 2026. Può eseguire ricerche nel catalogo, creare carrelli, creare checkout nei negozi Shopify, completare il checkout Shop Pay dopo la conferma dell’acquirente e trovare ordini per un acquirente che ha effettuato l’accesso. Al momento del lancio, lo stato dell’ordine viene controllato tramite il polling get_checkout; le note di rilascio dicono che i webhook non sono ancora disponibili.
• Shopify dev MCP: documentazione e strumenti per gli sviluppatori, anziché catalogo del commerciante o azioni di gestione degli ordini.

Per la configurazione, segui la guida al catalogo attuale di Shopify o le Note sulla versione di Shop MCP. Non dare per scontato che uno strumento descritto per un server sia disponibile tramite un altro.

Lista di controllo per l’implementazione#

Se stai valutando il Shopify Catalog MCP:

1. Decidi se l’agente ha bisogno della ricerca tra commercianti o del catalogo di un negozio.
2. Leggi le istruzioni di configurazione dell’endpoint e del profilo agente pertinenti.
3. Prova la ricerca, la ricerca e la selezione delle varianti con richieste reali, comprese opzioni non disponibili o ambigue.
4. Rispettare i limiti di velocità e le regole contro la memorizzazione nella cache di risultati e immagini.
5. Mantieni la scoperta dei prodotti, il checkout e la modifica degli ordini post-acquisto assegnati agli strumenti che supportano esplicitamente ciascuna attività.

Domande frequenti#

Catalog MCP è un prodotto specifico di Shopify?#

Sì. La Global Catalog MCP di Shopify effettua ricerche tra i commercianti idonei, mentre la Catalog MCP Storefront è limitata a un solo commerciante. Il server @shopify/dev-mcp incentrato sugli sviluppatori è un prodotto separato.

Che cos’è esattamente il Model Context Protocol?#

MCP è un protocollo che consente a un client AI di scoprire e chiamare strumenti esposti da un server. Nell’implementazione del catalogo di Shopify, UCP definisce la funzionalità del catalogo commerciale e il formato di richiesta/risposta trasportato tramite MCP.

Mi serve uno sviluppatore per configurare Shopify Catalog MCP?#

Hai bisogno di un client compatibile con MCP e di un profilo agente, quindi configura l’endpoint del Shopify Catalog pertinente. Shopify ospita il server del catalogo documentato, quindi per questi strumenti non è richiesto un server MCP personalizzato. Un comportamento più avanzato dell’agente potrebbe richiedere lavoro di sviluppo.

Quali piani Shopify supportano Catalog MCP?#

La documentazione del catalogo descrive gli endpoint e l’autenticazione del profilo agente anziché una matrice a livello di piano. Controlla la documentazione attuale di Shopify e l’idoneità del tuo negozio per il catalogo specifico o la funzionalità dell’agenzia che desideri utilizzare.

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

No. Catalog MCP espone strumenti di rilevamento del prodotto, non operazioni di scrittura del prodotto o di modifica dell’ordine. Shop MCP è separato e aggiunge carrello, checkout e ricerca dell’ordine registrato. Le modifiche all’Admin API richiedono un’app o un’integrazione autorizzata separatamente.

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

Flow esegue flussi di lavoro basati sugli eventi in Shopify Admin. Catalog MCP consente a un agente di chiamare strumenti di rilevamento del prodotto su richiesta. Possono completarsi a vicenda, ma Catalog MCP non attiva o esegue di per sé un flusso di lavoro Flow.

Quali autorizzazioni dell’Admin API richiede Catalog MCP?#

Gli endpoint Catalog MCP ospitato utilizzano un profilo agente e non richiedono un token Admin API o una chiave API per le richieste standard. Se la tua integrazione separata utilizza operazioni Admin API, richiedi solo gli ambiti necessari per tale integrazione.

Catalog MCP può gestire scenari B2B su Shopify?#

Gli strumenti Catalog MCP sono documentati per l’individuazione del prodotto. Non espongono incarichi aziendali o un flusso di lavoro completo degli ordini B2B. Verifica il catalogo B2B attuale e il supporto dei prezzi nell’API o nella funzionalità dell’agente che prevedi di utilizzare; non dare per scontato che i dati dell’Admin API solo Plus siano esposti tramite Catalog MCP.

Quali client AI funzionano con Shopify Catalog MCP?#

Utilizzare un client compatibile con MCP in grado di connettersi all’endpoint pertinente e fornire un profilo agente. Le note sulla versione di Shop MCP del 13 ottobre di Shopify descrivono i flussi di accesso per i client MCP come Claude e ChatGPT; il supporto e il comportamento dipendono dal cliente.

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

Shopify non pubblica una garanzia di tempo di risposta fisso per il catalogo MCP nella documentazione citata. La latenza dipende dal client, dalla richiesta e dalle condizioni del servizio. Rispettare i limiti di velocità e non memorizzare nella cache i risultati della ricerca nel catalogo.

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

Utilizza il profilo agente richiesto, mantieni protetta la configurazione del tuo cliente, segui le regole di utilizzo e di assenza di cache di Shopify ed esamina quali informazioni sul prodotto vengono visualizzate dal tuo agente. Catalog MCP non utilizza un token Admin API per le richieste standard; altre integrazioni potrebbero avere credenziali e controlli di accesso separati.

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

Catalog MCP è progettato per la scoperta dei prodotti guidata dall’agente e la selezione delle varianti. Restituisce i dati del prodotto e i collegamenti al pagamento; Shopify non lo documenta come API della pagina della vetrina a bassa latenza. Per un’esperienza di vetrina personalizzata, scegli l’interfaccia che si adatta ai requisiti di prestazioni e presentazione.

Lettura correlata#

Statistiche di modifica degli ordini Shopify · Guida agli endpoint Shopify MCP e UCP · Guida per sviluppatori Universal Commerce Protocol · Guida Shopify AI Toolkit · Gestione degli ordini Shopify guida · Guida alla cancellazione del cliente Shopify · Come vendere su ChatGPT con le vetrine degli agenti Shopify · Tutorial sulla migrazione delle Shopify Functions · Come consentire ai clienti di modificare Shopify ordini