Menubarcode MCP
für jeden KI-Agenten
Fünf Server verbinden Agenten mit Live-Menüs, Bestellungen, Analysen und Theme-Tools. Zwei davon benötigen überhaupt keine Anmeldung.
In unter einer Minute verbinden
Verbinden Sie Ihren Client
Jeder Codeausschnitt zielt auf den öffentlichen Catalog-Server ab und funktioniert daher unverändert ohne jede Einrichtung. Tauschen Sie unten einen beliebigen Endpunkt ein; Token-Server ergänzen --header "Authorization: Bearer YOUR_TOKEN".
Endpunkt kopieren
Die öffentliche Catalog-URL. Sie geben sie in Schritt 2 an Ihren Client weiter.
https://menubarcode.com/mcp/catalogZu Ihrem Client hinzufügen
Ein Befehl in Ihrem Terminal, dann ausführen /mcp um die Verbindung zu bestätigen:
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalogFür einen Token-Server (z. B. Admin) übergeben Sie den Header:
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"In Claude im Web oder auf dem Desktop: Einstellungen → Konnektoren → Benutzerdefinierten Connector hinzufügen, und fügen Sie dann die Endpunkt-URL aus Schritt 1 ein.
Ein-Klick-Installation (öffnet Cursor):
Oder manuell hinzufügen zu ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}Ein-Klick-Installation (öffnet VS Code):
Oder manuell hinzufügen zu .vscode/mcp.json. Hinweis: VS Code verwendet ein anderes Schema (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}Aktivieren Sie den Entwicklermodus in ChatGPT, fügen Sie einen benutzerdefinierten Connector hinzu und fügen Sie die Server-URL aus Schritt 1 ein.
Windsurf, Zed und andere Clients, die einen Befehl erwarten, umschließen den HTTP-Endpunkt mit mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}Die Server sprechen JSON-RPC 2.0 über einen Streamable-HTTP-POST mit Einzelantwort. Tools auflisten:
curl -s https://menubarcode.com/mcp/catalog \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Ein Tool aufrufen (fügen Sie -H "Authorization: Bearer YOUR_TOKEN" für Token-Server hinzu):
curl -s https://menubarcode.com/mcp/catalog \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_stores","arguments":{"query":"pizza"}}}'Stellen Sie Ihre erste Frage
Der Agent ruft echte Tools auf und antwortet mit Live-Daten. Probieren Sie dies:
Oder lass deinen Coding-Agent es einrichten
Füge das in Claude Code, Cursor oder einen beliebigen Coding-Agent ein. Er fügt den Server für dich hinzu, ganz ohne Terminal.
Set up the Menubarcode Catalog MCP server for me. Run: claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalog then confirm it connected and list its tools.Entwickeln oder debuggen Sie stattdessen? Die ausführliche Protokollreferenz finden Sie unter /developers.
Fünf Server, ein Protokoll
55 Tools auf 5 Servern. Zwei davon sind öffentlich. Alle sprechen JSON-RPC 2.0 über Streamable HTTP POST.
| Server | Endpunkt | Authentifizierung | Werkzeuge |
|---|---|---|---|
menubarcode-catalog-mcp |
https://menubarcode.com/mcp/catalog |
Public | 4 |
menubarcode-dev-mcp |
https://menubarcode.com/mcp/dev |
Public | 8 |
menubarcode-mcp |
https://menubarcode.com/mcp |
API token | 23 |
menubarcode-storefront-mcp |
https://menubarcode.com/mcp/storefront |
Storefront token | 13 |
menubarcode-customer-mcp |
https://menubarcode.com/mcp/customer |
Customer token | 7 |
Welchen Server Sie brauchen Sie?
Wählen Sie Ihre Rolle. Jede Karte verweist auf den richtigen Server, seine Authentifizierung und seine Tools.
OW Store-Besitzer
Verwalten Sie Menüs, Bestellungen, Coupons und Öffnungszeiten und lesen Sie Ihre eigenen Analysen direkt aus Ihrem KI-Assistenten.
https://menubarcode.com/mcpAG Shopping-Agent-Ersteller
Entdecken Sie Restaurants auf der gesamten Plattform, durchsuchen Sie dann einen Store und geben Sie eine unbezahlte, serverseitig bepreiste Bestellung auf.
https://menubarcode.com/mcp/catalogDV Theme-/App-Entwickler
Lernen Sie die Plattform kennen, nutzen Sie die maßgebliche Liquid-Referenz und validieren Sie Ihr Theme mit den eigenen Prüfungen des Marketplace – alles direkt in Ihrem Editor.
https://menubarcode.com/mcp/devCU Gast/Kunde
Rufen Sie Ihre eigenen Bestellungen ab, verfolgen Sie eine Lieferung und stellen Sie eine frühere Bestellung als Entwurf über einen angemeldeten Assistenten wieder her.
https://menubarcode.com/mcp/customerEntwickeln für Menubarcode
Veröffentlichen Sie ein Storefront-Theme oder eine Partner-App. Der öffentliche Dev-Server verwandelt Ihren Editor beim Entwickeln in einen Plattformexperten.
TH Ein Theme erstellen
Liquid-basierte Storefront-Themes mit OS 2.0-Sections, einem typisierten Einstellungsschema und der vollständigen Commerce-Runtime.
- Laden Sie das Starter-Theme herunter und öffnen Sie den Theme-Guide: Paketstruktur, theme.json, Sections und die Drop-Referenz.
- Verbinden Sie den Dev-Server und entwickeln Sie mit der Liquid-Referenz und dem Section-Schema, die direkt aus Ihrem Editor antworten.
- Führen Sie validate_theme aus, bevor Sie einreichen: Es wendet die eigenen Prüfungen des Marketplace an und listet jeden Fehler auf.
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP App entwickeln
Partner-Apps erweitern das Dashboard: OAuth-Zugriff, Sitzungstokens, eingebettete Oberflächen, Webhooks und Nutzungsabrechnung.
- Lesen Sie den App-Guide: OAuth und Tokens, Scopes, eingebettete Apps und Webhook-Ereignisse.
- Registrieren Sie Ihre Partner-App, fordern Sie nur die benötigten Scopes an und entwickeln Sie gegen einen Sandbox-Store.
- Erfüllen Sie die Listing- und Prüfanforderungen und reichen Sie die App dann für den App-Marktplatz ein.
Während der Entwicklung beantworten search_docs und fetch_full_doc auf dem Dev-Server API- und Webhook-Fragen, ohne dass Sie den Editor verlassen müssen.
Werkzeug Katalog
55 Tools auf 5 Servern. Erweitern Sie einen Server, um zu sehen, was sein Agent kann. Vollständige JSON-Schemas finden Sie in der Entwicklerreferenz.
menubarcode-catalog-mcp (4 Tools) Öffentlich
Entdecken Sie Restaurants auf der gesamten Plattform. Nur aktive, öffentlich gelistete Stores; niemals personenbezogene Daten der Inhaber.
search_stores | Restaurants nach Name oder Küche finden. |
search_items | Ein Gericht in allen Stores suchen („Wer verkauft Schawarma in meiner Nähe?“). |
get_store | Details zu einem Store sowie ein Deep-Link-Hinweis zu seinem Storefront-Server. |
menubarcode-storefront-mcp (13 Tools) Storefront: Token
Alles, was ein Shopping-Agent für ein Restaurant benötigt. create_order gibt eine unbezahlte Bestellung auf, deren Preis vom Server berechnet wird. Senden Sie niemals Preise.
search_menu | Die Speisekarte dieses Stores durchsuchen. |
get_item | Vollständige Details zu einem Artikel (Varianten, Extras, Kennzeichnungen). |
validate_cart | Einen Warenkorb prüfen und vor der Bestellung die vom Server berechnete Summe abrufen. |
create_order | Eine unbezahlte, vom Server bepreiste Bestellung aufgeben. |
order_status | Aktueller Status einer Bestellung. |
order_eta | Geschätzte Zeit, bis die Bestellung fertig ist. |
order_history | Bisherige Bestellungen bei diesem Store. |
reorder_last | Die letzte Bestellung als neuen Warenkorb wiederherstellen. |
store_credit_balance | Für den Käufer verfügbares Store-Guthaben. |
restaurant_info | Öffnungszeiten, Adresse und Bestelloptionen. |
suggest_upsell | Relevante Add-ons für den aktuellen Warenkorb. |
dietary_answer | Eine Ernährungsfrage zur Speisekarte beantworten. |
menubarcode-mcp (23 Tools) API-Token
Der Werkzeugkasten des Inhabers. Tools sind pro Token nach Berechtigung freigeschaltet: Alles, was der Token nicht darf, wird aus der Liste ausgeblendet. Die beiden CRM-Tools benötigen außerdem die Funktion crm_suite. Jeder Schreibvorgang wird protokolliert über: mcp.
list_restaurants | Deine Restaurants |
get_menu | Die Kategorien und Artikel eines Restaurants. |
list_categories | Menükategorien mit Artikelanzahl. |
list_orders | Bestellungen, filterbar nach Status/Datum/Suche. |
get_order | Vollständige Details zu einer Bestellung. |
get_analytics | Bestellanzahl und Umsatz über N Tage. |
sales_report | Maßgebliche Umsatzübersicht für einen Zeitraum. |
get_restaurant_settings | Momentaufnahme von Profil- und Bestelleinstellungen. |
list_coupons | Ihre Rabattgutscheine. |
list_customers crm_suite | Ihre CRM-Kundenliste. |
get_customer crm_suite | Der vollständige CRM-Datensatz eines Kunden. |
add_menu_item | Einen Menüartikel erstellen. |
update_menu_item | Name/Preis/Beschreibung eines Artikels bearbeiten. |
delete_menu_item | Einen Artikel dauerhaft löschen. |
set_item_availability | Einen Artikel als vorrätig/ausverkauft markieren (die „86“-Umschaltung). |
add_category | Eine Menükategorie erstellen. |
update_category | Eine Kategorie umbenennen oder neu anordnen. |
delete_category | Eine leere Kategorie löschen. |
update_order_status | Den Status einer Bestellung vorantreiben. |
update_business_hours | Den öffentlichen Text der Öffnungszeiten festlegen. |
create_coupon | Einen Rabattgutschein erstellen. |
update_coupon | Einen Gutschein bearbeiten. |
delete_coupon | Einen Gutschein löschen. |
menubarcode-customer-mcp (7 Tools) Customer-Token
Das eigene Konto eines angemeldeten Gasts. Die Identität stammt ausschließlich aus dem Token; auf die Daten anderer Kunden kann niemals zugegriffen werden.
my_orders | Ihre letzten Bestellungen. |
order_detail | Vollständige Details zu einer Ihrer Bestellungen. |
track_order | Live-Status Ihrer Bestellung. |
reorder | Eine frühere Bestellung als Warenkorbentwurf wiederherstellen. |
my_profile | Ihr Profil bei diesem Restaurant. |
menubarcode-dev-mcp (8 Tools) Öffentlich
Verwandelt jeden MCP-fähigen Editor in einen Plattform-Experten: lernen, entwickeln, validieren – ohne den Editor zu verlassen.
learn_platform | Einführung in die Plattform. Rufen Sie dies zuerst auf. |
get_liquid_reference | Die maßgebliche Liquid-Whitelist (live generiert). |
get_section_schema | Das Schema-Blockformat für Theme-Sektionen (Einstellungen, Blöcke, Verknüpfungen). |
search_docs | Stichwortsuche in der Entwicklerdokumentation. |
fetch_full_doc | Ein vollständiges Dokument anhand des Pfads abrufen. |
validate_theme | Führen Sie die eigenen Prüfungen des Marktplatzes für Ihre Theme-Dateien aus. |
submit_feedback | Eine Lücke in der Dokumentation oder etwas Falsches oder Fehlendes melden. |
Ausprobieren jetzt
Öffnen Sie Claude mit vorausgefülltem Prompt. Zuerst die Prompts ohne Authentifizierung.
"Finde mir die bestbewertete Shawarma in der Nähe und zeig mir die Speisekarte."
"Prüfen Sie mein Theme anhand der Menubarcode-Marktplatzregeln und listen Sie jeden Fehler auf."
"Was waren meine meistverkauften Artikel diese Woche, und welchen Umsatz haben sie gebracht?"
"Fügen Sie meiner Speisekarte ein Ramadan-Special für 25 SAR hinzu und markieren Sie es als verfügbar."
"Bestellen Sie meine übliche Bestellung aus meinem Lieblingsstore erneut als Warenkorbentwurf."
"Verfolgen Sie meine letzte Bestellung und nennen Sie mir die voraussichtliche Ankunftszeit."
Authentifizierung Token
Zwei Server sind öffentlich. Die anderen drei authentifizieren sich mit einem Token, das Ihnen gehört.
| Server | Wie sich der Client authentifiziert | Wo Sie den Token erhalten | Umfang |
|---|---|---|---|
| Catalog / Dev | Keiner (öffentlich) | Nicht erforderlich | Öffentlich, schreibgeschützt |
| Admin | Authorization: Bearer <token> | Dashboard → API-Schlüssel / Connect AI | Pro Berechtigung (Lesen/Schreiben über 6 Ressourcen); CRM-Tools benötigen crm_suite |
| Storefront | X-Storefront-Token: <token> | Dashboard → Storefront-Tokens | Pro Store; Bereiche menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | Gast-Anmeldung (Registrierung / Login / OTP) | Nur das eigene Konto dieses Gasts |
Jeder Token ist auf 60 Anfragen/Minute und 1000/Stunde begrenzt. Der Storefront-Server erlaubt stattdessen 120/Minute. Wird ein Limit überschritten, wird HTTP 429 zurückgegeben: warten und erneut versuchen.
Secrets werden nur einmal angezeigt, ausschließlich als SHA-256-Hash gespeichert und können jederzeit über das Dashboard widerrufen werden.
Sicherheit
- Geringstmögliche Berechtigung vergeben. Admin-Token sind auf Berechtigungen begrenzt: Geben Sie einem Agenten nur die Berechtigungen, die er benötigt. Tools, die er nicht nutzen kann, werden vollständig aus seiner Tool-Liste ausgeblendet.
- Menschliche Bestätigung aktiviert lassen. Genehmigen Sie Schreibvorgänge nicht automatisch; jeder Schreibvorgang ist real und wird protokolliert über: mcp.
- Umgang mit Secrets. Token werden nur einmal angezeigt und gehasht gespeichert. Committen Sie sie niemals in Code oder Repositories; rotieren Sie sie bei Offenlegung.
- Bevorzugen Sie nach Möglichkeit schreibgeschützten Zugriff. Für Analyse- oder Shopping-Agenten ist ein auf Lesen beschränkter oder öffentlicher Server sicherer als einer mit Schreibzugriff.
Fragen? Gegangen
Was ist MCP?
Das Model Context Protocol ist ein offener Standard, der es KI-Agenten (Claude, Cursor, ChatGPT und anderen) ermöglicht, echte Tools auf einem Server aufzurufen, anstatt zu raten. Richten Sie einen Client auf einen unserer fünf Endpunkte, und der Agent kann Menüs durchsuchen, Bestellungen aufgeben, Ihre Verkäufe lesen oder ein Theme anhand von Live-Menubarcode-Daten validieren.
Welche Clients können sich verbinden?
Jeder MCP-fähige Client über Streamable HTTP: Claude Code, Claude (Web und Desktop), Cursor, VS Code, ChatGPT-Entwicklermodus, Windsurf, Zed oder reines curl. Die genaue Ein-Befehl-Einrichtung für jeden finden Sie im Abschnitt „Client verbinden“.
Welchen Server benötige ich?
Shopping-Agenten nutzen die öffentlichen Catalog- und Storefront-Server. Store-Besitzer nutzen den Admin-Server mit einem API-Token. Theme- und App-Entwickler nutzen den öffentlichen Dev-Server. Gäste nutzen den Customer-Server mit ihrem eigenen Login. Die Karten „Welchen Server benötigen Sie?“ ordnen jeder Zielgruppe ihren Server zu.
Ist es kostenlos?
Die Verbindung ist kostenlos. Die Catalog- und Dev-Server sind vollständig öffentlich: keine Anmeldung, kein Schlüssel. Die Admin-, Storefront- und Customer-Server benötigen ein Token, das Sie bereits als Besitzer, Store oder angemeldeter Gast besitzen.
Benötige ich einen API-Schlüssel?
Für zwei der fünf Server nicht. Catalog (Restaurants entdecken) und Dev (Themes erstellen) sind öffentlich und benötigen überhaupt keinen Schlüssel. Die anderen drei authentifizieren sich mit einem Token, das Sie in Ihrem Dashboard erzeugen oder bei der Anmeldung erhalten.
Wie werden Schreibvorgänge geschützt?
Jeder Schreibvorgang ist auf den Token-Besitzer beschränkt und wird als via: mcp protokolliert. Admin-Tokens sind berechtigungsbasiert begrenzt: Gewähren Sie nur, was der Agent benötigt, und Tools, für die keine Berechtigung besteht, werden komplett aus der Tool-Liste ausgeblendet. Lassen Sie die Bestätigungsabfrage Ihres Clients aktiviert, damit kein Tool ausgeführt wird, ohne dass Sie es sehen.
Wie hoch sind die Ratenlimits?
Jedes Token ist auf 60 Anfragen/Minute und 1000/Stunde begrenzt (der Storefront-Server erlaubt stattdessen 120/Minute). Ausreißer darüber hinaus liefern HTTP 429. Warten Sie und versuchen Sie es erneut.
Kann ich mein eigenes Theme oder meine eigene App erstellen?
Ja. Themes: Laden Sie das Starter-Theme herunter, entwickeln Sie mit der Liquid-Referenz und validieren Sie mit dem validate_theme-Tool des Dev-Servers, bevor Sie es im Marketplace einreichen. Apps: Registrieren Sie eine Partner-App für OAuth-Zugriff, Webhooks, eingebettete Dashboard-Oberflächen und Nutzungsabrechnung. Beide Anleitungen finden Sie unter /developers.
Kann meine White-Label-Domain es nutzen?
Ja. Jeder Server, Name und jede URL auf dieser Seite ist markenbewusst: Auf einer Reseller-Domain geben die Endpunkte die eigene Marke des Resellers und geslugte Servernamen an, niemals die der Plattform. Auch das Discovery-Manifest unter /.well-known/mcp.json ist markenbewusst.
Wie lasse ich meine gelisteten Daten entfernen?
Der öffentliche Catalog-Server listet nur aktive, öffentlich gelistete Stores auf und gibt niemals personenbezogene Daten des Besitzers preis. Deaktivieren Sie die öffentliche Auflistung für einen Store in dessen Dashboard-Einstellungen, und er erscheint nicht mehr in den Catalog-Ergebnissen.
