Skip to main content
A chi si rivolge: uno sviluppatore che collega un client o un agente AI all’account storekit di un merchant. Per le superfici lato cliente (un agente che legge un menu pubblico e costruisce un basket) consulta Agenti di ordinazione. Per le guide di configurazione non tecniche, consulta Collega il tuo agente AI.
Funzionalità beta - Il merchant MCP è in beta e gli account vengono abilitati da una waitlist. Richiedi l’accesso, oppure scrivi a mcp@storekit.com.

​
Endpoint

Ogni richiesta crea un nuovo server MCP legato all’account autenticato, gestisce un messaggio e si chiude. Nulla viene ricordato tra le chiamate; una conversazione porta con sé gli ID dei locali e degli ordini.

​
Strumenti

Diciotto strumenti, tutti limitati all’account autenticato. Sedici sono di sola lettura (readOnlyHint: true); create-discount-code e create-payment-link sono scritture. Il riferimento completo degli input è in Strumenti. Non esistono strumenti che modifichino ordini, menu, locali, utenti o impostazioni.

​
Contratto in breve

  • Ogni successo è un envelope { data, meta }, restituito sia come structuredContent sia come JSON nel primo blocco di testo. Ogni strumento pubblica un outputSchema corrispondente. Consulta Formato della risposta.
  • Gli errori sono risultati isError: true solo testo che portano un envelope { error } con un code stabile. Consulta Errori.
  • Gli importi monetari sono in unità minori con un codice valuta esplicito. Le date sono ISO strict. Le query limitate a un locale usano di default il fuso orario del locale, quelle a livello di account usano UTC.
  • La paginazione parte da pagina 1, è limitata a 100 righe, e riporta hasMore/nextPage da un lookahead di una riga anziché dai totali.

​
Limiti

​
Riferimento

Autenticazione

Discovery OAuth e sign-in, come viene scelto l’account.

Strumenti

Ogni strumento con i suoi input, i default e la base delle date.

Formato della risposta

L’envelope, la paginazione, le date, i fusi orari e la valuta.

Errori

Codici di errore, regole di retry e le forme che i client devono gestire.