Menubarcode MCP
pour tout agent IA
Cinq serveurs connectent les agents aux menus en direct, aux commandes, aux analyses et aux outils de thèmes. Deux d'entre eux ne nécessitent aucune inscription.
Connectez-vous en moins d'une minute
Connectez votre client
Chaque extrait cible le serveur public Catalog, il fonctionne donc tel quel sans aucune configuration. Remplacez par n'importe quel endpoint ci-dessous ; les serveurs à jeton ajoutent --header "Authorization: Bearer YOUR_TOKEN".
Copier l'endpoint
L'URL publique de Catalog. Vous la transmettrez à votre client à l'étape 2.
https://menubarcode.com/mcp/catalogAjoutez-le à votre client
Une commande dans votre terminal, puis exécutez /mcp pour confirmer la connexion :
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalogPour un serveur à jeton (par exemple Admin), transmettez l'en-tête :
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"Dans Claude sur le web ou sur ordinateur : Paramètres → Connecteurs → Ajouter un connecteur personnalisé, puis collez l'URL de l'endpoint de l'étape 1.
Installation en un clic (ouvre Cursor) :
Ou ajoutez-le manuellement à ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}Installation en un clic (ouvre VS Code) :
Ou ajoutez-le manuellement à .vscode/mcp.json. Remarque : VS Code utilise un schéma différent (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}Activez le mode développeur dans ChatGPT, ajoutez un connecteur personnalisé, et collez l'URL du serveur de l'étape 1.
Windsurf, Zed et les autres clients qui attendent une commande encapsulent l'endpoint HTTP avec mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}Les serveurs parlent JSON-RPC 2.0 via un POST Streamable HTTP à réponse unique. Listez les outils :
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"}'Appeler un outil (ajoutez -H "Authorization: Bearer YOUR_TOKEN" pour les serveurs à jeton) :
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"}}}'Posez votre première question
L'agent appelle de vrais outils et répond avec des données en direct. Essayez ceci :
Ou laissez votre agent de code le configurer
Collez ceci dans Claude Code, Cursor ou n'importe quel agent de code. Il ajoute le serveur pour vous, sans 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.Vous développez ou déboguez plutôt ? La référence détaillée du protocole se trouve à /developers.
Cinq serveurs, un protocole
55 outils répartis sur 5 serveurs. Deux sont publics. Tous parlent JSON-RPC 2.0 via Streamable HTTP POST.
| Serveur | Point de terminaison | Authentification | Outils |
|---|---|---|---|
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 |
De quel serveur Vous avez-vous besoin ?
Choisissez votre rôle. Chaque carte indique le bon serveur, son authentification et ses outils.
OW Propriétaire de boutique
Gérez les menus, les commandes, les coupons, les horaires et consultez vos propres analyses depuis votre assistant IA.
https://menubarcode.com/mcpAG Créateur d'agent d'achat
Découvrez des restaurants sur toute la plateforme, puis parcourez une boutique et passez une commande non payée, tarifée par le serveur.
https://menubarcode.com/mcp/catalogDV Développeur de thèmes/applications
Découvrez la plateforme, accédez à la référence Liquid officielle et validez votre thème grâce aux propres contrôles de la marketplace, le tout depuis votre éditeur.
https://menubarcode.com/mcp/devCU Client / consommateur
Consultez vos propres commandes, suivez une livraison et recréez une commande passée en brouillon depuis un assistant connecté.
https://menubarcode.com/mcp/customerDéveloppez pour Menubarcode
Publiez un thème de storefront ou une application partenaire. Le serveur public Dev transforme votre éditeur en expert de la plateforme pendant que vous développez.
TH Créer un thème
Thèmes de storefront basés sur Liquid avec des sections OS 2.0, un schéma de paramètres typé et le runtime commerce complet.
- Téléchargez le thème de démarrage et ouvrez le guide des thèmes : structure du package, theme.json, sections et la référence Drop.
- Connectez le serveur Dev et développez avec la référence Liquid et le schéma des sections qui répondent depuis votre éditeur.
- Exécutez validate_theme avant de soumettre : il applique les propres contrôles de la marketplace et liste chaque erreur.
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP Créer une app
Les applications partenaires étendent le tableau de bord : accès OAuth, jetons de session, surfaces intégrées, webhooks et facturation à l'usage.
- Lisez le guide de l'application : OAuth et jetons, scopes, applications intégrées et événements webhook.
- Enregistrez votre application partenaire, demandez uniquement les scopes dont vous avez besoin, et développez sur une boutique sandbox.
- Répondez aux exigences de référencement et de vérification, puis soumettez votre app au marketplace.
Pendant que vous développez, search_docs et fetch_full_doc sur le serveur Dev répondent aux questions sur l'API et les webhooks sans quitter l'éditeur.
Outil Catalogue
55 outils répartis sur 5 serveurs. Développez un serveur pour voir ce que son agent peut faire. Les schémas JSON complets se trouvent dans la référence développeur.
menubarcode-catalog-mcp (4 outils) Public
Découvrez des restaurants sur toute la plateforme. Uniquement des boutiques actives et référencées publiquement ; jamais de données personnelles du propriétaire.
search_stores | Recherchez des restaurants par nom ou type de cuisine. |
search_items | Recherchez un plat dans toutes les boutiques (« qui vend du shawarma près de chez moi »). |
get_store | Les détails d'une boutique ainsi qu'une indication de lien profond vers son serveur Storefront. |
menubarcode-storefront-mcp (13 outils) Storefront : jeton
Tout ce dont un agent d'achat a besoin pour un restaurant. create_order passe une commande non payée dont le prix est calculé par le serveur. N'envoyez jamais de prix.
search_menu | Recherchez dans le menu de cette boutique. |
get_item | Détails complets d'un article (variantes, suppléments, indicateurs). |
validate_cart | Vérifiez un panier et obtenez le total calculé par le serveur avant de commander. |
create_order | Passez une commande non payée dont le prix est fixé par le serveur. |
order_status | État actuel d'une commande. |
order_eta | Temps estimé avant que la commande soit prête. |
order_history | Commandes passées dans cette boutique. |
reorder_last | Recréez la dernière commande sous forme de nouveau panier. |
store_credit_balance | Crédit boutique disponible pour l'acheteur. |
restaurant_info | Horaires, adresse et options de commande. |
suggest_upsell | Suppléments pertinents pour le panier actuel. |
dietary_answer | Répondez à une question diététique sur le menu. |
menubarcode-mcp (23 outils) Jeton API
La boîte à outils du propriétaire. Les outils sont contrôlés par les autorisations du jeton : tout ce que le jeton ne peut pas faire est masqué de la liste. Les deux outils CRM nécessitent également la fonctionnalité crm_suite. Chaque écriture est auditée via : mcp.
list_restaurants | Vos restaurants |
get_menu | Les catégories et articles d'un restaurant. |
list_categories | Catégories du menu avec le nombre d'articles. |
list_orders | Commandes, filtrables par statut/date/recherche. |
get_order | Détails complets d'une commande. |
get_analytics | Nombre de commandes et chiffre d'affaires sur N jours. |
sales_report | Résumé des ventes officiel pour une plage de dates. |
get_restaurant_settings | Aperçu du profil et des paramètres de commande. |
list_coupons | Vos coupons de réduction. |
list_customers crm_suite | Votre liste de clients CRM. |
get_customer crm_suite | La fiche CRM complète d'un client. |
add_menu_item | Créez un article de menu. |
update_menu_item | Modifiez le nom, le prix ou la description d'un article. |
delete_menu_item | Supprimez définitivement un article. |
set_item_availability | Marquez un article comme disponible ou en rupture de stock (le bouton « 86 »). |
add_category | Créez une catégorie de menu. |
update_category | Renommez ou réorganisez une catégorie. |
delete_category | Supprimez une catégorie vide. |
update_order_status | Faites avancer le statut d'une commande. |
update_business_hours | Définissez le texte public des horaires d'ouverture. |
create_coupon | Créez un coupon de réduction. |
update_coupon | Modifiez un coupon. |
delete_coupon | Supprimez un coupon. |
menubarcode-customer-mcp (7 outils) Jeton Customer
Le propre compte d'un client connecté. L'identité provient uniquement du jeton ; les données d'aucun autre client ne sont jamais accessibles.
my_orders | Vos commandes récentes. |
order_detail | Détails complets de l'une de vos commandes. |
track_order | Statut en direct de votre commande. |
reorder | Recréez une commande passée sous forme de brouillon de panier. |
my_profile | Votre profil dans ce restaurant. |
menubarcode-dev-mcp (8 outils) Public
Transforme n'importe quel éditeur compatible MCP en expert de la plateforme : apprenez, développez, validez, sans quitter votre éditeur.
learn_platform | Introduction à la plateforme. Appelez-la en premier. |
get_liquid_reference | La liste blanche Liquid officielle (générée en direct). |
get_section_schema | Le format de bloc de schéma des sections de thème (paramètres, blocs, câblage). |
search_docs | Recherche par mot-clé dans la documentation développeur. |
fetch_full_doc | Récupérez un document complet à partir de son chemin. |
validate_theme | Exécutez les propres vérifications du marketplace sur vos fichiers de thème. |
submit_feedback | Signalez une lacune dans la documentation ou quelque chose d'incorrect ou de manquant. |
Essayez maintenant
Ouvrez Claude avec l'invite déjà remplie. D'abord les invites sans authentification.
"Trouve-moi le meilleur shawarma noté à proximité et montre-moi le menu."
"Validez mon thème selon les règles du marketplace Menubarcode et listez toutes les erreurs."
"Quels ont été mes articles les plus vendus cette semaine, et quel chiffre d'affaires ont-ils généré ?"
"Ajoutez une offre spéciale Ramadan à mon menu pour 25 SAR et marquez-la comme disponible."
"Recommandez mon habitude dans ma boutique préférée sous forme de brouillon de panier."
"Suivez ma dernière commande et indiquez-moi l'heure d'arrivée estimée."
Authentification Jetons
Deux serveurs sont publics. Les trois autres s'authentifient avec un jeton que vous possédez.
| Serveur | Comment le client s'authentifie | Où obtenir le jeton | Portée |
|---|---|---|---|
| Catalog / Dev | Aucun (public) | Non nécessaire | Public, lecture seule |
| Admin | Authorization: Bearer <token> | Tableau de bord → Clés API / Connect AI | Par autorisation (lecture/écriture sur 6 ressources) ; les outils CRM nécessitent crm_suite |
| Storefront | X-Storefront-Token: <token> | Tableau de bord → Jetons de vitrine | Par boutique ; portées menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | Connexion client (inscription / connexion / OTP) | Uniquement le propre compte de ce client |
Chaque jeton est limité à 60 requêtes/minute et 1000/heure. Le serveur Storefront autorise 120/minute à la place. Dépasser une limite renvoie HTTP 429 : patientez puis réessayez.
Les secrets ne s'affichent qu'une seule fois, sont stockés uniquement sous forme de hachage SHA-256 et peuvent être révoqués à tout moment depuis le tableau de bord.
Sécurité
- Accordez le privilège minimal. Les jetons administrateur sont délimités par autorisations : n'accordez à un agent que les autorisations dont il a besoin. Les outils qu'il ne peut pas utiliser sont entièrement masqués de sa liste d'outils.
- Gardez la confirmation humaine activée. N'approuvez pas automatiquement les écritures ; chaque écriture est réelle et auditée via : mcp.
- Hygiène des secrets. Les jetons ne s'affichent qu'une seule fois et sont stockés hachés. Ne les intégrez jamais dans du code ou des dépôts ; renouvelez-les en cas d'exposition.
- Privilégiez l'accès en lecture seule lorsque c'est possible. Pour les agents d'analyse ou d'achat, un serveur à portée de lecture seule ou public est plus sûr qu'un serveur capable d'écrire.
Des questions ? Parti
Qu'est-ce que MCP ?
Le Model Context Protocol est une norme ouverte qui permet aux agents IA (Claude, Cursor, ChatGPT et autres) d'appeler de vrais outils sur un serveur au lieu de deviner. Pointez un client vers l'un de nos cinq endpoints et l'agent pourra parcourir les menus, passer des commandes, lire vos ventes ou valider un thème avec les données en direct de Menubarcode.
Quels clients peuvent se connecter ?
Tout client compatible MCP via Streamable HTTP : Claude Code, Claude (web et bureau), Cursor, VS Code, mode développeur ChatGPT, Windsurf, Zed ou curl brut. Consultez la section Connecter votre client pour la configuration en une commande propre à chacun.
De quel serveur ai-je besoin ?
Les agents d'achat utilisent les serveurs publics Catalog et Storefront. Les propriétaires de boutiques utilisent le serveur Admin avec un jeton API. Les développeurs de thèmes et d'applications utilisent le serveur public Dev. Les clients utilisent le serveur Customer avec leur propre connexion. Les cartes « De quel serveur avez-vous besoin ? » associent chaque public à son serveur.
Est-ce gratuit ?
La connexion est gratuite. Les serveurs Catalog et Dev sont entièrement publics : pas d'inscription, pas de clé. Les serveurs Admin, Storefront et Customer nécessitent un jeton que vous possédez déjà en tant que propriétaire, boutique ou client connecté.
Ai-je besoin d'une clé API ?
Pas pour deux des cinq serveurs. Catalog (découvrir des restaurants) et Dev (créer des thèmes) sont publics et ne nécessitent aucune clé. Les trois autres s'authentifient avec un jeton que vous générez dans votre tableau de bord ou recevez à la connexion.
Comment les écritures sont-elles protégées ?
Chaque écriture est limitée au propriétaire du jeton et auditée comme via: mcp. Les jetons Admin sont limités par capacité : n'accordez que ce dont l'agent a besoin, et les outils non autorisés sont entièrement masqués de la liste des outils. Laissez activée l'invite de confirmation humaine de votre client afin qu'aucun outil ne s'exécute sans que vous le voyiez.
Quelles sont les limites de débit ?
Chaque jeton est limité à 60 requêtes/minute et 1000/heure (le serveur Storefront autorise 120/minute à la place). Les pics au-delà renvoient HTTP 429. Patientez puis réessayez.
Puis-je créer mon propre thème ou ma propre application ?
Oui. Thèmes : téléchargez le thème de démarrage, développez avec la référence Liquid, et validez avec l'outil validate_theme du serveur Dev avant de le soumettre à la marketplace. Applications : enregistrez une application partenaire pour l'accès OAuth, les webhooks, les surfaces de tableau de bord intégrées et la facturation à l'usage. Les deux guides se trouvent sous /developers.
Mon domaine en marque blanche peut-il l'utiliser ?
Oui. Chaque serveur, nom et URL de cette page tient compte de la marque : sur un domaine revendeur, les endpoints affichent la propre marque du revendeur et des noms de serveur slugifiés, jamais ceux de la plateforme. Le manifeste de découverte à /.well-known/mcp.json en tient compte également.
Comment faire retirer mes données répertoriées ?
Le serveur public Catalog ne répertorie que les boutiques actives et listées publiquement, et n'expose jamais les données personnelles du propriétaire. Désactivez le référencement public d'une boutique dans ses paramètres de tableau de bord et elle cessera d'apparaître dans les résultats de Catalog.
