Skip to main content
Tutto ciò che è presente in questa sezione è rivolto al cliente. Per un assistente che agisce per conto del ristorante (che ne legge gli ordini, le vendite e i menu, che crea codici sconto e payment link) consulta invece il merchant MCP. L’agente sta acquistando il pranzo per conto di qualcuno, quindi deve rispondere alle stesse domande a cui risponde il cliente: quale locale, cosa c’è nel menu, quanto costa, è disponibile ora. storekit risponde a queste domande attraverso quattro superfici, ognuna letta da un tipo diverso di agente lato cliente. Questa pagina è la mappa; ciascuna superficie ha la sua pagina di riferimento. Nulla di quanto qui presente riguarda il lato del ristorante. Al massimo della loro permissività queste superfici leggono un menu pubblico e riempiono un carrello; non modificano un menu, non vedono una coda di ordini, non toccano le impostazioni di un negozio, e nessuna credenziale in questa pagina concede tutto ciò.

​
Quale superficie ti serve

Strumenti WebMCP

Un agente all’interno del browser del cliente, sulla pagina che sta guardando.

MCP endpoint

Un assistente da qualche altra parte (ChatGPT, Claude, un IDE) che dialoga con un locale.

UCP discovery

Una piattaforma di commerce che legge un profilo prima di collegarsi a qualsiasi cosa.

llms.txt

Un crawler che vuole testo semplice invece di un’applicazione JavaScript.
Ogni reader qui sotto agisce per il cliente, mai per il ristorante: I primi due condividono le regole di shaping e di pricing, quindi un hamburger viene descritto, prezzato e rifiutato sulla stessa base indipendentemente da chi lo chieda, ma non sono gli stessi strumenti. I loro nomi, argomenti e scritture differiscono, e un client non può scambiare uno con l’altro: WebMCP legge la pagina che il cliente ha aperto e scrive nel basket davanti a lui, mentre l’endpoint MCP legge l’API pubblica e costruisce un carrello che sopravvive alla chiamata.

​
Cosa può e non può fare l’agente di un cliente

Sulle due superfici di strumenti, le letture non richiedono credenziali e le scritture si fermano prima del denaro. La UCP discovery e llms.txt sono più ristrette: un profilo e uno snapshot in testo semplice, non strumenti. Sugli strumenti WebMCP e MCP:
  • Un agente può leggere un locale, il suo menu, i gruppi di opzioni di un articolo, i metodi di ordinazione accettati e se è aperto. Gli slot disponibili rimanenti sono una lettura esclusiva dell’endpoint MCP.
  • Un agente può inserire articoli in un basket o in un carrello, cambiare le quantità e scegliere un metodo di fulfillment.
  • Un agente non può pagare. Non c’è alcuno strumento di checkout, nessun regolamento Pay at Table e nessuna gestione degli sconti. Il cliente apre la pagina del locale per rivedere il basket e pagare, e un carrello costruito tramite l’endpoint MCP torna con un link per fare esattamente questo.
  • A un agente non vengono mai consegnati i record del cliente. Nulla su queste superfici legge o memorizza un account, una rubrica indirizzi o una cronologia degli ordini.
  • Un agente non può agire come il ristorante. Non c’è alcuno strumento per modificare un menu, mettere in snooze un articolo, leggere la coda degli ordini o cambiare le impostazioni del negozio: queste sono prerogative dell’operatore, tramite la dashboard e i webhook e l’API REST.
Gli strumenti di lettura riportano l’annotazione readOnlyHint di MCP e le scritture nel basket no, ed è questo che permette a un client ben costruito di chiamare una lettura da solo e chiedere al cliente prima di una scrittura.

​
Stato attuale

Queste superfici sono all’inizio. Considera i nomi degli strumenti e le forme dei payload come instabili finché una pagina non dice altrimenti, e aspettati che la parte WebMCP si muova con lo standard che segue.

​
Per il lato ristorante

Un’interfaccia rivolta allo staff (un assistente a cui il team di un ristorante può chiedere informazioni su ordini, vendite e menu) è un prodotto separato: il merchant MCP su mcp.storekit.com. Risponde al ristorante piuttosto che a un cliente, è credenziato con un sign-in della dashboard ed è attualmente in beta. Nulla nelle quattro pagine sopra si applica ad esso. Stai costruendo qualcosa contro una di queste superfici, o vuoi che vengano attivate per i tuoi negozi? Contatta il supporto, oppure usa il modulo storekit MCP/API Access Request se ti serve anche l’API REST.