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
Einen benutzerdefinierten Connector hinzufügen
Öffnen Sie in Claude, in der Desktop-App oder auf claude.ai, Customize, dann Connectors, und klicken Sie auf Add custom connector. Bei einem Team- oder Enterprise-Tarif fügt ihn zuerst ein Owner einmal in den Organisationseinstellungen hinzu.
Benennen und die Adresse einfügen
Nennen Sie ihn BackResto und fügen Sie diese URL ein. Unter Authentifizierung und OAuth-Client erkennt Claude unseren Server und wählt Jetzt anmelden und Automatisch registrieren vor: Behalten Sie diese beiden. Geben Sie weder Client-ID noch Secret ein. Klicken Sie dann auf Hinzufügen.
URLhttps://api.backresto.com/mcpMit Ihrem Schlüssel verbinden
Klicken Sie auf Connect. Eine BackResto-Seite öffnet sich: Fügen Sie Ihren Schlüssel ein, der mit brp_ beginnt, und klicken Sie auf Verbinden. Claude kehrt mit aktiviertem Connector und fünf Tools zurück.
Fertig
Fragen Sie in normalen Worten nach Ihren Datensätzen: Temperaturen, Reinigung, Lieferungen, Etiketten. Der Schlüssel weiß schon, welches Restaurant Ihres ist.
Die Tools
Fünf Werkzeuge: eines, das das Restaurant findet, und vier, die seine Collections lesen.
| Tool | Was es tut |
|---|---|
backresto_list_restaurants | Listet die Restaurants, die der Schlüssel erreicht, mit seinen Scopes für jedes. |
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, Tombstones 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, delivery-pictures, traceability-labels oder drive-files), als signierte URLs, und zeigt Fotos dem Modell als Bilder, die es ansehen kann. |
Lieferungen sind zwei dieser Collections, deliveries und delivery-pictures,
gelesen mit denselben Tools wie alles andere. Was ihre Felder bedeuten, steht
unter Lieferungen.
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 fünf sind als nur lesend 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 Aufruf von backresto_list_record_assets 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.
Nur mit der URL verbinden
Claude (Desktop-App und claude.ai), ChatGPT und andere Tools, die nur eine Server-URL verlangen, verbinden sich über OAuth: Sie registrieren sich selbst bei BackResto und öffnen dann eine BackResto-Seite, auf der Sie Ihren Schlüssel einmal einfügen. Nichts zu installieren, keine Konfigurationsdatei. Das Tool bewahrt den Schlüssel auf und sendet ihn für Sie: Es erreicht genau das, was der Schlüssel erreicht, und ein Widerruf des Schlüssels trennt es.
Eine Anmeldung mit einem BackResto-Konto gibt es noch nicht: Der Schlüssel bleibt die Zugangsberechtigung. Wenn das 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 die Collections deliveries und delivery-pictures,
der Rest liest andere Collections, und jede Frage liest nur,
was Ihrem Schlüssel freigegeben wurde. 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.