MCP-Server
Claude, Cursor, Codex oder einen beliebigen MCP-Client mit einer URL und Ihrem API-Schlüssel an die Compliance-Datensätze eines Restaurants anbinden.
BackResto betreibt einen Model-Context-Protocol-Server unter
https://api.backresto.com/mcp. Verbinden Sie Ihr KI-Tool mit Ihrem
API-Schlüssel damit, und Sie können die Datensätze eines Restaurants in der
Oberfläche des Tools selbst befragen: kein Code, nichts bei uns zu installieren,
nichts bei Ihnen zu hosten.
Er liest über dieselbe Partner-API wie alles andere, mit demselben Schlüssel. Er kann nichts sehen, was der Schlüssel nicht schon sehen konnte: Die Freigaben für Restaurants und Scopes setzt die API durch, nicht das Tool, das Sie verbinden.
Ihr Tool verbinden
Zuerst brauchen Sie einen Schlüssel, siehe Einen Schlüssel erhalten. Wählen Sie dann Ihr Tool:
Wählen Sie Ihr Tool
Den Server registrieren
Öffnen Sie ein Terminal und führen Sie diesen Befehl aus, mit Ihrem Schlüssel anstelle von brp_YOUR_KEY.
shellclaude mcp add --transport http --scope user backresto \ https://api.backresto.com/mcp \ --header "Authorization: Bearer brp_YOUR_KEY"Die Verbindung prüfen
Starten Sie Claude Code und tippen Sie /mcp. backresto erscheint als verbunden, mit vier Tools.
Fertig
Fragen Sie in normalen Worten nach Ihren Lieferungen. Der Schlüssel weiß schon, welches Restaurant Ihres ist.
Die Tools
Acht Werkzeuge, gruppiert nach dem, was sie lesen.
Lieferungen
| Tool | Was es tut |
|---|---|
backresto_list_deliveries | Listet Lieferungen über einen geordneten Zeitraum in Epoch-Millisekunden von höchstens 366 Tagen. Nimmt from, to, optional limit (1–100, Standard 50) und cursor. |
backresto_get_delivery | Ruft eine Lieferung über ihre deliveryId ab. |
backresto_get_delivery_photos | Zeigt die Fotos einer Lieferung, jedes als Bild, das das Modell ansehen kann, mit einer vorsignierten URL pro Foto. Erfordert delivery-images:read. |
| Tool | Was es tut |
|---|---|
backresto_list_collections | Listet die Collections, die diesem Schlüssel freigegeben wurden, jeweils mit dem Scope, der sie geöffnet hat. Der richtige erste Aufruf, wenn Sie nicht wissen, was der Schlüssel erreicht. |
backresto_list_records | Liest eine Seite Datensätze aus einer Collection, Löschmarkierungen eingeschlossen. Nimmt collection, optional limit (1–100, Standard 50) und cursor. |
backresto_get_record | Ruft einen Datensatz über collection und recordId ab. |
backresto_list_record_assets | Listet die Dateien, die an einem Datensatz hängen — cleaning-task-pictures, traceability-labels oder drive-files — als signierte URLs. |
Beide
| Tool | Was es tut |
|---|---|
backresto_list_restaurants | Listet die Restaurants, die der Schlüssel erreicht, mit seinen Scopes für jedes. |
restaurantId ist überall optional. Lassen Sie es weg, wird das Restaurant des
Schlüssels verwendet: Ein Restaurant mit einem Schlüssel muss seine Kennung nie
kennen. Nur ein Schlüssel, der mehrere Restaurants erreicht, muss wählen, und
der Fehler nennt die Auswahl.
Alle acht sind als schreibgeschützt und idempotent deklariert, sodass ein ordentlicher Client nicht bei jedem Aufruf um Erlaubnis fragt, wie er es bei einem schreibenden Tool tut.
Zwei praktische Grenzen. Fotos werden für das Modell bis zu zehn Bildern und etwa 7,5 MB pro Antwort eingebettet; was darüber hinausgeht, erscheint weiterhin in der Zusammenfassung, mit seiner URL und dem Grund, warum es nicht gezeigt wurde. Und der gesamte Endpunkt teilt sich das Budget der Partner-API von 300 Anfragen pro Minute und Schlüssel — ein Tool-Aufruf ist eine Anfrage, was ein Gespräch nie erreichen wird und eine Schleife schon.
Den Schlüssel schützen
Der Schlüssel ist Ihr gesamter Zugang, und die Konfiguration eines MCP-Clients ist eine gewöhnliche Datei auf einem Laptop.
- Committen Sie diese Datei nie. Liegt die Konfiguration Ihres Tools in einem Repository, verweisen Sie auf eine Umgebungsvariable oder einen Secret-Store des Betriebssystems, wie es die Codex-Einrichtung oben tut.
- Geben Sie jedem Rechner seinen eigenen Schlüssel. Ein Schlüssel pro Laptop heißt: Ein verlorener Laptop kostet einen Widerruf, keine Rotation über alle Ihre Integrationen.
- Fragen Sie uns, wann ein Schlüssel zuletzt benutzt wurde, wenn Sie vermuten, dass irgendwo noch eine Kopie aktiv ist. Wir sehen die letzte Authentifizierung jedes Schlüssels, und ein Widerruf ist dieselbe E-Mail.
Mit dem BackResto-Konto anmelden
Manche Tools, etwa benutzerdefinierte Konnektoren in claude.ai, verbinden sich, indem sie Sie auf eine Anmeldeseite schicken, statt einen Schlüssel zu nehmen. Das erfordert eine OAuth-Anmeldung mit Ihrem BackResto-Konto, die es noch nicht gibt. Alle Tools oben funktionieren schon heute mit einem Schlüssel. Wenn die Anmeldung das ist, was zwischen Ihnen und einer Integration steht, sagen Sie es: Sie rückt auf der Liste nach oben.
Wofür er gut ist
Konkret kann eine Betriebsleitung mit verbundenen Tools fragen:
- „Welche Lieferungen wurden letzten Monat abgelehnt, und warum?“
- „Zeig mir alle Hähnchenlieferungen über 4 °C in diesem Quartal.“
- „Zeig mir die Fotos der am Dienstag abgelehnten Lieferung: Ist der Schaden zu sehen?“
- „Welche Kühlschränke lagen am häufigsten außerhalb des Bereichs, und in welcher Zone?“
- „Sind die Kühlzyklen letzte Woche alle rechtzeitig heruntergekommen?“
- „Welche Reinigungsaufgaben wurden ausgelassen, und zu welchen gibt es kein Foto?“
Die ersten drei lesen Lieferungen; der Rest liest Collections, und nur die, die Ihrem Schlüssel freigegeben wurden. Die Antworten stammen aus denselben Datensätzen, die ein Kontrolleur lesen würde, über dieselben Freigaben, die das Restaurant erteilt hat.
Einem Modell, das Collections liest, sollte man sagen, was es liest: einen Snapshot dessen, was die API empfangen hat, und keine garantiert vollständige Historie. Wenn Sie das einem Kunden vorlegen, schreiben Sie diesen Satz daneben.