In questa pagina
L’Universal Commerce Protocol (UCP) è un protocollo aperto con versione per il commercio tramite agenti. L’attuale implementazione di Shopify espone server MCP conformi a UCP per la ricerca nel catalogo, i carrelli, il checkout e i flussi di lavoro degli ordini. UCP è oggi disponibile per gli sviluppatori, ma un protocollo aperto non significa che ogni agente o commerciante supporti ogni funzionalità.
Il quadro generale: cosa è cambiato?
UCP è stato annunciato da Shopify e Google l’11 gennaio 2026. Il protocollo continua ad evolversi; L’attuale documentazione dell’agente di Shopify utilizza gli esempi di profilo agente 2026-08-25. Il 13 ottobre 2026, Shopify ha anche annunciato Shop MCP, che consente agli agenti compatibili di cercare nel Shopify Catalog, creare carrelli e creare checkout tramite un’unica connessione MCP.
Per gli sviluppatori Shopify, la questione pratica è quale flusso di lavoro attuale dell’agente è necessario supportare: scoperta del prodotto, creazione del carrello, trasferimento alla cassa o monitoraggio degli ordini. Controlla gli strumenti e le autorizzazioni supportati nella documentazione di Shopify prima di promettere una funzionalità ai commercianti.
Che cos’è esattamente UCP?
UCP è un protocollo aperto che descrive il modo in cui le applicazioni degli agenti e i sistemi commerciali possono scambiare informazioni ed eseguire azioni commerciali definite. È basato su versioni e capacità: un’integrazione pubblicizza ciò che supporta e un agente dovrebbe utilizzare solo quelle funzionalità.
Shopify implementa UCP tramite endpoint e strumenti MCP. A seconda dell’endpoint e delle autorizzazioni, gli sviluppatori possono lavorare con l’individuazione del catalogo, i carrelli, il checkout o le informazioni sugli ordini. Si tratta di flussi di lavoro distinti e il supporto per uno non implica il supporto per tutte le altre funzionalità UCP.
Ruoli in un flusso commerciale di agenti
- Agente o applicazione: aiuta l’acquirente a trovare prodotti, creare un carrello o proseguire con il pagamento.
- Sistema del commerciante: fornisce informazioni sul prodotto e sul pagamento ed elabora l’ordine attraverso la superficie Shopify supportata.
- Fornitore di credenziali: fornisce credenziali o token di pagamento attraverso il metodo di pagamento negoziato per il flusso.
- Servizio di pagamento: gestisce il pagamento tramite il checkout o il metodo di pagamento disponibile in quel flusso.
- Acquirente: esamina e autorizza l’acquisto. Seguire i requisiti di conferma e autorizzazione del flusso.
Il problema: perché il commercio aveva bisogno di un protocollo
Oggi il commercio è estremamente frammentato.
Considera cosa succede quando un cliente vuole acquistare qualcosa tramite un assistente AI:
- L’intelligenza artificiale deve trovare informazioni sui prodotti nei cataloghi dei commercianti
- Deve comprendere disponibilità, prezzi e opzioni di spedizione in tempo reale
- Deve gestire programmi fedeltà, codici sconto e preferenze di abbonamento
- Deve raccogliere informazioni di pagamento in modo sicuro
- È necessario completare il pagamento con tutti i requisiti specifici del commerciante
- Infine, deve supportare tracciamento degli ordini, resi e servizio clienti
Le integrazioni personalizzate aggiungono lavoro di manutenzione. UCP fornisce schemi condivisi e negoziazione di capacità che possono ridurre tale lavoro, ma due implementazioni necessitano ancora di versioni, funzionalità, autenticazione e gestori dei pagamenti compatibili. La sola compatibilità del protocollo non garantisce che un agente possa completare un acquisto.
Capacità UCP da comprendere innanzitutto
Il checkout, il collegamento dell’identità e lo stato dell’ordine sono utili punti di partenza nella specifica UCP. Shopify documenta anche le funzionalità del catalogo e del carrello. Ogni superficie implementa il proprio set supportato; controllare il profilo negoziato prima di chiamare uno strumento.
1. Checkout
Checkout crea e aggiorna una sessione di acquisto, inclusi gli articoli, i dettagli dell’acquirente, i totali e il gestore dei pagamenti. Il commerciante rimane il commerciante registrato. Il flusso standard indirizza l’acquirente a un’interfaccia affidabile per confermare il pagamento; il completamento autonomo dipende dalle estensioni autorizzative supportate e dalla specifica integrazione.
2. Collegamento dell’identità
Il collegamento dell’identità utilizza OAuth 2.0 per consentire a un acquirente di autorizzare un agente ad agire per suo conto. Può supportare funzionalità specifiche dell’account come indirizzi salvati o cronologia degli ordini. La ricerca nel catalogo pubblico può funzionare senza collegare un’identità, quindi l’autorizzazione è una capacità e una decisione di autorizzazione separate.
3. Ordine
La funzionalità Ordine condivide lo stato dell’ordine e gli eventi del ciclo di vita come evasione, resi e rimborsi. Non è un’API di modifica degli ordini generica. L’attuale Order MCP di Shopify e le API di modifica richieste dall’acquirente hanno i propri ambiti e limiti documentati, descritti di seguito.
L’architettura tecnica: progettata per evolvere
UCP utilizza i profili per dichiarare una versione del protocollo e le funzionalità supportate. Le aziende e gli agenti negoziano le capacità che hanno in comune per una sessione; l’agente dovrebbe utilizzare solo il set negoziato. Gli esempi di Shopify utilizzano profili con versione in base alla data, quindi gli sviluppatori dovrebbero copiare il profilo e lo schema attuali dai documenti live anziché da un vecchio esempio.
Le estensioni aggiungono dettagli facoltativi a una funzionalità di base, come evasione ordini o sconti. Un’azienda può esporre il flusso di pagamento di base senza ogni estensione e un agente deve verificare quali estensioni sono supportate dall’altra parte prima di fare affidamento su di esse. Consulta la panoramica UCP e la guida al profilo agente di Shopify.
Progettato per l’interoperabilità
UCP è progettato per funzionare con collegamenti di protocollo come REST, MCP e A2A. Ciò descrive lo standard UCP più ampio, non una promessa che un’implementazione di Shopify esponga tutte le funzionalità su ogni trasporto.
L’attuale documentazione per gli sviluppatori di Shopify descrive i server MCP conformi a UCP e i relativi strumenti supportati. Per un’integrazione, verifica l’endpoint esatto, il metodo di autenticazione, la versione del profilo e la conferma dell’acquirente richiesta. Non dedurre che una funzionalità elencata nella specifica UCP sia già disponibile tramite una particolare superficie Shopify MCP.
Le attuali superfici UCP e MCP di Shopify
La documentazione dell’agente di Shopify descrive diverse superfici distinte:
Scoperta del catalogo
Gli strumenti Catalog MCP consentono a un agente di effettuare ricerche nel Shopify Catalog e recuperare i dettagli del prodotto. Il Global Catalog MCP di Shopify utilizza https://catalog.shopify.com/api/ucp/mcp; Shop MCP è disponibile all’indirizzo https://mcp.shop.com ed espone la ricerca nel catalogo e gli strumenti di prodotto. La visibilità e i risultati del catalogo dipendono dai dati attuali del prodotto e dalla superficie utilizzata.
Costruzione del carrello e cassa
Carrello MCP può creare e aggiornare un carrello. Checkout MCP può creare e gestire una sessione di pagamento, quindi indirizzare l’acquirente alla vetrina del commerciante per completare i passaggi che richiedono l’acquirente. Shopify documenta Checkout MCP come approccio lato server consigliato; Checkout WebMCP è destinato a un agente già operativo nel browser dell’acquirente. Alcuni tipi di pagamento e interazioni definite dall’app non sono gestiti dagli strumenti del browser.
Shop MCP è una connessione separata che può eseguire ricerche nel Shopify Catalog, creare carrelli e creare il pagamento Shop Pay. Ciò non significa che ogni commerciante sia automaticamente disponibile in ogni app AI.
Informazioni sull’ordine
L’Ordine MCP di Shopify legge lo stato attuale degli ordini effettuati tramite l’agente, inclusi l’evasione e gli aggiustamenti post-acquisto. Il suo strumento get_order serve per le visualizzazioni e la riconciliazione richieste dall’acquirente. Webhook ordini UCP forniscono istantanee in corso dopo il commit delle modifiche; un Partner Manager di Shopify deve registrare l’endpoint di consegna. Questo canale di lettura/aggiornamento non esegue modifiche arbitrarie dell’ordine.
Separatamente, le API di modifica degli ordini richieste dagli acquirenti di Shopify del 1° ottobre 2026 consentono agli acquirenti di richiedere la rimozione di articoli dell’ordine inevasi; un commerciante o un’app può esaminare, risolvere o rifiutare una richiesta. Questo ristretto flusso di richieste non equivale a modificare un indirizzo o scambiare un prodotto.
Cosa cambia per i commercianti Shopify
Gli strumenti per agenti di Shopify possono rendere disponibili i flussi di lavoro dei prodotti e del pagamento agli agenti compatibili. L’esperienza dipende dalla superficie utilizzata dall’agente, dalle funzionalità abilitate per il negozio e dall’autorizzazione dell’acquirente. Mantieni accurati i dettagli del prodotto, la disponibilità e le politiche e conferma quali canali sono abilitati per il tuo negozio.
Trattalo come una superficie di integrazione, non come una garanzia di posizionamento universale dell’IA o di accesso a ogni commerciante. La panoramica delle vetrine degli agenti di Shopify spiega la disponibilità del canale e il checkout dei referral ChatGPT standard.
Cosa cambia per chi sviluppa app per Shopify
Gli strumenti MCP di UCP e Shopify offrono agli sviluppatori di app interfacce definite su cui basarsi. Prima di iniziare, identifica l’attività dell’acquirente, l’endpoint Shopify, il profilo dell’agente e gli ambiti richiesti e il punto in cui l’acquirente deve rivedere o confermare un’azione.
Sviluppa in base alle funzionalità supportate
Utilizza i documenti e i tutorial attuali degli agenti di Shopify per il rilevamento degli endpoint, l’autenticazione, gli strumenti di carrello e pagamento e il monitoraggio degli ordini. Evitare di dare per scontato che un’app di terze parti possa esporre le proprie funzioni a un agente semplicemente perché UCP supporta le estensioni; verificare che la superficie dell’app e la funzionalità del protocollo siano implementate.
Mantieni la modifica degli ordini separata
Order MCP di Shopify copre le informazioni sugli ordini e i flussi di lavoro del ciclo di vita. Non apporta modifiche arbitrarie come cambi di indirizzo o scambi di prodotti. Le API di modifica degli ordini richieste dall’acquirente annunciate il 1° ottobre 2026 sono limitate alle richieste di rimozione di articoli dell’ordine inevasi, con revisione del commerciante o dell’app. Per altre modifiche del cliente successive all’acquisto, verifica le funzionalità e le autorizzazioni attuali dell’app separata.
Cosa cambia per le agenzie
Le agenzie possono aiutare i commercianti a preparare i dati di prodotto e la configurazione del pagamento per le superfici degli agenti che scelgono di supportare. Inizia con la documentazione Shopify corrente, il piano effettivo del commerciante, la configurazione dell’app, i dati del prodotto e il percorso dell’acquirente. Tratta la disponibilità, la portata dei clienti e i risultati delle conversioni come domande da misurare per ciascun commerciante piuttosto che come garanzie di protocollo.
UCP insieme ad altri protocolli di commercio tramite agenti
UCP e Agentic Commerce Protocol (ACP) sono protocolli separati. Definiscono interfacce e flussi di lavoro diversi, quindi gli sviluppatori non dovrebbero dare per scontato che un’integrazione UCP funzioni automaticamente con ACP o viceversa. Esamina le specifiche attuali e crea solo per le superfici degli agenti che il tuo prodotto intende supportare.
Il bridge in questa illustrazione rappresenta il lavoro di integrazione da valutare, piuttosto che una funzionalità di interoperabilità Shopify fornita.
Da dove iniziare: guida pratica all’implementazione
Utilizza l’attuale documentazione commerciale dell’agente di Shopify come punto di partenza. Include le attuali superfici Shopify MCP, esempi di profili UCP, dettagli di autenticazione e tutorial. Shopify consiglia la guida rapida AI Toolkit per una configurazione guidata; gli sviluppatori possono anche seguire i singoli tutorial.
Passaggio 1: identificare l’attività dell’acquirente
Decidi se la tua applicazione deve cercare prodotti, creare un carrello, creare o aggiornare il pagamento o leggere le informazioni sul ciclo di vita dell’ordine. Queste attività utilizzano strumenti e ambiti diversi.
Passaggio 2: segui l’attuale guida Shopify
Utilizza il profilo agente corrente e gli esempi API dai documenti di Shopify. Non copiare un vecchio endpoint, una versione del profilo, un repository di esempio o un URL del parco giochi senza verificare che sia ancora documentato.
Passaggio 3: testa l’intero percorso dell’acquirente
Utilizza un negozio di sviluppo e verifica l’autenticazione, i messaggi e gli stati restituiti, il trasferimento del pagamento e la conferma dell’acquirente richiesta. Testa l’esatto tipo di ordine o pagamento che prevedi di supportare; Shopify documenta i casi che gli strumenti di pagamento del browser non gestiscono.
Passaggio 4: limita l’integrazione alle funzionalità verificate
Dichiarare e richiedere solo gli ambiti necessari per il flusso di lavoro. Rendi chiari i passaggi non supportati o di conferma dell’acquirente e verifica il comportamento attuale prima della distribuzione in produzione.
Cosa arriverà
La documentazione pubblicata di Shopify attualmente copre la scoperta del catalogo, i carrelli, il pagamento e le informazioni sugli ordini attraverso flussi di lavoro MCP separati. Shop MCP aggiunge una connessione per gli agenti compatibili per cercare nel Shopify Catalog, creare carrelli e creare il pagamento Shop Pay. Le future funzionalità del protocollo e le date di implementazione dovrebbero essere trattate come non annunciate finché non compaiono nelle specifiche ufficiali o nel registro delle modifiche di Shopify.
Prima di impegnarti in una roadmap, controlla i documenti attuali di Shopify per il profilo specifico, l’endpoint, gli ambiti e i tipi di ordine o pagamento che utilizzerà la tua integrazione. Gli strumenti disponibili, i requisiti di conferma dell’acquirente e i tipi di pagamento supportati differiscono in base alla superficie e possono cambiare man mano che Shopify aggiorna le sue API.
In sintesi
UCP offre agli sviluppatori un protocollo condiviso e in evoluzione per creare flussi di lavoro commerciali tramite agenti. Gli attuali strumenti di Shopify coprono la scoperta del prodotto, il lavoro del carrello e del checkout e le informazioni sul ciclo di vita dell’ordine, con endpoint, ambiti e limiti separati per ciascuno.
Per i commercianti, controlla quali piattaforme sono abilitate e quale percorso dell’acquirente supportano. Per gli sviluppatori di app e le agenzie, seguire gli attuali documenti Shopify, testare con un negozio di sviluppo ed evitare di insinuare che un’integrazione possa modificare ordini o elencare prodotti su ogni superficie AI a meno che la destinazione non lo supporti.
Domande frequenti
UCP rende ogni app Shopify richiamabile da un agente?
Un’app necessita di un’interfaccia implementata supportata dall’agente di destinazione e dalla superficie Shopify. Dichiarare un’estensione o utilizzare solo uno standard aperto non espone le funzioni dell’app.
Order MCP può modificare un indirizzo o scambiare un prodotto?
Order MCP recupera lo stato degli ordini effettuati tramite l’agente. Le modifiche agli indirizzi e gli scambi di prodotti richiedono un flusso di lavoro separato per la modifica degli ordini. La rimozione degli articoli inevasi richiesta dall’acquirente è una richiesta API distinta esaminata da un commerciante o da un’app.
Come posso ricevere gli aggiornamenti sugli ordini UCP su Shopify?
Organizza la registrazione del webhook tramite il tuo Partner Manager Shopify, gestisci le istantanee degli ordini in entrata e utilizza get_order quando un acquirente richiede nuove informazioni o quando una consegna necessita di riconciliazione.
Il pagamento ChatGPT standard di Shopify è un pagamento diretto UCP?
La vetrina agente ChatGPT standard di Shopify reindirizza l’acquirente alla cassa del negozio online del commerciante. Altri canali abilitati e integrazioni di agenti separati possono utilizzare flussi di pagamento diversi; verifica quello che stai implementando.
Cosa devo verificare prima di implementare un’integrazione UCP?
Controlla l’endpoint, la versione del protocollo negoziato, le funzionalità, gli ambiti, l’autenticazione e i passaggi di conferma dell’acquirente. Testa i prodotti non disponibili, effettua il check-out e aggiorna gli ordini con l’agente scelto prima di rilasciare l’integrazione.
Risorse
- Annuncio del negozio MCP
- API di modifica dell’ordine richieste dall’acquirente
- Funzionalità di pagamento UCP
- Funzionalità di collegamento dell’identità UCP
- Capacità di ordine UCP
- Archivio delle specifiche UCP
Questo articolo fa parte della nostra serie “Beyond the Checkout”. L’app di modifica degli ordini dei clienti di Revize fornisce modifiche self-service idonee prima dell’evasione all’interno di una finestra impostata dal commerciante. Il cambio di prodotto, i prodotti aggiuntivi, l’applicazione di sconti e i rimborsi di crediti in negozio richiedono la versione Pro; la modifica da parte dello staff è in fase di sviluppo. Questo portale clienti è separato dall’integrazione dell’agente UCP.
Lettura correlata
Statistiche di modifica degli ordini Shopify · Come vendere su ChatGPT con le vetrine degli agenti Shopify · Guida agli endpoint MCP e UCP di Shopify · Guida Shopify AI Toolkit · Come consentire ai clienti di modificare Ordini Shopify