# 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.

Source: https://developers.backresto.com/de/docs/mcp

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](https://developers.backresto.com/de/docs/access). Wählen Sie dann Ihr Tool:

### Claude

1. **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.

2. **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.

```
https://api.backresto.com/mcp
```

3. **Mit 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.

4. **Fertig**: Fragen Sie in normalen Worten nach Ihren Datensätzen: Temperaturen, Reinigung, Lieferungen, Etiketten. Der Schlüssel weiß schon, welches Restaurant Ihres ist.

### Claude Code

1. **Den Server registrieren**: Öffnen Sie ein Terminal und führen Sie diesen Befehl aus, mit Ihrem Schlüssel anstelle von brp_YOUR_KEY.

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

2. **Die Verbindung prüfen**: Starten Sie Claude Code und tippen Sie /mcp. backresto erscheint als verbunden, mit fünf Tools.

3. **Fertig**: Fragen Sie in normalen Worten nach Ihren Datensätzen: Temperaturen, Reinigung, Lieferungen, Etiketten. Der Schlüssel weiß schon, welches Restaurant Ihres ist.

### Cursor

1. **Die MCP-Einstellungen öffnen**: Gehen Sie in Cursor zu Settings, dann Tools & MCP, und klicken Sie auf New MCP Server. Das öffnet mcp.json.

2. **Den Server hinzufügen**: Fügen Sie dies in mcp.json ein, mit Ihrem Schlüssel anstelle von brp_YOUR_KEY. Der Server erscheint mit fünf Tools in der Liste.

```json
{
  "mcpServers": {
    "backresto": {
      "type": "http",
      "url": "https://api.backresto.com/mcp",
      "headers": {
        "Authorization": "Bearer brp_YOUR_KEY"
      }
    }
  }
}
```

3. **Fertig**: Fragen Sie in normalen Worten nach Ihren Datensätzen: Temperaturen, Reinigung, Lieferungen, Etiketten. Der Schlüssel weiß schon, welches Restaurant Ihres ist.

### Codex

1. **Den Schlüssel in die Umgebung legen**: Codex liest ein Bearer-Token aus einer Umgebungsvariable statt aus seiner Konfigurationsdatei. Fügen Sie diese Zeile Ihrem Shell-Profil hinzu, mit Ihrem Schlüssel anstelle von brp_YOUR_KEY.

```sh
export BACKRESTO_API_KEY="brp_YOUR_KEY"
```

2. **Den Server registrieren**: Führen Sie dann dies einmal aus. Codex sendet den Wert der Variable als Authorization-Header.

```sh
codex mcp add backresto \
  --url https://api.backresto.com/mcp \
  --bearer-token-env-var BACKRESTO_API_KEY
```

3. **Fertig**: Fragen Sie in normalen Worten nach Ihren Datensätzen: Temperaturen, Reinigung, Lieferungen, Etiketten. Der Schlüssel weiß schon, welches Restaurant Ihres ist.

### Andere

1. **Die MCP-Einstellungen Ihres Tools öffnen**: Suchen Sie den Bereich MCP oder Integrationen und fügen Sie einen entfernten Server mit Streamable HTTP hinzu. Fragt Ihr Tool nur nach einer URL, öffnet es eine BackResto-Seite, auf der Sie den Schlüssel einfügen, und der Header entfällt.

2. **Die Adresse eingeben**: Das ist die Server-URL.

```
https://api.backresto.com/mcp
```

3. **Den Schlüssel als Header hinzufügen**: Senden Sie ihn mit jeder Anfrage als Authorization-Header.

```
Authorization: Bearer brp_YOUR_KEY
```

4. **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](https://developers.backresto.com/de/docs/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](https://developers.backresto.com/de/docs/deliveries).

`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](https://developers.backresto.com/de/docs/rate-limits) 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](https://developers.backresto.com/de/docs/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.