Shopify MCP migra a UCP: guida alla migrazione entro giugno 2026

Cosa è cambiato nello Storefront Catalog MCP di Shopify

Shopify ha annunciato la migrazione dello Storefront Catalog MCP alla Unified Commerce Platform (UCP). Si tratta di una revisione strutturale che coinvolge tre elementi fondamentali: l'endpoint di accesso, i nomi dei tool e gli schemi di request e response. La documentazione ufficiale punta già interamente alla nuova versione, mentre i vecchi tool resteranno attivi soltanto fino al 15 giugno 2026.

Per chi costruisce esperienze commerce headless o AI-assisted su Shopify, questa non è una nota di rilascio secondaria. È una modifica che tocca l'architettura di integrazione e richiede un intervento pianificato, non una correzione dell'ultimo minuto.

Il nuovo endpoint UCP

L'endpoint di riferimento per tutte le chiamate MCP al catalogo diventa:

`` https://{storedomain}/api/ucp/mcp ``

Il vecchio path smette di ricevere aggiornamenti e sarà rimosso dopo la scadenza. Qualsiasi integrazione che non aggiorni l'endpoint entro quella data si troverà a gestire una migrazione in condizioni di emergenza, con i rischi operativi che ne conseguono.

I tre tool disponibili nella nuova UCP

La nuova superficie di accesso al catalogo espone tre tool con nomi e comportamenti aggiornati rispetto alla versione precedente.

search_catalog

Ricerca prodotti all'interno del catalogo con supporto a filtri avanzati, paginazione e contesto acquirente. Sostituisce il vecchio tool search. Il contesto acquirente consente di modellare i risultati in funzione di segmenti specifici, prezzo e disponibilità per mercato.

lookup_catalog

Recupero batch di prodotti o varianti tramite identificatore. Sostituisce il vecchio tool lookup. È ottimizzato per scenari in cui un agente o un'integrazione deve risolvere un insieme noto di identificatori senza eseguire una ricerca testuale.

get_product

Dettaglio completo di un singolo prodotto, con selezione della variante e segnali di disponibilità. Non ha un equivalente diretto nei vecchi tool: rappresenta una capacità aggiuntiva introdotta con la UCP, utile nei flussi conversazionali in cui l'agente deve presentare informazioni precise su un prodotto già identificato.

Perché Shopify sta facendo questa mossa

La migrazione a UCP non è soltanto una pulizia tecnica. Shopify sta unificando la surface di accesso al catalogo per agenti AI, integrazioni headless e applicazioni di terze parti sotto un'unica architettura coerente. Questo significa che le future evoluzioni degli strumenti MCP — nuovi tool, nuovi schemi, nuove capacità — passeranno tutte per l'endpoint UCP.

Chi adotta la nuova architettura adesso si posiziona su una base stabile per le prossime iterazioni. Chi rimanda si trova a inseguire due cambiamenti contemporaneamente.

Checklist di migrazione

Ecco le azioni concrete da completare prima della scadenza del 15 giugno 2026:

• Verificare l'integrazione esistente: controllare se il codice utilizza ancora i vecchi tool search e lookup con il vecchio endpoint.
• Aggiornare i nomi dei tool: sostituire search con search_catalog, lookup con lookup_catalog e aggiungere il supporto per get_product dove necessario.
• Migrare l'endpoint: aggiornare tutte le chiamate verso /api/ucp/mcp.
• Rivedere gli schemi di request e response: i payload possono differire dalla versione precedente. Ogni tool call va verificata rispetto alla nuova specifica.
• Testare in ambiente staging: prima di portare le modifiche in produzione, eseguire una suite di test su tutti i flussi che coinvolgono il catalogo.
• Aggiornare la documentazione interna: se il team ha documentato l'integrazione MCP, allineare i riferimenti alla nuova versione.

Impatto sulle architetture AI-assisted

Nei contesti in cui lo storefront è guidato da agenti AI — chatbot, assistenti di acquisto, motori di raccomandazione — l'integrazione MCP è spesso parte critica del flusso di reasoning. Un agente che chiama tool deprecati o che riceve risposte con schemi non aggiornati può produrre risultati incoerenti o fallire silenziosamente.

La migrazione a UCP è quindi un'opportunità per rivedere anche la logica con cui l'agente utilizza i tool: il nuovo get_product con segnali di disponibilità, per esempio, può migliorare la qualità delle risposte in scenari di disponibilità limitata o varianti esaurite.

Se stai valutando come strutturare o adeguare la tua integrazione Shopify MCP, puoi consultare i piani e i servizi per sviluppatori disponibili su Barikreativa per capire come affrontare la migrazione in modo strutturato.

Sintesi

La scadenza è fissata, la documentazione ufficiale è già aggiornata e i vecchi tool non riceveranno nuove funzionalità. Iniziare la migrazione adesso significa avere il tempo necessario per testare, correggere e distribuire le modifiche senza pressione. Aspettare significa ridurre quel margine a zero.