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

Claude Claude Code Cursor ChatGPT VS Code Windsurf

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

1

Copiar el endpoint

La URL pública de Catalog. Se la proporcionará a su cliente en el paso 2.

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

Añá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/catalog

Para 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"
3

Haga su primera pregunta

El agente llama a herramientas reales y responde con datos en vivo. Pruebe esto:

Abrir en Claude →

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.

ServidorEndpointAutenticaciónHerramientas
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 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.

Token de API 23 herramientas

https://menubarcode.com/mcp

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.

Catalog: público Sitio web: token 17 herramientas

https://menubarcode.com/mcp/catalog

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

Público 8 herramientas

https://menubarcode.com/mcp/dev

CU Comensal/cliente

Consulte sus propios pedidos, siga una entrega y reconstruya un pedido anterior como borrador desde un asistente con sesión iniciada.

Token de Customer 7 herramientas

https://menubarcode.com/mcp/customer

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.

  1. Descargue el tema inicial y abra la guía de temas: estructura del paquete, theme.json, secciones y la referencia de Drop.
  2. Conecte el servidor Dev y desarrolle con la referencia de Liquid y el esquema de secciones respondiendo desde su editor.
  3. 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/dev

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

  1. Lea la guía de la app: OAuth y tokens, ámbitos, apps integradas y eventos de webhook.
  2. Registre su app de socio, solicite solo los ámbitos que necesita y desarrolle contra una tienda de pruebas (sandbox).
  3. 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_storesBusca restaurantes por nombre o tipo de cocina.
search_itemsBusca un plato en todas las tiendas ("quién vende shawarma cerca de mí").
get_storeLos 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_menuBusca en el menú de esta tienda.
get_itemDetalle completo de un artículo (variantes, extras, etiquetas).
validate_cartRevisa un carrito y obtén el total calculado por el servidor antes de pedir.
create_orderRealiza un pedido sin pagar con precio calculado por el servidor.
order_statusEstado actual de un pedido.
order_etaTiempo estimado hasta que el pedido esté listo.
order_historyPedidos anteriores en esta tienda.
reorder_lastRecrea el último pedido como un carrito nuevo.
store_credit_balanceCrédito de la tienda disponible para el comprador.
restaurant_infoHorario, dirección y opciones de pedido.
suggest_upsellComplementos relevantes para el carrito actual.
dietary_answerResponde 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_restaurantsTus restaurantes
get_menuLas categorías y artículos de un restaurante.
list_categoriesCategorías del menú con el número de artículos.
list_ordersPedidos, filtrables por estado/fecha/búsqueda.
get_orderDetalle completo de un pedido.
get_analyticsNúmero de pedidos e ingresos durante N días.
sales_reportResumen de ventas oficial para un rango de fechas.
get_restaurant_settingsInstantánea del perfil y la configuración de pedidos.
list_couponsTus cupones de descuento.
list_customers crm_suiteTu lista de clientes del CRM.
get_customer crm_suiteEl registro completo de CRM de un cliente.
add_menu_itemCrea un artículo del menú.
update_menu_itemEdita el nombre/precio/descripción de un artículo.
delete_menu_itemElimina un artículo de forma permanente.
set_item_availabilityMarca un artículo como disponible o agotado (el interruptor "86").
add_categoryCrea una categoría del menú.
update_categoryCambia el nombre o el orden de una categoría.
delete_categoryElimina una categoría vacía.
update_order_statusAvanza el estado de un pedido.
update_business_hoursDefine el texto público del horario comercial.
create_couponCrea un cupón de descuento.
update_couponEdita un cupón.
delete_couponElimina 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_ordersTus pedidos recientes.
order_detailDetalle completo de uno de tus pedidos.
track_orderEstado en tiempo real de tu pedido.
reorderRecrea un pedido anterior como borrador de carrito.
my_profileTu 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_platformIntroducción a la plataforma. Llama esto primero.
get_liquid_referenceLa lista blanca oficial de Liquid (generada en tiempo real).
get_section_schemaEl formato de bloque de esquema de sección de tema (ajustes, bloques, conexiones).
search_docsBúsqueda por palabras clave en la documentación para desarrolladores.
fetch_full_docObtén un documento completo por su ruta.
validate_themeEjecuta las propias comprobaciones del marketplace sobre tus archivos de tema.
submit_feedbackInforma 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?"

Administrador Abrir en Claude →

"Añade un especial de Ramadán a mi menú por 25 SAR y márcalo como disponible."

Administrador Abrir en Claude →

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

ServidorCómo se autentica el clienteDónde obtener el tokenAlcance
Catalog / DevNinguno (público)No es necesarioPúblico, solo lectura
AdminAuthorization: Bearer <token>Panel de Control → Claves de API / Connect AIPor permiso (lectura/escritura en 6 recursos); las herramientas de CRM necesitan crm_suite
StorefrontX-Storefront-Token: <token>Panel de Control → Tokens de la tiendaPor tienda; alcances menu:read, order:write, agent
CustomerAuthorization: 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

Advertencia sobre inyección de prompts. Los resultados de las herramientas (texto del menú, notas de pedidos, documentos) pueden contener texto que intente dirigir a tu agente. Trata la salida de las herramientas como datos, no como instrucciones, y mantén activada la confirmación humana de tu cliente para las llamadas a herramientas.
  • 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.

Contáctanos

Síguenos