> ## 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.

# Panoramica degli agenti di ordinazione

> Come l'agente AI di un cliente ordina da un negozio storekit: strumenti WebMCP nel browser, endpoint MCP remoto, discovery UCP e llms.txt per i crawler.

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](/docs/it/developers/mcp/overview). 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](/docs/it/developers/agents/ordering/webmcp)**
>
> Un agente all'interno del browser del cliente, sulla pagina che sta guardando.

> **[MCP endpoint](/docs/it/developers/agents/ordering/mcp-endpoint)**
>
> Un assistente da qualche altra parte (ChatGPT, Claude, un IDE) che dialoga con un locale.

> **[UCP discovery](/docs/it/developers/agents/ordering/ucp)**
>
> Una piattaforma di commerce che legge un profilo prima di collegarsi a qualsiasi cosa.

> **[llms.txt](/docs/it/developers/agents/ordering/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:

| Superficie | Il reader | Dove viene eseguito | Transport |
| - | - | - | - |
| Strumenti WebMCP | L'agente nel browser del cliente | Nella scheda aperta | `document.modelContext`, senza rete |
| MCP endpoint | Un assistente remoto o un'app agente | Ovunque | JSON-RPC su HTTP `POST` |
| UCP discovery | Una piattaforma di commerce o un host di agenti | Ovunque | JSON in cache su HTTP `GET` |
| llms.txt | Un crawler LLM | Ovunque | Testo semplice su HTTP `GET` |

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](https://dashboard.storekit.com) e i [webhook e l'API REST](/docs/it/developers/introduction).

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

> [!NOTE]
>
> 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.

| Superficie | Stato |
| - | - |
| Strumenti WebMCP | Attivi su `order.storekit.com` sotto un origin trial di Chrome, abilitati per account da storekit, solo Chromium |
| MCP endpoint | Attivo per ogni locale e brand sull'host di ordinazione, strumenti di lettura più gli strumenti cart UCP |
| UCP discovery | Attivo, UCP `2026-08-25`, dichiara il transport MCP e la capability cart |
| llms.txt | Attivo per la piattaforma, ogni brand e ogni locale |

## 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](/docs/it/developers/mcp/overview) 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](/docs/it/getting-started/contact-support), oppure usa il modulo [storekit MCP/API Access Request](https://t09czsyu90l.typeform.com/to/G6rIJWNv) se ti serve anche l'[API REST](/docs/it/developers/introduction#richiedere-l-accesso-all-api).


## Related topics

- [Introduzione per sviluppatori](/docs/it/developers/introduction.md)
- [Panoramica del merchant MCP](/docs/it/developers/mcp/overview.md)
- [Documentazione storekit: ordinazione online, guide e API](/docs/it/index.md)
- [Panoramica degli ordini](/docs/it/guides/orders/overview.md)
- [Panoramica del menu](/docs/it/guides/menu/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.