Server MCP
Colleghi Claude, Cursor, Codex o qualsiasi client MCP ai registri di conformità di un ristorante con un URL e la sua chiave API.
BackResto gestisce un server Model Context Protocol all'indirizzo
https://api.backresto.com/mcp. Vi colleghi il suo strumento di IA con la sua
chiave API e potrà interrogare i registri di un ristorante direttamente
dall'interfaccia dello strumento: niente codice, nulla da installare da parte
nostra, nulla da ospitare da parte sua.
Legge attraverso la stessa API Partner di tutto il resto, con la stessa chiave. Non può vedere nulla che la chiave non potesse già vedere: le concessioni per ristorante e per ambito sono applicate dall'API, non dallo strumento che collega.
Colleghi il suo strumento
Prima le serve una chiave; veda Ottenere una chiave. Poi scelga il suo strumento:
Scelga il suo strumento
Registrare il server
Apra un terminale ed esegua questo comando, con la sua chiave al posto di brp_YOUR_KEY.
shellclaude mcp add --transport http --scope user backresto \ https://api.backresto.com/mcp \ --header "Authorization: Bearer brp_YOUR_KEY"Verificare la connessione
Avvii Claude Code e digiti /mcp. backresto risulta connesso, con quattro strumenti.
Fatto
Chieda delle sue consegne con parole normali. La chiave sa già qual è il suo ristorante.
Gli strumenti
Otto strumenti, raggruppati per ciò che leggono.
Consegne
| Strumento | Cosa fa |
|---|---|
backresto_list_deliveries | Elenca le consegne in un intervallo ordinato in millisecondi epoch di al massimo 366 giorni. Accetta from, to, e facoltativamente limit (1–100, predefinito 50) e cursor. |
backresto_get_delivery | Recupera una consegna tramite il suo deliveryId. |
backresto_get_delivery_photos | Mostra le fotografie di una consegna, ciascuna restituita come immagine che il modello può guardare, con il suo URL prefirmato. Richiede delivery-images:read. |
| Strumento | Cosa fa |
|---|---|
backresto_list_collections | Elenca le collezioni concesse a questa chiave, con l'ambito che ha aperto ciascuna. È la prima chiamata giusta quando non sa cosa raggiunge la chiave. |
backresto_list_records | Legge una pagina di record da una collezione, tombstone compresi. Accetta collection, e facoltativamente limit (1–100, predefinito 50) e cursor. |
backresto_get_record | Recupera un record tramite collection e recordId. |
backresto_list_record_assets | Elenca i file allegati a un record — cleaning-task-pictures, traceability-labels o drive-files — come URL firmati. |
Entrambe
| Strumento | Cosa fa |
|---|---|
backresto_list_restaurants | Elenca i ristoranti che la chiave raggiunge, con i suoi ambiti su ciascuno. |
restaurantId è facoltativo ovunque. Se lo omette, viene usato il ristorante
della chiave: un ristorante con una sola chiave non ha mai bisogno di
conoscerne l'identificativo. Solo una chiave che raggiunge più ristoranti deve
scegliere, e l'errore elenca le possibilità.
Tutti e otto sono dichiarati in sola lettura e idempotenti, quindi un client ben fatto non le chiederà il permesso a ogni chiamata come fa con uno strumento che scrive.
Due limiti pratici. Le fotografie vengono incorporate per il modello fino a dieci immagini e circa 7,5 MB per risposta; tutto ciò che va oltre compare comunque nel riepilogo, con il suo URL e il motivo per cui non è stato mostrato. E l'intero endpoint attinge al budget dell'API Partner di 300 richieste al minuto per chiave — una chiamata a uno strumento è una richiesta, cosa che una conversazione non sfiorerà mai e un ciclo sì.
Proteggere la chiave
La chiave è tutto il suo accesso, e la configurazione di un client MCP è un file qualunque su un portatile.
- Non faccia mai commit di quel file. Se il suo strumento tiene la configurazione in un repository, faccia riferimento a una variabile d'ambiente o a un archivio di segreti del sistema, come fa la configurazione di Codex qui sopra.
- Dia a ogni macchina la sua chiave. Una chiave per portatile significa che un portatile perso costa una revoca, non una rotazione su tutte le sue integrazioni.
- Ci chieda quando una chiave è stata usata l'ultima volta se sospetta che una copia sia ancora attiva da qualche parte. Vediamo l'ultima autenticazione di ogni chiave, e una revoca è la stessa e-mail.
Accedere con l'account BackResto
Alcuni strumenti, come i connettori personalizzati di claude.ai, si collegano mandandola a una pagina di accesso anziché chiedere una chiave. Questo richiede un accesso OAuth con il suo account BackResto, che non è ancora disponibile. Tutti gli strumenti qui sopra funzionano già oggi con una chiave. Se l'accesso con l'account è ciò che si frappone tra lei e un'integrazione, ce lo dica: sale nella lista.
In cosa è bravo
In concreto, con gli strumenti collegati, un responsabile operativo può chiedere:
- «Quali consegne sono state rifiutate il mese scorso, e perché?»
- «Mostrami tutte le consegne di pollo sopra i 4 °C in questo trimestre.»
- «Mostrami le foto della consegna rifiutata martedì: il danno si vede?»
- «Quali frigoriferi sono usciti dai limiti più spesso, e in quale area?»
- «I cicli di raffreddamento sono scesi tutti in tempo la settimana scorsa?»
- «Quali compiti di pulizia sono stati saltati, e quali non hanno una fotografia?»
Le prime tre leggono le consegne; le altre leggono le collezioni, e solo quelle concesse alla sua chiave. Le risposte provengono dagli stessi registri che leggerebbe un ispettore, attraverso le stesse concessioni che il ristorante ha rilasciato.
A un modello che legge le collezioni va detto cosa sta leggendo: un'istantanea di ciò che l'API ha ricevuto, non uno storico garantito come completo. Se mette questo davanti a un cliente, ci metta accanto quella frase.