Shopify MCP e UCP nel 2026: endpoint attuali e funzionalità

Shopify MCP copre diverse interfacce con scopi diversi. La Guida alla migrazione di Storefront MCP di Shopify mappa il precedente catalogo e gli strumenti del carrello su UCP, preservando lo strumento policy/FAQ e la MCP degli account cliente. Scegli una superficie in base all’attività dell’acquirente, quindi controllane lo schema e l’autorizzazione. Questa guida spiega anche dove si inserisce un flusso di lavoro di modifica post-acquisto rivolto al cliente.

Il livello tecnico, in breve#

MCP (Model Context Protocol) è un’interfaccia strumento utilizzata dai client AI. L’attuale documentazione commerciale di Shopify descrive anche gli endpoint UCP (Universal Commerce Protocol) per la scoperta del catalogo, il checkout e l’accesso agli ordini. Un client deve utilizzare lo schema, l’autenticazione e le autorizzazioni correnti dell’endpoint; i nomi e le funzionalità degli endpoint non sono intercambiabili.

La documentazione del Storefront Catalog elenca search_catalog, lookup_catalog e get_product e richiede il profilo agente in meta.ucp-agent.profile. Checkout e Order MCP hanno regole di accesso e operazioni supportate diverse. Per gli strumenti di scoperta e i relativi limiti, consulta la nostra guida Shopify Catalog MCP.

Il nostro consiglio: sviluppare usando l’endpoint attualmente documentato#

Mappa le vecchie integrazioni strumento per strumento: la scoperta del prodotto utilizza il Storefront Catalog, le operazioni del carrello utilizzano Cart MCP e il checkout utilizza Checkout MCP. Mantieni le domande sui criteri su /api/mcp. Testa lo schema di richiesta e le regole di accesso di ogni sostituzione in fase di sviluppo prima di spostare il traffico.

L’endpoint del catalogo può supportare il rilevamento del prodotto, ma di per sé non dimostra che un agente possa creare un checkout, leggere l’ordine di un acquirente o modificarne uno. Questi sono flussi di lavoro separati. L’MCP Dev di AI Toolkit è destinato agli sviluppatori ed è diverso dagli endpoint commerciali rivolti agli acquirenti.

Cosa fa davvero un agente AI nel tuo negozio#

La sequenza dipende dall’agente e dall’interfaccia Shopify che utilizza. Una richiesta di catalogo può cercare o recuperare dati di prodotto. Un flusso di pagamento può richiedere l’autenticazione o una richiesta firmata e può inviare l’acquirente a rivedere o completare l’acquisto. Documenti MCP Order di Shopify get_order per ordini originati da agenti supportati; non è un’API generale per la cronologia degli ordini multicanale. Leggi l’ambito di ciascun endpoint prima di collegarlo all’assistenza clienti o all’evasione.

L’accesso del cliente autenticato è un’integrazione separata#

Account cliente MCP consente a un assistente di gestire i dettagli dell’ordine, lo stato e le preferenze dell’account del cliente che ha effettuato l’accesso per quel negozio. Scopri mcp_api da https://{shop}/.well-known/customer-account-api, quindi autenticati con il codice di autorizzazione OAuth 2.0 e PKCE. La configurazione richiede un dominio personalizzato, la configurazione dell’autenticazione del cliente e l’accesso protetto ai dati del cliente. Dopo l’autenticazione, utilizzare tools/list per ispezionare gli strumenti e gli schemi effettivi; non dare per scontato modifiche arbitrarie o accesso all’account tra commercianti.

Order MCP utilizza invece le credenziali dell’agente per leggere gli ordini effettuati tramite quell’agente. La guida agli ordini webhook di Shopify descrive gli aggiornamenti del ciclo di vita UCP e la registrazione lato Shopify tramite un partner manager. La nostra Guida alle operazioni sugli ordini degli agenti Shopify copre la consegna e la riconciliazione.

Il flusso di lavoro post-acquisto è separato#

