> ## Documentation Index > Fetch the complete documentation index at: https://storekit.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Strumenti WebMCP > Gli strumenti WebMCP che una pagina di ordinazione storekit espone al browser, così un agente AI nella scheda del cliente legge il menu e riempie il cart. **Per chi è:** un agente che agisce per il cliente, in esecuzione nella scheda del browser in cui sta ordinando. Quando un agente AI nel browser di un cliente lo aiuta a ordinare, altrimenti deve leggere il markup della pagina e simulare i clic — lento e sbagliato non appena il layout cambia. [WebMCP](https://github.com/webmachinelearning/webmcp) è uno standard web proposto che prende la via diretta: la pagina registra gli strumenti con il browser, e l'agente li chiama con argomenti strutturati e riceve dati strutturati in cambio. Una pagina di ordinazione storekit registra i suoi strumenti con il browser tramite `document.modelContext`. Non c'è nulla da installare e nessuna chiave da ottenere: un agente che supporta WebMCP trova gli strumenti sulla pagina su cui si trova già. ## Come funziona Gli strumenti agiscono sulla scheda che il cliente sta guardando, non su una sua copia. * Le letture rispondono dallo stato della pagina stessa — il locale caricato, il menu così com'è filtrato per questo cliente, il carrello così come si presenta. A un agente non viene mai detto che un articolo è ordinabile se la pagina lo rifiuterebbe. * Le scritture passano attraverso le stesse azioni che usano i pulsanti della pagina, quindi una riga aggiunta da un agente si comporta come una aggiunta dal cliente: gli stessi prezzi, la stessa validazione delle opzioni, lo stesso carrello che il cliente vede aggiornarsi davanti a sé. * I prezzi tornano come stringhe formattate nella valuta del locale, e le descrizioni sono spogliate del markup e troncate. I risultati sono da leggere ad alta voce, non da renderizzare. Nulla lascia la scheda. Non c'è alcun server MCP coinvolto e nessun trasporto: l'agente chiama una funzione JavaScript nella pagina. ## Strumenti L'agente sceglie uno strumento dalla sua descrizione. Ognuno degli strumenti qui sotto è registrato su ogni pagina di ordinazione in cui WebMCP è abilitato. ### Locale e menu | Strumento | Descrizione | | - | - | | `get_venue_info` | Nome, indirizzo, orari di apertura, se il locale è aperto in questo momento e i metodi di ordinazione che accetta. | | `search_menu` | Cerca nel menu per nome del piatto, categoria o descrizione, nel modo in cui un cliente lo chiede. Restituisce gli articoli corrispondenti con prezzo, tag dietetici e se possono essere ordinati adesso. | | `get_menu_item` | Un articolo per intero: descrizione, prezzo, tag dietetici, gli allergeni che contiene e che può contenere, i suoi valori nutrizionali dove il locale li pubblica, e i gruppi di opzioni da scegliere per ordinarlo. Accetta una `category` opzionale per un nome che compare in più di una categoria. | ### Carrello | Strumento | Descrizione | | - | - | | `get_basket` | Gli articoli nel carrello con quantità, opzioni scelte e totale del carrello. | | `add_to_basket` | Aggiungi uno o più articoli con le loro opzioni. Gli articoli che non possono essere aggiunti vengono segnalati e il resto viene comunque aggiunto. | | `set_basket_item_quantity` | Cambia quante unità di una riga del carrello ha il cliente, oppure rimuovi la riga con una quantità di `0`. | | `set_fulfillment_method` | Imposta Delivery, Pickup o InStore, limitato ai metodi che il locale accetta. | I tre strumenti carrello sono le uniche scritture, e sono contrassegnati come scritture — un client che rispetta `readOnlyHint` chiede al cliente prima di chiamarne uno. Pagamento, codici sconto e apertura del checkout non sono esposti: il cliente rivede e paga sulla pagina. Gli articoli vengono nominati in una scrittura tramite l'id che pubblicano le letture, con eventuali opzioni scelte tra parentesi — `BURGER(CHEESE;BACON:2)` — la stessa grammatica che usano i [link di precompilazione del carrello](/docs/it/developers/basket-prefill). Un articolo le cui opzioni sono annidate a più di un livello di profondità viene restituito con un link alla sua pagina, perché un albero di scelte così profondo produce carrelli che nessuno ha ordinato. ## Dove sono disponibili gli strumenti > [!NOTE] > > WebMCP è una proposta, non un'API browser rilasciata. Il rollout qui sotto segue quello di Chrome e si allargherà quando l'API verrà rilasciata senza restrizioni. | | Stato | | - | - | | Browser | Browser basati su Chromium con supporto WebMCP. La pagina rileva la funzionalità e non registra nulla altrove. | | Dominio | `order.storekit.com`. Il token di origin trial di Chrome è legato a quella origine esatta, quindi i negozi sul proprio dominio non hanno strumenti finché Chrome non rilascia l'API. | | Account | Disattivato di default e abilitato per account da storekit, in modo che gli strumenti possano essere disattivati senza un deploy. | | Chiosco | Mai. Un terminale fisso non ha un agente cliente. | | Dispositivi dello staff | Nulla di separato. Un membro dello staff che apre una pagina di ordinazione ottiene gli stessi strumenti lato cliente di chiunque altro; qui non c'è un set di strumenti per lo staff o per l'operatore. | | App storekit | Mai. Ordinare all'interno dell'app iOS o Android non registra alcuno strumento. | La pagina attiva anche un cluster agent isolato per origine, che WebMCP richiede. Nulla viene scaricato su un browser senza WebMCP: il rilevamento della funzionalità avviene per primo, e gli strumenti vengono recuperati solo dopo che la pagina è interattiva. ## Provare gli strumenti **1. Abilita WebMCP in Chrome** Attiva `chrome://flags/#enable-webmcp-testing`, o usa un'estensione agent con supporto WebMCP. **2. Apri un negozio su order.storekit.com** Carica la pagina di ordinazione di un locale e lascia che finisca il rendering. **3. Conferma la registrazione degli strumenti** Chiedi all'agente quali strumenti offre la pagina. Dovrebbe elencare i sette qui sopra. Se non ne elenca nessuno, ripercorri la tabella qui sopra prima di dare qualsiasi cosa per scontata: un browser senza WebMCP, un dominio diverso da `order.storekit.com`, un chiosco o una pagina in-app, oppure una pagina che non ha finito di caricarsi non registrano nulla, e gli strumenti sono anche disattivati finché storekit non li abilita per l'account — [contatta il supporto](/docs/it/getting-started/contact-support). **4. Ordina qualcosa** "Cosa c'è di vegano qui?", poi "aggiungine due" — il carrello nella scheda si riempie mentre l'agente lavora, e il cliente paga sulla pagina. ## Cosa non c'è ancora * **Checkout.** Nessuno strumento apre o completa il checkout. Il pagamento resta un passaggio umano, sulla pagina. * **Domini personalizzati.** I domini whitelabel non ottengono strumenti finché l'origin trial è per-origine. * **Catering e Pay at Table.** Nessuno dei due flussi è esposto; gli strumenti coprono l'ordinazione Delivery, Pickup e InStore. * **Storico ordini.** Non c'è uno strumento per gli ordini passati o lo stato dell'ordine. Per un agente che non è nel browser del cliente, usa invece l'[endpoint MCP](/docs/it/developers/agents/ordering/mcp-endpoint) — lo stesso shaping del menu su HTTP, con i propri nomi degli strumenti e un cart invece del carrello della pagina. ## Related topics - [Panoramica degli agenti di ordinazione](/docs/it/developers/agents/ordering/overview.md) - [MCP Endpoint](/docs/it/developers/agents/ordering/mcp-endpoint.md) - [Introduzione per sviluppatori](/docs/it/developers/introduction.md) - [Strumenti](/docs/it/developers/mcp/tools.md) - [Costruisci i tuoi strumenti su storekit](/docs/it/guides/build/overview.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.