> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WebMCP-Tools

> Die WebMCP-Tools, die eine storekit-Bestellseite beim Browser registriert, damit ein KI-Agent im Tab des Kunden das Menü liest und den Warenkorb füllt.

**Für wen das ist:** ein Agent, der für den Kunden handelt und in dem Browser-Tab läuft, in dem dieser bestellt.

Wenn ein KI-Agent im Browser eines Kunden beim Bestellen hilft, muss er sonst das Markup der Seite lesen und Klicks simulieren — langsam und falsch, sobald sich das Layout ändert. [WebMCP](https://github.com/webmachinelearning/webmcp) ist ein vorgeschlagener Web-Standard, der den direkten Weg geht: Die Seite registriert Tools beim Browser, und der Agent ruft sie mit strukturierten Argumenten auf und erhält strukturierte Daten zurück.

Eine storekit-Bestellseite registriert ihre Tools über `document.modelContext` beim Browser. Es gibt nichts zu installieren und keinen Schlüssel zu beschaffen: Ein Agent, der WebMCP unterstützt, findet die Tools auf der Seite, auf der er sich bereits befindet.

## Funktionsweise

Die Tools wirken auf dem Tab, den der Kunde gerade betrachtet, nicht auf einer Kopie davon.

* Lesevorgänge antworten aus dem Zustand der Seite selbst — dem geladenen Lokal, der für diesen Kunden gefilterten Speisekarte, dem aktuellen Warenkorb. Ein Agent erfährt nie, dass ein Artikel bestellbar ist, den die Seite ablehnen würde.
* Schreibvorgänge laufen über dieselben Aktionen, die auch die Buttons der Seite verwenden, sodass sich eine vom Agent hinzugefügte Position wie eine vom Kunden hinzugefügte verhält: dieselbe Preisberechnung, dieselbe Optionsprüfung, derselbe Warenkorb, den der Kunde vor sich aktualisiert sieht.
* Preise werden als formatierte Zeichenketten in der Währung des Lokals zurückgegeben, und Beschreibungen sind von Markup befreit und gekürzt. Ergebnisse sind zum Vorlesen gedacht, nicht zum Rendern.

Nichts verlässt den Tab. Es ist kein MCP-Server beteiligt und kein Transport erforderlich: Der Agent ruft eine JavaScript-Funktion in der Seite auf.

## Tools

Der Agent wählt ein Tool anhand seiner Beschreibung. Jedes der folgenden Tools ist auf jeder Bestellseite registriert, auf der WebMCP aktiviert ist.

### Lokal und Speisekarte

| Tool | Beschreibung |
| - | - |
| `get_venue_info` | Name, Adresse, Öffnungszeiten, ob das Lokal gerade geöffnet ist, und die akzeptierten Bestellmethoden. |
| `search_menu` | Durchsucht die Speisekarte nach Gerichtsname, Kategorie oder Beschreibung — so, wie ein Kunde danach fragt. Liefert passende Artikel mit Preis, Ernährungs-Tags und der Angabe, ob sie jetzt bestellbar sind. |
| `get_menu_item` | Ein Artikel im Detail: Beschreibung, Preis, Ernährungs-Tags, die Allergene, die er enthält und enthalten kann, seine Nährwerte, wo das Lokal sie veröffentlicht, und die Optionsgruppen, die beim Bestellen gewählt werden müssen. Akzeptiert eine optionale `category` für einen Namen, der in mehr als einer Kategorie vorkommt. |

### Warenkorb

| Tool | Beschreibung |
| - | - |
| `get_basket` | Die Artikel im Warenkorb mit Mengen, gewählten Optionen und dem Warenkorb-Gesamtbetrag. |
| `add_to_basket` | Fügt einen oder mehrere Artikel mit ihren Optionen hinzu. Nicht hinzufügbare Artikel werden zurückgemeldet, die übrigen dennoch hinzugefügt. |
| `set_basket_item_quantity` | Ändert die Menge einer Warenkorbposition oder entfernt die Position mit einer Menge von `0`. |
| `set_fulfillment_method` | Setzt Delivery, Pickup oder InStore, beschränkt auf die vom Lokal akzeptierten Methoden. |

Die drei Warenkorb-Tools sind die einzigen Schreibvorgänge und sind als solche markiert — ein Client, der `readOnlyHint` respektiert, fragt den Kunden, bevor er sie aufruft. Zahlung, Rabattcodes und das Öffnen des Checkouts werden nicht bereitgestellt: Der Kunde prüft und bezahlt auf der Seite.

Artikel werden an einen Schreibvorgang mit der ID benannt, die die Lesevorgänge veröffentlichen, wobei ausgewählte Optionen in Klammern stehen — `BURGER(CHEESE;BACON:2)` — dieselbe Grammatik wie bei den [Basket-Prefill-Links](/docs/de/developers/basket-prefill). Ein Artikel, dessen Optionen mehr als eine Ebene tief verschachtelt sind, wird stattdessen mit einem Link zu seiner Seite zurückgegeben, weil ein so tief geschachtelter Auswahlbaum Warenkörbe erzeugt, die niemand bestellt.

## Wo die Tools verfügbar sind

> [!NOTE]
>
> WebMCP ist ein Vorschlag, keine ausgelieferte Browser-API. Der unten dargestellte Rollout folgt dem von Chrome und wird sich erweitern, sobald die API ohne Gating ausgeliefert wird.

| | Status |
| - | - |
| Browser | Chromium-basierte Browser mit WebMCP-Unterstützung. Die Seite führt Feature Detection aus und registriert anderswo nichts. |
| Domain | `order.storekit.com`. Das Chrome-Origin-Trial-Token ist an genau diesen Origin gebunden, sodass Stores auf ihrer eigenen Domain keine Tools haben, bis Chrome die API ausliefert. |
| Konten | Standardmäßig aus und pro Konto durch storekit aktiviert, sodass die Tools ohne Deploy abgeschaltet werden können. |
| Kiosk | Nie. Ein festes Terminal hat keinen Kundenagenten. |
| Personalgeräte | Nichts Separates. Ein Mitarbeiter, der eine Bestellseite öffnet, bekommt dieselben kundenseitigen Tools wie alle anderen; es gibt hier kein Personal- oder Betreiber-Toolset. |
| storekit-App | Nie. Bestellungen innerhalb der iOS- oder Android-App registrieren keine Tools. |

Die Seite entscheidet sich zusätzlich für einen origin-isolierten Agent Cluster, was WebMCP voraussetzt. In einem Browser ohne WebMCP wird nichts heruntergeladen: Feature Detection kommt zuerst, und die Tools werden erst geholt, nachdem die Seite interaktiv ist.

## Die Tools ausprobieren

**1. WebMCP in Chrome aktivieren**

Aktivieren Sie `chrome://flags/#enable-webmcp-testing` oder verwenden Sie eine WebMCP-fähige Agent-Erweiterung.

**2. Einen Store auf order.storekit.com öffnen**

Laden Sie die Bestellseite eines Lokals und lassen Sie sie vollständig rendern.

**3. Prüfen, dass die Tools registriert sind**

Fragen Sie den Agenten, welche Tools die Seite anbietet. Er sollte die sieben oben genannten auflisten. Wenn er keine auflistet, gehen Sie die obige Tabelle durch, bevor Sie etwas annehmen: Ein Browser ohne WebMCP, eine andere Domain als `order.storekit.com`, eine Kiosk- oder In-App-Seite oder eine Seite, die noch nicht vollständig geladen ist, registrieren allesamt nichts, und die Tools sind zudem so lange aus, bis storekit sie für das Konto aktiviert — [Support kontaktieren](/docs/de/getting-started/contact-support).

**4. Etwas bestellen**

„Was ist hier vegan?", dann „zwei davon hinzufügen" — der Warenkorb im Tab füllt sich, während der Agent arbeitet, und der Kunde bezahlt auf der Seite.

## Was noch nicht dabei ist

* **Checkout.** Kein Tool öffnet oder schließt den Checkout ab. Zahlung bleibt ein menschlicher Schritt, auf der Seite.
* **Eigene Domains.** Whitelabel-Domains erhalten keine Tools, solange der Origin Trial per Origin gilt.
* **Catering und Pay at Table.** Keiner der beiden Flows wird bereitgestellt; die Tools decken Delivery-, Pickup- und InStore-Bestellungen ab.
* **Bestellhistorie.** Es gibt kein Tool für vergangene Bestellungen oder Bestellstatus.

Für einen Agent, der nicht im Browser des Kunden läuft, verwenden Sie stattdessen den [MCP-Endpoint](/docs/de/developers/agents/ordering/mcp-endpoint) — dieselbe Menü-Aufbereitung über HTTP, mit eigenen Tool-Namen und einem Cart statt des Warenkorbs der Seite.


## Related topics

- [MCP-Endpoint](/docs/de/developers/agents/ordering/mcp-endpoint.md)
- [Einführung für Entwickler](/docs/de/developers/introduction.md)
- [Übersicht der Bestell-Agenten](/docs/de/developers/agents/ordering/overview.md)
- [Tools](/docs/de/developers/mcp/tools.md)
- [API & Webhooks](/docs/de/guides/integrations/api-webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.