Serveur MCP

Connecter Claude, Cursor, Codex ou n'importe quel client MCP aux enregistrements de conformité d'un restaurant, avec une URL et votre clé d'API.

BackResto fait tourner un serveur Model Context Protocol à l'adresse https://api.backresto.com/mcp. Connectez-y votre outil d'IA avec votre clé d'API et vous pouvez interroger les enregistrements d'un restaurant dans l'interface même de l'outil : pas de code, rien à installer chez nous, rien à héberger chez vous.

Il lit à travers la même API Partner que tout le reste, avec la même clé. Il ne peut rien voir que la clé ne voyait déjà : les autorisations par restaurant et par portée sont appliquées par l'API, pas par l'outil que vous connectez.

Connecter votre outil

Il vous faut d'abord une clé ; voir Obtenir une clé. Choisissez ensuite votre outil :

Choisissez votre outil

Enregistrer le serveur

Ouvrez un terminal et lancez cette commande, avec votre clé à la place de brp_YOUR_KEY.

shell

claude mcp add --transport http --scope user backresto \
  https://api.backresto.com/mcp \
  --header "Authorization: Bearer brp_YOUR_KEY"

Vérifier la connexion
Lancez Claude Code et tapez /mcp. backresto apparaît comme connecté, avec quatre outils.
C'est prêt
Posez vos questions sur vos livraisons en langage courant. La clé sait déjà quel restaurant est le vôtre.

Les outils

Huit outils, regroupés selon ce qu'ils lisent.

Livraisons

Outil	Ce qu'il fait
`backresto_list_deliveries`	Liste les livraisons sur un intervalle ordonné en millisecondes epoch d'au plus 366 jours. Prend `from`, `to`, et en option `limit` (1–100, 50 par défaut) et `cursor`.
`backresto_get_delivery`	Récupère une livraison par son `deliveryId`.
`backresto_get_delivery_photos`	Montre les photographies d'une livraison, chacune renvoyée comme une image que le modèle peut regarder, avec son URL présignée. Nécessite `delivery-images:read`.

Collections

Outil	Ce qu'il fait
`backresto_list_collections`	Liste les collections accordées à cette clé, avec la portée qui ouvre chacune. C'est le bon premier appel quand vous ne savez pas ce que la clé atteint.
`backresto_list_records`	Lit une page d'enregistrements d'une collection, pierres tombales comprises. Prend `collection`, et en option `limit` (1–100, 50 par défaut) et `cursor`.
`backresto_get_record`	Récupère un enregistrement par sa `collection` et son `recordId`.
`backresto_list_record_assets`	Liste les fichiers attachés à un enregistrement — `cleaning-task-pictures`, `traceability-labels` ou `drive-files` — sous forme d'URL signées.

Les deux

Outil	Ce qu'il fait
`backresto_list_restaurants`	Liste les restaurants que la clé atteint, avec ses portées sur chacun.

restaurantId est facultatif partout. Omettez-le et le restaurant de la clé est utilisé : un restaurant qui a une seule clé n'a jamais besoin de connaître son identifiant. Seule une clé qui atteint plusieurs restaurants doit choisir, et l'erreur nomme les choix possibles.

Les huit sont déclarés en lecture seule et idempotents : un client bien élevé ne vous demandera pas la permission à chaque appel, comme il le fait pour un outil qui écrit.

Deux limites pratiques. Les photographies sont intégrées pour le modèle jusqu'à dix images et environ 7,5 Mo par réponse ; tout ce qui dépasse apparaît quand même dans le résumé, avec son URL et la raison pour laquelle elle n'a pas été montrée. Et l'endpoint tout entier partage le budget de l'API Partenaire, 300 requêtes par minute et par clé — un appel d'outil est une requête, ce dont une conversation n'approchera jamais, et une boucle si.

Protéger la clé

La clé, c'est la totalité de votre accès, et la configuration d'un client MCP est un fichier ordinaire sur un ordinateur portable.

Ne commitez jamais ce fichier. Si votre outil garde sa configuration dans un dépôt, faites référence à une variable d'environnement ou à un coffre de secrets du système, comme le fait la configuration Codex ci-dessus.
Donnez à chaque machine sa propre clé. Une clé par ordinateur, c'est un ordinateur perdu qui coûte une révocation, pas une rotation sur toutes vos intégrations.
Demandez-nous quand une clé a servi pour la dernière fois si vous pensez qu'une copie traîne encore quelque part. Nous voyons la dernière authentification de chaque clé, et une révocation, c'est le même e-mail.

Se connecter avec son compte BackResto

Certains outils, comme les connecteurs personnalisés de claude.ai, se branchent en vous envoyant vers une page de connexion plutôt qu'en prenant une clé. Cela suppose une connexion OAuth avec votre compte BackResto, qui n'est pas encore disponible. Tous les outils ci-dessus fonctionnent dès aujourd'hui avec une clé. Si la connexion par compte est ce qui vous sépare d'une intégration, dites-le : elle remonte dans la liste.

Ce en quoi il excelle

Concrètement, une fois les outils connectés, un responsable des opérations peut demander :

« Quelles livraisons ont été refusées le mois dernier, et pourquoi ? »
« Montre-moi toutes les livraisons de poulet au-dessus de 4 °C ce trimestre. »
« Montre-moi les photos de la livraison refusée mardi : le dommage est-il visible ? »
« Quels réfrigérateurs sont le plus souvent sortis de leur plage, et dans quelle zone ? »
« Les cycles de refroidissement sont-ils tous descendus à temps la semaine dernière ? »
« Quelles tâches de nettoyage ont été sautées, et lesquelles n'ont pas de photographie ? »

Les trois premières lisent les livraisons ; les autres lisent les collections, et seulement celles qui ont été accordées à votre clé. Les réponses viennent des mêmes enregistrements qu'un inspecteur lirait, à travers les mêmes autorisations que le restaurant a accordées.

Un modèle qui lit des collections devrait savoir ce qu'il lit : un instantané de ce que l'API a reçu, pas un historique garanti complet. Si vous mettez cela devant un client, mettez cette phrase à côté.