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

Claude Claude Code Cursor ChatGPT VS Code Windsurf

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

1

Endpunkt kopieren

Die öffentliche Catalog-URL. Sie geben sie in Schritt 2 an Ihren Client weiter.

https://menubarcode.com/mcp/catalog
2

Zu 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/catalog

Fü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"
3

Stellen Sie Ihre erste Frage

Der Agent ruft echte Tools auf und antwortet mit Live-Daten. Probieren Sie dies:

In Claude öffnen →

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.

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

API-Token 23 Tools

https://menubarcode.com/mcp

AG Shopping-Agent-Ersteller

Entdecken Sie Restaurants auf der gesamten Plattform, durchsuchen Sie dann einen Store und geben Sie eine unbezahlte, serverseitig bepreiste Bestellung auf.

Catalog: öffentlich Storefront: Token 17 Tools

https://menubarcode.com/mcp/catalog

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

Öffentlich 8 Tools

https://menubarcode.com/mcp/dev

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

Customer-Token 7 Tools

https://menubarcode.com/mcp/customer

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

  1. Laden Sie das Starter-Theme herunter und öffnen Sie den Theme-Guide: Paketstruktur, theme.json, Sections und die Drop-Referenz.
  2. Verbinden Sie den Dev-Server und entwickeln Sie mit der Liquid-Referenz und dem Section-Schema, die direkt aus Ihrem Editor antworten.
  3. 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/dev

AP App entwickeln

Partner-Apps erweitern das Dashboard: OAuth-Zugriff, Sitzungstokens, eingebettete Oberflächen, Webhooks und Nutzungsabrechnung.

  1. Lesen Sie den App-Guide: OAuth und Tokens, Scopes, eingebettete Apps und Webhook-Ereignisse.
  2. Registrieren Sie Ihre Partner-App, fordern Sie nur die benötigten Scopes an und entwickeln Sie gegen einen Sandbox-Store.
  3. 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_storesRestaurants nach Name oder Küche finden.
search_itemsEin Gericht in allen Stores suchen („Wer verkauft Schawarma in meiner Nähe?“).
get_storeDetails 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_menuDie Speisekarte dieses Stores durchsuchen.
get_itemVollständige Details zu einem Artikel (Varianten, Extras, Kennzeichnungen).
validate_cartEinen Warenkorb prüfen und vor der Bestellung die vom Server berechnete Summe abrufen.
create_orderEine unbezahlte, vom Server bepreiste Bestellung aufgeben.
order_statusAktueller Status einer Bestellung.
order_etaGeschätzte Zeit, bis die Bestellung fertig ist.
order_historyBisherige Bestellungen bei diesem Store.
reorder_lastDie letzte Bestellung als neuen Warenkorb wiederherstellen.
store_credit_balanceFür den Käufer verfügbares Store-Guthaben.
restaurant_infoÖffnungszeiten, Adresse und Bestelloptionen.
suggest_upsellRelevante Add-ons für den aktuellen Warenkorb.
dietary_answerEine 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_restaurantsDeine Restaurants
get_menuDie Kategorien und Artikel eines Restaurants.
list_categoriesMenükategorien mit Artikelanzahl.
list_ordersBestellungen, filterbar nach Status/Datum/Suche.
get_orderVollständige Details zu einer Bestellung.
get_analyticsBestellanzahl und Umsatz über N Tage.
sales_reportMaßgebliche Umsatzübersicht für einen Zeitraum.
get_restaurant_settingsMomentaufnahme von Profil- und Bestelleinstellungen.
list_couponsIhre Rabattgutscheine.
list_customers crm_suiteIhre CRM-Kundenliste.
get_customer crm_suiteDer vollständige CRM-Datensatz eines Kunden.
add_menu_itemEinen Menüartikel erstellen.
update_menu_itemName/Preis/Beschreibung eines Artikels bearbeiten.
delete_menu_itemEinen Artikel dauerhaft löschen.
set_item_availabilityEinen Artikel als vorrätig/ausverkauft markieren (die „86“-Umschaltung).
add_categoryEine Menükategorie erstellen.
update_categoryEine Kategorie umbenennen oder neu anordnen.
delete_categoryEine leere Kategorie löschen.
update_order_statusDen Status einer Bestellung vorantreiben.
update_business_hoursDen öffentlichen Text der Öffnungszeiten festlegen.
create_couponEinen Rabattgutschein erstellen.
update_couponEinen Gutschein bearbeiten.
delete_couponEinen 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_ordersIhre letzten Bestellungen.
order_detailVollständige Details zu einer Ihrer Bestellungen.
track_orderLive-Status Ihrer Bestellung.
reorderEine frühere Bestellung als Warenkorbentwurf wiederherstellen.
my_profileIhr 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_platformEinführung in die Plattform. Rufen Sie dies zuerst auf.
get_liquid_referenceDie maßgebliche Liquid-Whitelist (live generiert).
get_section_schemaDas Schema-Blockformat für Theme-Sektionen (Einstellungen, Blöcke, Verknüpfungen).
search_docsStichwortsuche in der Entwicklerdokumentation.
fetch_full_docEin vollständiges Dokument anhand des Pfads abrufen.
validate_themeFühren Sie die eigenen Prüfungen des Marktplatzes für Ihre Theme-Dateien aus.
submit_feedbackEine 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.

ServerWie sich der Client authentifiziertWo Sie den Token erhaltenUmfang
Catalog / DevKeiner (öffentlich)Nicht erforderlichÖffentlich, schreibgeschützt
AdminAuthorization: Bearer <token>Dashboard → API-Schlüssel / Connect AIPro Berechtigung (Lesen/Schreiben über 6 Ressourcen); CRM-Tools benötigen crm_suite
StorefrontX-Storefront-Token: <token>Dashboard → Storefront-TokensPro Store; Bereiche menu:read, order:write, agent
CustomerAuthorization: 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

Warnung vor Prompt-Injection. Tool-Ergebnisse (Menütext, Bestellnotizen, Dokumente) können Text enthalten, der versucht, Ihren Agenten zu steuern. Behandeln Sie Tool-Ausgaben als Daten, nicht als Anweisungen, und lassen Sie die menschliche Bestätigungsabfrage Ihres Clients für Tool-Aufrufe aktiviert.
  • 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.

Kontaktieren Sie uns

Folgen Sie uns