Menubarcode MCP
para cualquier agente de IA
Cinco servidores conectan a los agentes con menús en vivo, pedidos, analíticas y herramientas de temas. Dos de ellos no necesitan ningún registro.
Conéctese en menos de un minuto
Conecte su cliente
Cada fragmento apunta al servidor público Catalog, por lo que funciona tal cual sin ninguna configuración. Sustituya por cualquier endpoint de abajo; los servidores con token añaden --header "Authorization: Bearer YOUR_TOKEN".
Copiar el endpoint
La URL pública de Catalog. Se la proporcionará a su cliente en el paso 2.
https://menubarcode.com/mcp/catalogAñádalo a su cliente
Un comando en su terminal, luego ejecute /mcp para confirmar que se conectó:
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalogPara un servidor con token (por ejemplo, Admin), pase el encabezado:
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"En Claude en la web o de escritorio: Configuraciones → Conectores → Añadir conector personalizado, luego pegue la URL del endpoint del paso 1.
Instalación con un clic (abre Cursor):
O añádalo manualmente a ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}Instalación con un clic (abre VS Code):
O añádalo manualmente a .vscode/mcp.json. Nota: VS Code utiliza un esquema diferente (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}Active el modo desarrollador en ChatGPT, añada un conector personalizado y pegue la URL del servidor del paso 1.
Windsurf, Zed y otros clientes que esperan un comando envuelven el endpoint HTTP con mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}Los servidores hablan JSON-RPC 2.0 mediante un POST Streamable HTTP de respuesta única. Liste las herramientas:
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"}'Llamar a una herramienta (añada -H "Authorization: Bearer YOUR_TOKEN" para servidores con token):
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"}}}'Haga su primera pregunta
El agente llama a herramientas reales y responde con datos en vivo. Pruebe esto:
O deja que tu agente de programación lo configure
Pega esto en Claude Code, Cursor o cualquier agente de programación. Añade el servidor por ti, sin necesidad de 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.¿Está desarrollando o depurando en su lugar? La referencia detallada del protocolo está en /developers.
Cinco servidores, un protocolo
55 herramientas en 5 servidores. Dos son públicos. Todos hablan JSON-RPC 2.0 mediante Streamable HTTP POST.
| Servidor | Endpoint | Autenticación | Herramientas |
|---|---|---|---|
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 |
¿Qué servidor Tú necesita?
Elija su rol. Cada tarjeta señala el servidor correcto, su autenticación y sus herramientas.
OW Propietario de tienda
Gestione menús, pedidos, cupones y horarios, y lea sus propias analíticas desde su asistente de IA.
https://menubarcode.com/mcpHerramientas de Admin → Obtener un token (Connect AI) → Claves de API →
AG Creador de agente de compras
Descubra restaurantes en toda la plataforma, luego explore una tienda y realice un pedido sin pagar, con precio calculado por el servidor.
https://menubarcode.com/mcp/catalogDV Desarrollador de temas/apps
Conozca la plataforma, obtenga la referencia autorizada de Liquid y valide su tema con las propias verificaciones del marketplace, todo desde su editor.
https://menubarcode.com/mcp/devCU Comensal/cliente
Consulte sus propios pedidos, siga una entrega y reconstruya un pedido anterior como borrador desde un asistente con sesión iniciada.
https://menubarcode.com/mcp/customerHerramientas de Customer → Cómo funciona el inicio de sesión →
Desarrolle para Menubarcode
Publique un tema de storefront o una app de socio. El servidor público Dev convierte su editor en un experto de la plataforma mientras desarrolla.
TH Crear un tema
Temas de storefront basados en Liquid con secciones OS 2.0, un esquema de configuración tipado y el runtime de comercio completo.
- Descargue el tema inicial y abra la guía de temas: estructura del paquete, theme.json, secciones y la referencia de Drop.
- Conecte el servidor Dev y desarrolle con la referencia de Liquid y el esquema de secciones respondiendo desde su editor.
- Ejecute validate_theme antes de enviar: aplica las propias verificaciones del marketplace y enumera todos los errores.
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP Crea una app
Las apps de socios amplían el panel: acceso OAuth, tokens de sesión, superficies integradas, webhooks y facturación por uso.
- Lea la guía de la app: OAuth y tokens, ámbitos, apps integradas y eventos de webhook.
- Registre su app de socio, solicite solo los ámbitos que necesita y desarrolle contra una tienda de pruebas (sandbox).
- Cumple los requisitos de publicación y revisión, y luego envíala al marketplace de apps.
Mientras construyes, search_docs y fetch_full_doc en el servidor Dev responden preguntas de API y webhooks sin salir del editor.
Herramienta Catálogo
55 herramientas en 5 servidores. Expande un servidor para ver qué puede hacer su agente. Los esquemas JSON completos están en la referencia para desarrolladores.
menubarcode-catalog-mcp (4 herramientas) Público
Descubre restaurantes en toda la plataforma. Solo tiendas activas y con listado público; nunca datos personales del propietario.
search_stores | Busca restaurantes por nombre o tipo de cocina. |
search_items | Busca un plato en todas las tiendas ("quién vende shawarma cerca de mí"). |
get_store | Los detalles de una tienda más una pista de deep link hacia su servidor Storefront. |
menubarcode-storefront-mcp (13 herramientas) Sitio web: token
Todo lo que un agente de compras necesita en un restaurante. create_order realiza un pedido sin pagar cuyo precio calcula el servidor. Nunca envíes precios.
search_menu | Busca en el menú de esta tienda. |
get_item | Detalle completo de un artículo (variantes, extras, etiquetas). |
validate_cart | Revisa un carrito y obtén el total calculado por el servidor antes de pedir. |
create_order | Realiza un pedido sin pagar con precio calculado por el servidor. |
order_status | Estado actual de un pedido. |
order_eta | Tiempo estimado hasta que el pedido esté listo. |
order_history | Pedidos anteriores en esta tienda. |
reorder_last | Recrea el último pedido como un carrito nuevo. |
store_credit_balance | Crédito de la tienda disponible para el comprador. |
restaurant_info | Horario, dirección y opciones de pedido. |
suggest_upsell | Complementos relevantes para el carrito actual. |
dietary_answer | Responde una pregunta dietética sobre el menú. |
menubarcode-mcp (23 herramientas) Token de API
El conjunto de herramientas del propietario. Las herramientas están controladas por permisos según el token: todo lo que el token no pueda hacer se oculta de la lista. Las dos herramientas de CRM también requieren la función crm_suite. Cada escritura se audita mediante: mcp.
list_restaurants | Tus restaurantes |
get_menu | Las categorías y artículos de un restaurante. |
list_categories | Categorías del menú con el número de artículos. |
list_orders | Pedidos, filtrables por estado/fecha/búsqueda. |
get_order | Detalle completo de un pedido. |
get_analytics | Número de pedidos e ingresos durante N días. |
sales_report | Resumen de ventas oficial para un rango de fechas. |
get_restaurant_settings | Instantánea del perfil y la configuración de pedidos. |
list_coupons | Tus cupones de descuento. |
list_customers crm_suite | Tu lista de clientes del CRM. |
get_customer crm_suite | El registro completo de CRM de un cliente. |
add_menu_item | Crea un artículo del menú. |
update_menu_item | Edita el nombre/precio/descripción de un artículo. |
delete_menu_item | Elimina un artículo de forma permanente. |
set_item_availability | Marca un artículo como disponible o agotado (el interruptor "86"). |
add_category | Crea una categoría del menú. |
update_category | Cambia el nombre o el orden de una categoría. |
delete_category | Elimina una categoría vacía. |
update_order_status | Avanza el estado de un pedido. |
update_business_hours | Define el texto público del horario comercial. |
create_coupon | Crea un cupón de descuento. |
update_coupon | Edita un cupón. |
delete_coupon | Elimina un cupón. |
menubarcode-customer-mcp (7 herramientas) Token de Customer
La propia cuenta de un comensal que ha iniciado sesión. La identidad proviene únicamente del token; nunca se puede acceder a los datos de otro cliente.
my_orders | Tus pedidos recientes. |
order_detail | Detalle completo de uno de tus pedidos. |
track_order | Estado en tiempo real de tu pedido. |
reorder | Recrea un pedido anterior como borrador de carrito. |
my_profile | Tu perfil en este restaurante. |
menubarcode-dev-mcp (8 herramientas) Público
Convierte cualquier editor compatible con MCP en un experto de la plataforma: aprende, construye y valida sin salir del editor.
learn_platform | Introducción a la plataforma. Llama esto primero. |
get_liquid_reference | La lista blanca oficial de Liquid (generada en tiempo real). |
get_section_schema | El formato de bloque de esquema de sección de tema (ajustes, bloques, conexiones). |
search_docs | Búsqueda por palabras clave en la documentación para desarrolladores. |
fetch_full_doc | Obtén un documento completo por su ruta. |
validate_theme | Ejecuta las propias comprobaciones del marketplace sobre tus archivos de tema. |
submit_feedback | Informa una laguna en la documentación o algo incorrecto o faltante. |
Pruébalo ahora
Abre Claude con el prompt ya completado. Primero los prompts sin autenticación.
"Encuéntrame el shawarma mejor valorado cerca y muéstrame el menú."
"Valida mi tema según las reglas del marketplace de Menubarcode y enumera todos los errores."
"¿Cuáles fueron mis artículos más vendidos esta semana y qué ingresos generaron?"
"Añade un especial de Ramadán a mi menú por 25 SAR y márcalo como disponible."
"Vuelve a pedir lo de siempre en mi tienda favorita como borrador de carrito."
"Rastrea mi último pedido y dime el tiempo estimado de llegada."
Autenticación Tokens
Dos servidores son públicos. Los otros tres se autentican con un token que te pertenece.
| Servidor | Cómo se autentica el cliente | Dónde obtener el token | Alcance |
|---|---|---|---|
| Catalog / Dev | Ninguno (público) | No es necesario | Público, solo lectura |
| Admin | Authorization: Bearer <token> | Panel de Control → Claves de API / Connect AI | Por permiso (lectura/escritura en 6 recursos); las herramientas de CRM necesitan crm_suite |
| Storefront | X-Storefront-Token: <token> | Panel de Control → Tokens de la tienda | Por tienda; alcances menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | Inicio de sesión del comensal (registro / inicio de sesión / OTP) | Solo la cuenta de ese comensal |
Cada token está limitado a 60 solicitudes/minuto y 1000/hora. El servidor Storefront permite 120/minuto en su lugar. Superar un límite devuelve HTTP 429: espera y vuelve a intentarlo.
Los secretos se muestran una sola vez, se almacenan solo como un hash SHA-256 y pueden revocarse en cualquier momento desde el panel.
Seguridad
- Concede el mínimo privilegio. Los tokens de administrador tienen alcance por permisos: dale a un agente solo los permisos que necesita. Las herramientas que no puede usar quedan completamente ocultas de su lista de herramientas.
- Mantén activada la confirmación humana. No apruebes automáticamente las escrituras; cada escritura es real y se audita mediante: mcp.
- Higiene de secretos. Los tokens se muestran una sola vez y se almacenan cifrados con hash. Nunca los incluyas en código o repositorios; rótalos si se exponen.
- Prefiere el acceso de solo lectura cuando puedas. Para agentes de análisis o de compras, un servidor con alcance de solo lectura o público es más seguro que uno con capacidad de escritura.
¿Tienes preguntas? Se fue
¿Qué es MCP?
El Model Context Protocol es un estándar abierto que permite a los agentes de IA (Claude, Cursor, ChatGPT y otros) llamar a herramientas reales en un servidor en lugar de adivinar. Apunte un cliente a uno de nuestros cinco endpoints y el agente podrá explorar menús, realizar pedidos, leer sus ventas o validar un tema con datos en vivo de Menubarcode.
¿Qué clientes pueden conectarse?
Cualquier cliente compatible con MCP a través de Streamable HTTP: Claude Code, Claude (web y escritorio), Cursor, VS Code, modo desarrollador de ChatGPT, Windsurf, Zed o curl puro. Consulte la sección Conectar su cliente para la configuración exacta de un solo comando para cada uno.
¿Qué servidor necesito?
Los agentes de compra usan los servidores públicos Catalog y Storefront. Los propietarios de tiendas usan el servidor Admin con un token de API. Los desarrolladores de temas y apps usan el servidor público Dev. Los comensales usan el servidor Customer con su propio inicio de sesión. Las tarjetas «¿Qué servidor necesita?» asignan a cada público su servidor.
¿Es gratis?
Conectarse es gratis. Los servidores Catalog y Dev son totalmente públicos: sin registro, sin clave. Los servidores Admin, Storefront y Customer necesitan un token que ya posee como propietario, tienda o comensal con sesión iniciada.
¿Necesito una clave de API?
No para dos de los cinco servidores. Catalog (descubrir restaurantes) y Dev (crear temas) son públicos y no necesitan clave alguna. Los otros tres se autentican con un token que genera en su panel o recibe al iniciar sesión.
¿Cómo se protegen las escrituras?
Cada escritura está limitada al propietario del token y se audita como via: mcp. Los tokens de Admin tienen alcance por capacidad: conceda solo lo que el agente necesita, y las herramientas para las que no tiene permiso quedan totalmente ocultas de la lista. Mantenga activo el aviso de confirmación humana de su cliente para que ninguna herramienta se ejecute sin que usted lo vea.
¿Cuáles son los límites de velocidad?
Cada token está limitado a 60 solicitudes/minuto y 1000/hora (el servidor Storefront permite 120/minuto en su lugar). Los picos por encima de eso devuelven HTTP 429. Espere y vuelva a intentarlo.
¿Puedo crear mi propio tema o app?
Sí. Temas: descargue el tema inicial, desarrolle con la referencia de Liquid y valide con la herramienta validate_theme del servidor Dev antes de enviarlo al marketplace. Apps: registre una app de socio para acceso OAuth, webhooks, superficies de panel integradas y facturación por uso. Ambas guías están en /developers.
¿Puede usarlo mi dominio de marca blanca?
Sí. Cada servidor, nombre y URL en esta página reconoce la marca: en un dominio de revendedor, los endpoints muestran la marca propia del revendedor y nombres de servidor con slug, nunca los de la plataforma. El manifiesto de descubrimiento en /.well-known/mcp.json también reconoce la marca.
¿Cómo elimino mis datos listados?
El servidor público Catalog solo lista tiendas activas y públicamente listadas, y nunca expone datos personales del propietario. Desactive el listado público de una tienda en la configuración de su panel y dejará de aparecer en los resultados de Catalog.
