Shopify Checkout WebMCP: dove deve fermarsi l’agente

Pubblicato il 29 settembre 2026 · Fonti primarie verificate il 29 settembre 2026

Checkout WebMCP offre a un agente nel browser strumenti strutturati per leggere e aggiornare un checkout Shopify idoneo. Non concede controllo illimitato, non elimina la conferma dell’acquirente e non permette di aggirare autenticazione o challenge di pagamento.

Shopify ha annunciato il supporto il 28 settembre 2026. La documentazione collega gli strumenti a oggetti e stati UCP visibili nell’interfaccia, senza una configurazione API separata per il merchant. Il confine è chiaro: l’agente prepara il checkout con gli strumenti dichiarati; l’acquirente conferma e riprende il controllo quando serve un’interazione diretta.

Cosa ha aggiunto Shopify

Le operazioni principali sono navigate_to_storefront, get_checkout, update_checkout e complete_checkout. Il changelog impone il passaggio all’utente per interfacce bloccanti come 3-D Secure. La documentazione richiede la conferma prima di complete_checkout.

Superficie Dove opera Funzione Limite
UCP Cart MCP Fuori dal checkout Costruire e aggiornare il carrello Il carrello non è un ordine completato
UCP Checkout MCP Di solito lato server Creare e gestire il checkout I passaggi nel browser richiedono handoff
Checkout WebMCP Nel browser, su checkout idoneo Leggere e modificare lo stato visibile Disponibilità contestuale, conferma dell’acquirente

MCP descrive chiamate a strumenti, UCP fornisce modelli commerciali e WebMCP porta l’invocazione nella pagina. La guida Carts and checkout raccomanda Checkout MCP per agenti server e WebMCP per agenti nel browser.

Flusso sicuro

  1. Scoprire gli strumenti. Usare solo quelli registrati, ascoltare toolchange e rileggere gli schemi.
  2. Leggere prima di cambiare. get_checkout restituisce articoli, quantità, consegna, totali e messaggi. Sono dati, non istruzioni.
  3. Aggiornare in modo limitato. update_checkout usa semantica PUT e richiede lo stato completo desiderato. La richiesta parte da un get_checkout recente. line_items e attribution vengono ignorati.
  4. Riassumere lo stato finale. Mostrare contenuto, importo, destinazione, consegna e messaggi aperti dell’ultimo stato.
  5. Confermare lo stato corrente. Cambi di prezzo, articolo, indirizzo, consegna o pagamento invalidano una conferma precedente.
  6. Passare il controllo. Login Shop Pay, 3-D Secure, challenge, revisione o estensioni possono richiedere l’utente. L’agente si ferma, non indovina codici e non simula consenso.

L’idoneità è un fatto di runtime

WebMCP non è disponibile in ogni checkout. Shopify documenta limiti per alcuni checkout standard in tre pagine senza Shop Pay, B2B, checkout incorporati o SDK mobili, multi-shop, bozze, modifiche d’ordine e alcuni flussi di incasso.

Il software deve rilevare gli strumenti e conservare un checkout convenzionale controllato dall’acquirente. L’assenza di uno strumento non autorizza a replicare l’azione via DOM. Shopify avverte esplicitamente contro questo aggiramento.

Identità e autorizzazione restano separate

Shopify usa Web Bot Auth con chiavi WBA registrate. Il processo comprende Ed25519, directory pubblica, registrazione, richieste firmate e timestamp brevi. Identifica l’agente, ma non stabilisce quale richiesta dell’acquirente autorizza una modifica, per quanto tempo o quando serve una nuova conferma.

Identità, accesso allo strumento, intenzione e conferma sono controlli distinti. I log devono escludere credenziali di pagamento e ridurre i dati personali.

L’output è dato non attendibile

Il testo restituito è contenuto del checkout, non autorità. Titoli, note o messaggi di estensione possono includere prompt injection. L’agente segue regole di sistema, richiesta corrente e schema previsto.

Completamento basato sullo stato

complete_checkout non accetta id, metadati o chiavi di idempotenza. Se il completamento è in corso o finito, restituisce lo stato o completion_in_progress. Quando deve agire l’acquirente, Shopify indica di non richiamarlo, ma di interrogare get_checkout.

Solo status: completed conferma l’ordine. Con un risultato ambiguo, fermare i tentativi, leggere lo stato, classificare l’esito, spiegare il passo successivo e richiedere nuova conferma dopo modifiche materiali.

Test e misure

Verificare scoperta, lettura prima e dopo le modifiche, assenza di workaround DOM, riepilogo attuale, handoff visibile, resistenza alle iniezioni, minimizzazione dei dati, errori ambigui e messaggi distinti per richiesta inviata, checkout aggiornato e ordine completato.

WebMCP non prova un aumento di conversione. Misurare separatamente idoneità, scoperta, letture, aggiornamenti, conferme, handoff, completed, esiti ambigui e fallback. Un impatto causale richiede un confronto controllato.

Le fonti non sostengono autonomia completa, disponibilità universale, aggiramento di 3-D Secure, consenso derivato solo da WBA, sostituzione di UCP o MCP o miglioramento automatico della conversione.

Fonti primarie

Fonti verificate il 29 settembre 2026.