Un endpoint di rilevamento o pagamento del prodotto non fornisce un’operazione generale di modifica dell’ordine. L’attuale documentazione Order MCP di Shopify descrive la lettura dello stato degli ordini originati dall’agente supportati; non li modifica. Questa distinzione è importante quando un cliente deve correggere un indirizzo, una quantità o una variante dopo il pagamento.

Un negozio deve fornire un percorso rivolto al cliente per le modifiche idonee in base alla sua politica e al suo stato di evasione. L’app di modifica degli ordini dei clienti di Revize supporta le modifiche di indirizzo, quantità, variante e annullamento prima dell’evasione durante la finestra di modifica configurata dal commerciante. Il cambio di prodotti, l’aggiunta di prodotti, l’applicazione di sconti e i rimborsi del credito in negozio sono funzionalità Pro. Il portale richiede il blocco dell’app Revize nella pagina di stato dell’ordine ed è disponibile anche dal collegamento e-mail Edit Order. Consulta la nostra Guida alla modifica degli ordini Shopify per il flusso di lavoro e i limiti dell’editor nativo.

Quali documenti Shopify oggi#

Queste sono le capacità documentate da verificare rispetto agli attuali riferimenti di Shopify:

• Individuazione del catalogo specifico del negozio tramite l’endpoint UCP, con strumenti di catalogo documentati e un profilo agente.
• Un endpoint del catalogo globale separato per una più ampia scoperta dei prodotti.
• Checkout MCP con la propria autenticazione o requisiti di richiesta firmata e possibile trasferimento all’acquirente.
• Order MCP con uno strumento get_order per ordini originati dall’agente supportati.
• Account cliente MCP per richieste specifiche del cliente autorizzato e strumento politiche/FAQ per domande sui negozi pubblici.
• Un set di strumenti per sviluppatori locali tramite AI Toolkit e Dev MCP di Shopify.

Il solo nome di un endpoint non stabilisce l’accesso illimitato al negozio, la cronologia universale dell’account cliente o le autorizzazioni di modifica degli ordini. Utilizzare l’ambito documentato di ciascuna interfaccia. La nostra Guida Shopify AI Toolkit spiega separatamente gli strumenti per sviluppatori.

Cosa faremmo questo trimestre#

1. Scegli l’endpoint dall’attività. Utilizza i documenti attuali del Storefront Catalog per l’individuazione dei prodotti, i documenti Checkout MCP per il checkout e i documenti Order MCP per le letture degli ordini supportate.
2. Verifica profilo e requisiti di accesso. Le richieste del Storefront Catalog includono meta.ucp-agent.profile; verificare separatamente i requisiti esatti per ciascun altro endpoint.
3. Test in un ambiente di sviluppo. Convalida lo schema della richiesta, i campi restituiti, l’autenticazione e il passaggio all’acquirente prima di pianificare un lancio rivolto al cliente.
4. Verifica post-acquisto separatamente. Assicurati che i clienti abbiano un percorso per rivedere o richiedere modifiche idonee agli ordini; non aspettarti che MCP modifichi un ordine completato.
5. Ricontrolla i documenti prima del rilascio. Le API degli agenti di Shopify e il supporto clienti possono cambiare; utilizzare la documentazione primaria corrente anziché esempi copiati.

In sintesi#

Definire di quali dati ha bisogno il cliente e di quale autorizzazione concede l’accesso. L’individuazione del catalogo, il checkout, le risposte alle politiche pubbliche, gli account dei clienti e le letture degli ordini originati dall’agente hanno contratti distinti. La nostra Guida per sviluppatori Universal Commerce Protocol spiega la negoziazione delle capacità sotto le superfici UCP.

Per i commercianti, mantieni il servizio clienti e le modifiche post-acquisto come parti esplicite del design. L’Order MCP documentato di Shopify può leggere gli ordini originati dall’agente supportati; non fornisce un flusso generale di modifica degli ordini. Un portale di modifica rivolto al cliente, la politica del commerciante e il limite di evasione rimangono considerazioni separate.

Domande frequenti#

Qual è l’attuale endpoint Shopify MCP?#

