In questa pagina
Shopify AI Toolkit è un set di strumenti per sviluppatori; L’Universal Commerce Protocol (UCP) di Shopify e gli endpoint commerciali sono parti correlate ma separate della piattaforma. Questa guida descrive l’attuale toolkit, gli endpoint UCP nella documentazione per gli sviluppatori di Shopify e cosa fanno queste interfacce per gli operatori dei negozi. L’analisi di Revize ha rilevato che il 5,2% degli ordini viene modificato dopo il checkout (Revize, 2026); questo è il contesto per le operazioni post-acquisto, non un reclamo sugli ordini AI.
Il toolkit può aiutare gli sviluppatori a trovare la documentazione corrente di Shopify e le indicazioni API dagli strumenti di codifica AI supportati. I commercianti dovrebbero valutare le integrazioni commerciali in base alle proprie esigenze, alla documentazione attuale degli endpoint di Shopify e al comportamento di ciascun fornitore di agenti. Questa guida si concentra su quelle parti verificabili.
Che cos’è Shopify AI Toolkit?
L’AI Toolkit di Shopify fornisce un plug-in, competenze dell’agente e un server Dev MCP locale per gli strumenti di sviluppo AI supportati. Shopify attualmente elenca Claude Code, Codex, Antigravity CLI, Cursor, OpenClaw, Pi, VS Code e Hermes per il plugin; OpenClaw, Pi e Hermes sono solo plug-in. Controlla la documentazione ufficiale di AI Toolkit per i passaggi di configurazione correnti e gli strumenti supportati. Dev MCP viene eseguito localmente e non richiede l’autenticazione del negozio Shopify per la documentazione e gli strumenti dello schema.
Il Dev MCP locale espone le risorse di sviluppo tramite il Model Context Protocol. Le operazioni del negozio utilizzano un contesto CLI di Shopify autenticato separato; l’installazione di un server di documentazione non autorizza l’accesso al negozio di un commerciante.
Le capacità di sviluppo utili sono concrete:
- Trova la documentazione corrente: identifica la superficie e la versione API corrette prima di generare un’integrazione.
- Esamina gli schemi GraphQL: controlla i nomi dei campi, gli argomenti e i tipi restituiti prima di creare una query o una mutazione.
- Convalida il codice: controlla il codice GraphQL, Liquid e l’estensione generato rispetto agli schemi di Shopify, quindi testa il comportamento di runtime localmente.
- Gestisci un negozio tramite CLI: prepara un’operazione con ambito, autentica il negozio selezionato, esamina la query e le variabili e scegli quando eseguirla. Le mutazioni richiedono un consenso esplicito.
La convalida rileva gli errori dello schema e dei componenti; non dimostra se una modifica si adatta alle regole commerciali del commerciante. Esaminare la differenza, le autorizzazioni richieste e l’archivio di destinazione prima dell’esecuzione.
Superfici MCP e UCP Commerce di Shopify
I documenti Shopify separano le superfici commerciali per la scoperta del catalogo, il pagamento e l’accesso agli ordini. Hanno modelli di endpoint, autenticazione e operazioni distinti; nessuno dovrebbe essere trattato come un’interfaccia agente universale.
1. Catalogo del negozio tramite UCP
L’endpoint del catalogo specifico del negozio di Shopify è https://{shop}.myshopify.com/api/ucp/mcp, con search_catalog, lookup_catalog e get_product e un profilo agente in meta.ucp-agent.profile. La Guida alla migrazione di Storefront MCP sposta gli strumenti del catalogo/carrello su UCP ma lascia search_shop_policies_and_faqs su /api/mcp. Utilizzare il riferimento Storefront Catalog per il contratto di rilevamento.
Non dare per scontato che questo endpoint copra il checkout o le modifiche agli ordini. Shopify documenta il check-out e gli ordini come agenti separati con la propria autenticazione, autorizzazioni e operazioni supportate.
2. Catalogo globale
Shopify documenta un endpoint del catalogo globale su https://catalog.shopify.com/api/ucp/mcp per la scoperta del catalogo su Shopify. I suoi strumenti e i requisiti di accesso differiscono dall’endpoint del catalogo specifico del negozio di un commerciante. Consulta la panoramica del catalogo agenti di Shopify prima della creazione; non riutilizzare il vecchio endpoint MCP Storefront o esempi di strumenti.
3. Order MCP: accesso agli ordini originati dall’agente
L’Order MCP di Shopify attualmente documenta uno strumento get_order per recuperare lo stato attuale degli ordini originati dall’agente. Non è un accesso generale all’intera cronologia degli ordini di un cliente e non modifica gli ordini. Lo strumento richiede le autorizzazioni di accesso all’ordine e del profilo agente pertinenti. Leggi la documentazione dell’ordine MCP di Shopify prima di fare affidamento su di essa per un flusso di lavoro.
Shopify documenta inoltre funzionalità di pagamento separate tramite Checkout MCP. È richiesta l’autenticazione o una richiesta firmata e il flusso può consentire all’acquirente di rivedere o completare il pagamento. Consultare la documentazione Checkout MCP per il contratto in corso.
4. Account cliente MCP: richieste dei clienti autenticate
Account cliente MCP rimane supportato. Scopri da mcp_api a https://{shop}/.well-known/customer-account-api; il suo modello di endpoint è https://{shop}/customer/api/mcp. Il codice di autorizzazione OAuth con PKCE garantisce l’accesso specifico del cliente ai dettagli dell’ordine, allo stato e alle preferenze dell’account in quel negozio. L’app richiede la configurazione dell’autenticazione del cliente, un dominio personalizzato e l’accesso protetto ai dati del cliente. Utilizza tools/list per scoprire le operazioni supportate. Questo è distinto dall’ambito dell’ordine originato dall’agente di Order MCP; nessuno dei due nomi implica modifiche arbitrarie dell’ordine.
| Superficie | A cosa serve | Documentazione attuale |
|---|---|---|
| Shopify AI Toolkit / Dev MCP | Documentazione per gli sviluppatori e strumenti dello schema | Kit di strumenti per l’intelligenza artificiale |
| Catalogo vetrina | Scoperta del prodotto di un commerciante | Catalogo vetrina |
| Politiche e domande frequenti | Domande pubbliche sulle politiche di un commerciante | Strumento norme e domande frequenti — /api/mcp |
| Catalogo globale | Scoperta del catalogo su Shopify | Panoramica del catalogo agenti |
| Acquista MCP | Sessione di pagamento e passaggio di consegne all’acquirente | Acquista MCP |
| Order MCP | Leggi lo stato degli ordini originati dall’agente supportati | Order MCP |
| Conti cliente MCP | Richieste di ordine e account autorizzate dal cliente | MCP account cliente — /customer/api/mcp, OAuth PKCE |
Universal Commerce Protocol (UCP): il livello alla base degli altri
Shopify descrive UCP come un protocollo commerciale aperto per le interazioni tra agenti, commercianti, fornitori di pagamenti e fornitori di credenziali. La sua documentazione specifica i flussi di rilevamento, checkout e relativi agli ordini. Le implementazioni hanno ancora endpoint, formati di richiesta, autenticazione e autorizzazioni distinti; un’etichetta UCP non significa che ogni client possa chiamare ogni strumento. Consulta la documentazione dei profili agente di Shopify e i riferimenti specifici dell’endpoint prima di implementare un flusso.
Le principali aree del protocollo includono:
- Individuazione del catalogo: trova prodotti e recupera i dettagli dei prodotti supportati tramite gli endpoint del catalogo documentati.
- Pagamento: crea o continua il pagamento attraverso il flusso di pagamento documentato, che potrebbe richiedere l’autenticazione o il trasferimento da parte dell’acquirente.
- Accesso agli ordini: recupera le informazioni sugli ordini supportati nel profilo documentato e nelle regole di accesso; ciò non implica che un agente possa modificare o rimborsare un ordine.
Per i commercianti, conferma se l’endpoint del catalogo Shopify pertinente è disponibile e configurato per il tuo negozio. L’esistenza di un endpoint non garantisce che un particolare prodotto AI lo utilizzerà o farà emergere ogni elemento. Consulta la nostra Guida per sviluppatori Universal Commerce Protocol e la documentazione attuale dell’endpoint, quindi esegui il test con il cliente che intendi supportare.
Cosa possono verificare ora i commercianti
1. Il traffico di ricerca AI è in crescita, ma ciò non prova che sia stato causato da MCP. Shopify ha riferito nel giugno 2026 che gli ordini provenienti dalla ricerca AI sono aumentati di 13 volte anno su anno, con una conversione più alta del 49% e un valore medio degli ordini più alto del 14%. Si tratta di dati di ricerca AI riportati da Shopify, non di previsioni per ogni commerciante o di prove che uno specifico endpoint MCP abbia generato gli ordini. Consulta l’aggiornamento di giugno 2026 di Shopify.
2. Controlla l’effettivo flusso di lavoro post-acquisto. La Order MCP documentata di Shopify è in grado di leggere le informazioni sugli ordini originati dall’agente supportati; non modifica gli ordini. I commercianti dovrebbero verificare il proprio percorso rivolto al cliente per correggere gli ordini idonei piuttosto che presumere che sia coperto da un endpoint dell’agente.
3. Mantieni accurate le informazioni sui prodotti. Titoli, opzioni, disponibilità e policy chiari aiutano i clienti e i sistemi commerciali a interpretare un catalogo. Misura i risultati nel tuo negozio anziché assumere che un particolare formato di dati garantisca il posizionamento o la conversione.
Come usare l’AI Toolkit se sviluppi app o lavori in un’agenzia
Inizia con un’attività di sviluppo: ispeziona lo schema, genera una query, convalidala ed esamina il risultato in un archivio di sviluppo.
Installa il plug-in Shopify per il tuo cliente supportato oppure segui la competenza documentata o il percorso di installazione di Dev MCP. I plugin si aggiornano automaticamente; le competenze installate manualmente richiedono aggiornamenti. Segui le istruzioni di configurazione per il client che usi effettivamente.
Per la gestione del negozio, autenticarsi con Shopify CLI utilizzando solo gli ambiti necessari. Il comando di esecuzione dell’archivio esegue un’operazione Admin GraphQL rivista rispetto all’autenticazione archiviata. Ad esempio, questo legge i primi dieci prodotti di un development store:
shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'Sostituisci il segnaposto con il tuo archivio di sviluppo. Legge il lavoro senza abilitare le mutazioni; le scritture richiedono --allow-mutations e gli ambiti corrispondenti. Esamina la mutazione completa e le variabili prima di aderire, verifica il negozio di destinazione e testa il comportamento previsto prima di una modifica alla produzione.
Come attivare gli acquisti tramite agenti nel tuo negozio
Se intendi sviluppare un’integrazione che utilizzi un endpoint del catalogo Shopify, segui il formato attuale delle richieste Storefront Catalog, incluso meta.ucp-agent.profile. Una ricerca di prodotti riuscita non dimostra che siano disponibili il checkout o l’accesso agli ordini. La nostra guida a Shopify Catalog MCP spiega gli strumenti di scoperta e i relativi limiti.
Per un agente con marchio, utilizza gli attuali progetti di esempio di Shopify e la documentazione di pagamento specifica dell’endpoint. Pianificare un’implementazione graduale in base ai requisiti di catalogo, autenticazione, pagamento e supporto; un progetto di esempio non è una checklist di integrazione della produzione. Testa i dettagli del prodotto visibili al cliente e i trasferimenti di cassa prima del lancio.
Il ruolo dell’infrastruttura dopo l’acquisto in uno stack basato su agenti
La scoperta dei prodotti, il checkout, il monitoraggio degli ordini e le modifiche dei clienti necessitano delle proprie interfacce supportate. La nostra Guida agli endpoint Shopify MCP e UCP mappa tali responsabilità.
Documenti Shopify Order MCP come superficie di lettura per ordini originati da agenti supportati, con webhook per ordini UCP per gli aggiornamenti del ciclo di vita. Non fornisce un flusso generale di modifica degli ordini. Revize offre un portale rivolto al cliente per modifiche idonee di indirizzo, variante, quantità e annullamento prima dell’evasione, soggetto alla finestra di modifica configurata dal commerciante. Aggiunte di prodotti, cambio di prodotti, applicazione di sconti e rimborsi di crediti in negozio sono funzionalità Pro. La modifica degli ordini da parte dello staff è in fase di sviluppo. Il portale richiede il blocco dell’app Revize nella pagina di stato dell’ordine e può essere aperto anche dal collegamento e-mail Edit Order. Vedi Revize sull’Shopify App Store per i dettagli del prodotto.
Domande frequenti
Che cos’è Shopify AI Toolkit in una frase?
L’AI Toolkit di Shopify è un insieme di strumenti per sviluppatori, tra cui un plug-in, competenze dell’agente e un server Dev MCP locale. Gli endpoint dell’agente commerciale di Shopify e l’UCP sono documentati separatamente.
Shopify AI Toolkit è gratuito?
La documentazione di AI Toolkit di Shopify non elenca un prezzo di abbonamento al toolkit separato. Controlla i termini attuali del piano Shopify, del client AI, dell’app e degli endpoint per eventuali addebiti o requisiti dell’account.
Il mio negozio deve avere Shopify Plus per usare MCP?
Non dare per scontato che ogni endpoint o funzionalità dell’agente sia disponibile su ogni piano. Controlla l’attuale endpoint Shopify e pianifica la documentazione per il tuo negozio e l’integrazione specifica.
Qual è la differenza tra il Storefront Catalog e il catalogo globale?
L’attuale endpoint del catalogo specifico del negozio di Shopify è documentato in /api/ucp/mcp; Il catalogo globale ha un endpoint separato. I loro strumenti e i requisiti di richiesta differiscono. Consulta la panoramica del catalogo di Shopify.
Che cos’è Universal Commerce Protocol?
UCP è un protocollo commerciale aperto descritto nella documentazione per gli sviluppatori di Shopify. Leggi le specifiche attuali e i documenti specifici dell’endpoint prima di dare per scontato che un’altra piattaforma o agente supporti lo stesso flusso.
ChatGPT, Claude e Gemini useranno tutti i server MCP di Shopify?
Le integrazioni del fornitore cambiano in modo indipendente. Controlla la documentazione attuale di ciascun fornitore e non dare per scontato che ChatGPT, Claude o Gemini supporti ogni endpoint o strumento Shopify UCP.
Attivare gli acquisti tramite agenti riduce il tasso di conversione?
Non esiste un effetto universale. Misura la conversione, il completamento del pagamento e i contatti di supporto per il canale specifico e il percorso del cliente che abiliti.
Come gestisce Shopify AI Toolkit la riservatezza dei dati dei clienti?
Consulta la documentazione attuale su privacy, autenticazione e gestione dei dati di Shopify e del fornitore di intelligenza artificiale per ogni strumento che utilizzi. I requisiti dipendono dall’endpoint, dal client e dalle informazioni richieste; non dare per scontato che tutte le chiamate siano locali o non contengano dati personali.
L’agente di un concorrente può effettuare transazioni nel mio negozio tramite MCP?
L’accesso dell’agente dipende dall’endpoint, dal profilo dell’agente, dall’autenticazione e dagli attuali controlli Shopify. Rivedi la documentazione Shopify pertinente e le tue impostazioni di accesso prima di abilitare un flusso di lavoro di terze parti; non dare per scontato che solo la compatibilità del protocollo garantisca l’accesso al pagamento.
Devo fare qualcosa affinché il mio negozio compaia nei risultati di ricerca degli agenti?
Mantieni le informazioni sul prodotto accurate e complete, quindi controlla l’idoneità e le regole di scoperta per il canale che desideri utilizzare. Shopify non promette che qualsiasi modifica del contenuto farà apparire un articolo nei risultati di un agente.
Qual è il rapporto tra AI Toolkit e Shopify Functions?
Shopify Functions e AI Toolkit hanno scopi diversi. Le funzioni implementano la logica commerciale supportata; il toolkit assiste gli sviluppatori. Controlla la documentazione dell’endpoint e delle funzioni per verificare come un’integrazione specifica interagisce con la tua configurazione. Il nostro tutorial sulla migrazione di Shopify Functions copre il flusso di lavoro di sviluppo.
Come posso capire cosa sta facendo un agente nel mio negozio?
Utilizza i log, la diagnostica e l’osservabilità documentati per l’endpoint e il client Shopify specifici. Un agente di terze parti può esporre separatamente i propri registri di conversazione; conferma cosa registra la tua integrazione e come vengono gestiti tali dati.
Lettura correlata
Statistiche di modifica degli ordini Shopify · Come vendere su ChatGPT con le vetrine degli agenti Shopify · Come consentire ai clienti di modificare gli ordini Shopify