Utilizza /api/ucp/mcp per il catalogo della vetrina e per gli strumenti documentati di carrello e pagamento. Le domande di politica pubblica rimangono a /api/mcp; le richieste dei clienti autenticate utilizzano l’endpoint MCP degli account cliente rilevato. Scegli l’endpoint che supporta l’attività specifica.

Quale endpoint Shopify dovrei utilizzare per la scoperta dei prodotti?#

Utilizza l’endpoint del catalogo specifico del negozio documentato per il catalogo di un commerciante o l’endpoint del catalogo globale separato di Shopify per una scoperta del catalogo più ampia. Controlla la panoramica del catalogo per gli strumenti attuali e richiedi i requisiti.

Cos’è l’UCP?#

UCP è il protocollo commerciale aperto di Shopify per interazioni documentate tra agenti, commercianti, fornitori di credenziali e fornitori di pagamenti. Utilizza i riferimenti specifici dell’endpoint perché le operazioni di individuazione, pagamento e ordine non condividono un modello di autorizzazione universale.

Ho bisogno di un profilo agente?#

La documentazione del Storefront Catalog richiede il profilo in meta.ucp-agent.profile. Controlla la documentazione per ogni altro endpoint anziché dare per scontato che lo stesso requisito o la stessa autorizzazione si applichino ovunque.

Un agente AI può completare il pagamento?#

Shopify documenti Acquista MCP separatamente. Il suo flusso attuale richiede l’autenticazione o una richiesta firmata e può inviare l’acquirente alla revisione o al completamento del pagamento. Consulta il riferimento MCP di Checkout per il percorso supportato.

Shopify MCP è disponibile su ogni piano?#

La disponibilità e l’accesso dipendono dall’endpoint e dalla configurazione del negozio. Controlla il piano attuale di Shopify e la documentazione dell’endpoint per l’integrazione specifica; non dedurre l’accesso al piano da un esempio MCP.

In che modo il catalogo globale è diverso dal Storefront Catalog?#

Il catalogo della vetrina ha come ambito un solo commerciante. Il catalogo globale è un endpoint di rilevamento separato per la ricerca di prodotti su Shopify. I loro endpoint e i contratti degli strumenti differiscono.

Cosa fa l’Ordine MCP?#

Shopify documenta uno strumento get_order per leggere lo stato attuale degli ordini originati dall’agente supportati. Non è un endpoint generale della cronologia degli ordini per tutti i canali di un cliente.

In che modo la MCP dei conti cliente è diversa dalla Order MCP?#

Account cliente MCP utilizza l’autorizzazione OAuth del cliente per l’account e le richieste di ordine di quel negozio. Order MCP utilizza l’accesso con ambito agente e può recuperare solo gli ordini effettuati tramite quell’agente. Scopri lo schema di ogni strumento prima di scegliere un’operazione di servizio clienti.

Shopify MCP risolve le modifiche agli ordini dopo l’acquisto?#

No. L’attuale documentazione Order MCP descrive le letture degli ordini, non la modifica. Le modifiche agli ordini rivolte al cliente richiedono un flusso di lavoro separato e rimangono soggette alla politica e allo stato di evasione del negozio.

Come posso testare un endpoint Shopify?#

Segui il riferimento ufficiale per quell’endpoint e testa la richiesta documentata in un ambiente di sviluppo. Conferma la sua autenticazione, i dati del profilo richiesti, i campi restituiti e qualsiasi passaggio di pagamento prima del rilascio.

Cosa ha riportato Shopify sulla crescita della ricerca AI?#

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%. Queste cifre descrivono i report di ricerca AI di Shopify, non le prestazioni di un particolare endpoint MCP. Vedi rapporto di Shopify.

Qual è il passaggio di implementazione con la priorità più alta?#

Scegli un’attività specifica, segui la documentazione attuale dell’endpoint Shopify e testa la richiesta completa e l’esperienza del cliente. Mantieni distinti i flussi di lavoro di catalogo, pagamento, lettura degli ordini e modifica post-acquisto.

Lettura correlata#

Come vendere su ChatGPT con le vetrine degli agenti Shopify · Come consentire ai clienti di modificare gli ordini Shopify