Menubarcode MCP
para qualquer agente de IA
Cinco servidores conectam agentes a cardápios ao vivo, pedidos, análises e ferramentas de temas. Dois deles não exigem nenhum cadastro.
Conecte-se em menos de um minuto
Conecte seu cliente
Cada trecho tem como alvo o servidor público Catalog, então funciona exatamente como está, sem nenhuma configuração. Substitua por qualquer endpoint abaixo; os servidores com token adicionam --header "Authorization: Bearer YOUR_TOKEN".
Copiar o endpoint
A URL pública do Catalog. Você a fornecerá ao seu cliente na etapa 2.
https://menubarcode.com/mcp/catalogAdicione-o ao seu cliente
Um comando no seu terminal, depois execute /mcp para confirmar que conectou:
claude mcp add --transport http menubarcode-catalog-mcp https://menubarcode.com/mcp/catalogPara um servidor com token (por exemplo, Admin), passe o cabeçalho:
claude mcp add --transport http menubarcode-mcp https://menubarcode.com/mcp --header "Authorization: Bearer YOUR_TOKEN"No Claude na web ou no desktop: Configurações → Conectores → Adicionar conector personalizado, depois cole a URL do endpoint da etapa 1.
Instalação com um clique (abre o Cursor):
Ou adicione manualmente ao ~/.cursor/mcp.json:
{
"mcpServers": {
"menubarcode-catalog-mcp": { "url": "https://menubarcode.com/mcp/catalog" }
}
}Instalação com um clique (abre o VS Code):
Ou adicione manualmente ao .vscode/mcp.json. Observação: o VS Code usa um esquema diferente (type + servers):
{
"servers": {
"menubarcode-catalog-mcp": { "type": "http", "url": "https://menubarcode.com/mcp/catalog" }
}
}Ative o modo desenvolvedor no ChatGPT, adicione um conector personalizado e cole a URL do servidor da etapa 1.
Windsurf, Zed e outros clientes que esperam um comando encapsulam o endpoint HTTP com mcp-remote:
{
"command": "npx",
"args": ["-y", "mcp-remote", "https://menubarcode.com/mcp/catalog"]
}Os servidores falam JSON-RPC 2.0 por meio de um POST Streamable HTTP de resposta única. Liste as ferramentas:
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"}'Chamar uma ferramenta (adicione -H "Authorization: Bearer YOUR_TOKEN" para servidores com 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"}}}'Faça sua primeira pergunta
O agente chama ferramentas reais e responde com dados ao vivo. Experimente isto:
Ou deixe seu agente de programação configurar
Cole isto no Claude Code, Cursor ou qualquer agente de programação. Ele adiciona o servidor para você, sem precisar 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á desenvolvendo ou depurando em vez disso? A referência detalhada do protocolo está em /developers.
Cinco servidores, um protocolo
55 ferramentas em 5 servidores. Dois são públicos. Todos falam JSON-RPC 2.0 por Streamable HTTP POST.
| Servidor | Endpoint | Autenticação | Ferramentas |
|---|---|---|---|
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 |
Qual servidor Você você precisa?
Escolha sua função. Cada cartão aponta para o servidor certo, sua autenticação e suas ferramentas.
OW Proprietário de loja
Gerencie cardápios, pedidos, cupons e horários, e leia suas próprias análises pelo seu assistente de IA.
https://menubarcode.com/mcpFerramentas do Admin → Obter um token (Connect AI) → Chaves de API →
AG Criador de agente de compras
Descubra restaurantes em toda a plataforma, depois navegue por uma loja e faça um pedido não pago, com preço definido pelo servidor.
https://menubarcode.com/mcp/catalogDV Desenvolvedor de temas/apps
Aprenda a plataforma, obtenha a referência oficial do Liquid e valide seu tema com as próprias verificações do marketplace, tudo no seu editor.
https://menubarcode.com/mcp/devCU Cliente/comensal
Consulte seus próprios pedidos, acompanhe uma entrega e recrie um pedido anterior como rascunho a partir de um assistente autenticado.
https://menubarcode.com/mcp/customerDesenvolva para Menubarcode
Publique um tema de storefront ou um app parceiro. O servidor público Dev transforma seu editor em um especialista da plataforma enquanto você desenvolve.
TH Criar um tema
Temas de storefront baseados em Liquid com seções OS 2.0, um esquema de configurações tipado e o runtime de comércio completo.
- Baixe o tema inicial e abra o guia de temas: estrutura do pacote, theme.json, seções e a referência de Drop.
- Conecte o servidor Dev e desenvolva com a referência Liquid e o esquema de seções respondendo a partir do seu editor.
- Execute validate_theme antes de enviar: ele aplica as próprias verificações do marketplace e lista todos os erros.
claude mcp add --transport http menubarcode-dev-mcp https://menubarcode.com/mcp/devAP Crie uma app
Os apps parceiros estendem o painel: acesso OAuth, tokens de sessão, superfícies incorporadas, webhooks e cobrança por uso.
- Leia o guia do app: OAuth e tokens, escopos, apps incorporados e eventos de webhook.
- Registre seu app parceiro, solicite apenas os escopos que você precisa e desenvolva contra uma loja sandbox.
- Atenda aos requisitos de listagem e revisão e depois envie para o marketplace de apps.
Enquanto você desenvolve, search_docs e fetch_full_doc no servidor Dev respondem perguntas sobre API e webhooks sem sair do editor.
Ferramenta Catálogo
55 ferramentas em 5 servidores. Expanda um servidor para ver o que seu agente pode fazer. Os esquemas JSON completos estão na referência para desenvolvedores.
menubarcode-catalog-mcp (4 ferramentas) Público
Descubra restaurantes em toda a plataforma. Apenas lojas ativas e listadas publicamente; nunca dados pessoais do proprietário.
search_stores | Encontre restaurantes por nome ou tipo de culinária. |
search_items | Pesquise um prato em todas as lojas ("quem vende shawarma perto de mim"). |
get_store | Os detalhes de uma loja mais uma dica de deep link para o seu servidor Storefront. |
menubarcode-storefront-mcp (13 ferramentas) Vitrine: token
Tudo o que um agente de compras precisa em um restaurante. create_order faz um pedido não pago com preço calculado pelo servidor. Nunca envie preços.
search_menu | Pesquise no cardápio desta loja. |
get_item | Detalhes completos de um item (variantes, adicionais, sinalizações). |
validate_cart | Verifique um carrinho e obtenha o total calculado pelo servidor antes de pedir. |
create_order | Faça um pedido não pago com preço definido pelo servidor. |
order_status | Status atual de um pedido. |
order_eta | Tempo estimado até o pedido ficar pronto. |
order_history | Pedidos anteriores nesta loja. |
reorder_last | Recrie o último pedido como um novo carrinho. |
store_credit_balance | Crédito da loja disponível para o comprador. |
restaurant_info | Horário, endereço e opções de pedido. |
suggest_upsell | Complementos relevantes para o carrinho atual. |
dietary_answer | Responda a uma pergunta dietética sobre o cardápio. |
menubarcode-mcp (23 ferramentas) Token de API
A caixa de ferramentas do proprietário. As ferramentas são controladas por permissão por token: tudo o que o token não pode fazer fica oculto da lista. As duas ferramentas de CRM também exigem o recurso crm_suite. Toda gravação é auditada via: mcp.
list_restaurants | Seus restaurantes |
get_menu | As categorias e itens de um restaurante. |
list_categories | Categorias do cardápio com contagem de itens. |
list_orders | Pedidos, filtráveis por status/data/busca. |
get_order | Detalhes completos de um pedido. |
get_analytics | Número de pedidos e receita ao longo de N dias. |
sales_report | Resumo de vendas oficial para um período de datas. |
get_restaurant_settings | Instantâneo do perfil e das configurações de pedidos. |
list_coupons | Seus cupons de desconto. |
list_customers crm_suite | Sua lista de clientes do CRM. |
get_customer crm_suite | O registro completo de CRM de um cliente. |
add_menu_item | Crie um item do cardápio. |
update_menu_item | Edite o nome/preço/descrição de um item. |
delete_menu_item | Exclua um item permanentemente. |
set_item_availability | Marque um item como disponível/indisponível (a alternância "86"). |
add_category | Crie uma categoria do cardápio. |
update_category | Renomeie ou reordene uma categoria. |
delete_category | Exclua uma categoria vazia. |
update_order_status | Avance o status de um pedido. |
update_business_hours | Defina o texto público do horário de funcionamento. |
create_coupon | Crie um cupom de desconto. |
update_coupon | Edite um cupom. |
delete_coupon | Exclua um cupom. |
menubarcode-customer-mcp (7 ferramentas) Token do Customer
A própria conta de um cliente autenticado. A identidade vem apenas do token; os dados de nenhum outro cliente jamais ficam acessíveis.
my_orders | Seus pedidos recentes. |
order_detail | Detalhes completos de um dos seus pedidos. |
track_order | Status em tempo real do seu pedido. |
reorder | Recrie um pedido anterior como rascunho de carrinho. |
my_profile | Seu perfil neste restaurante. |
menubarcode-dev-mcp (8 ferramentas) Público
Transforma qualquer editor compatível com MCP em um especialista na plataforma: aprenda, construa e valide sem sair do editor.
learn_platform | Introdução à plataforma. Chame isso primeiro. |
get_liquid_reference | A lista de permissões Liquid oficial (gerada em tempo real). |
get_section_schema | O formato de bloco de esquema de seção de tema (configurações, blocos, conexões). |
search_docs | Pesquisa por palavra-chave na documentação para desenvolvedores. |
fetch_full_doc | Busque um documento completo pelo caminho. |
validate_theme | Execute as próprias verificações do marketplace nos seus arquivos de tema. |
submit_feedback | Relate uma lacuna na documentação ou algo errado ou ausente. |
Experimente agora
Abra o Claude com o prompt pré-preenchido. Primeiro os prompts sem autenticação.
"Encontre para mim o shawarma mais bem avaliado por perto e mostre o cardápio."
"Valide meu tema de acordo com as regras do marketplace Menubarcode e liste todos os erros."
"Quais foram meus itens mais vendidos esta semana e quanta receita eles trouxeram?"
"Adicione um especial de Ramadã ao meu cardápio por 25 SAR e marque-o como disponível."
"Refaça meu pedido de sempre da minha loja favorita como rascunho de carrinho."
"Rastreie meu último pedido e me diga o tempo estimado de chegada."
Autenticação Tokens
Dois servidores são públicos. Os outros três se autenticam com um token que você possui.
| Servidor | Como o cliente se autentica | Onde obter o token | Escopo |
|---|---|---|---|
| Catalog / Dev | Nenhum (público) | Não necessário | Público, somente leitura |
| Admin | Authorization: Bearer <token> | Painel → Chaves de API / Connect AI | Por permissão (leitura/gravação em 6 recursos); as ferramentas de CRM precisam de crm_suite |
| Storefront | X-Storefront-Token: <token> | Painel → Tokens da loja | Por loja; escopos menu:read, order:write, agent |
| Customer | Authorization: Bearer <token> | Login do cliente (cadastro / login / OTP) | Somente a própria conta desse cliente |
Cada token é limitado a 60 solicitações/minuto e 1000/hora. O servidor Storefront permite 120/minuto em vez disso. Exceder um limite retorna HTTP 429: aguarde e tente novamente.
Os segredos são exibidos uma única vez, armazenados apenas como um hash SHA-256 e podem ser revogados a qualquer momento no painel.
Segurança
- Conceda o menor privilégio possível. Os tokens de administrador têm escopo por permissão: conceda a um agente apenas as permissões de que ele precisa. As ferramentas que ele não pode usar ficam totalmente ocultas da sua lista de ferramentas.
- Mantenha a confirmação humana ativada. Não aprove gravações automaticamente; toda gravação é real e auditada via: mcp.
- Higiene de segredos. Os tokens são exibidos uma única vez e armazenados com hash. Nunca os inclua em código ou repositórios; renove-os se forem expostos.
- Prefira acesso somente leitura sempre que possível. Para agentes de análise ou de compras, um servidor com escopo de leitura ou público é mais seguro do que um com capacidade de gravação.
Tem dúvidas? Saiu
O que é o MCP?
O Model Context Protocol é um padrão aberto que permite que agentes de IA (Claude, Cursor, ChatGPT e outros) chamem ferramentas reais em um servidor em vez de adivinhar. Aponte um cliente para um dos nossos cinco endpoints e o agente poderá navegar pelos cardápios, fazer pedidos, ler suas vendas ou validar um tema com dados ao vivo de Menubarcode.
Quais clientes podem se conectar?
Qualquer cliente compatível com MCP via Streamable HTTP: Claude Code, Claude (web e desktop), Cursor, VS Code, modo desenvolvedor do ChatGPT, Windsurf, Zed ou curl puro. Consulte a seção Conectar seu cliente para a configuração exata em um comando para cada um.
De qual servidor eu preciso?
Agentes de compras usam os servidores públicos Catalog e Storefront. Donos de lojas usam o servidor Admin com um token de API. Desenvolvedores de temas e apps usam o servidor público Dev. Clientes usam o servidor Customer com seu próprio login. Os cartões “De qual servidor você precisa?” mapeiam cada público ao seu servidor.
É gratuito?
Conectar-se é gratuito. Os servidores Catalog e Dev são totalmente públicos: sem cadastro, sem chave. Os servidores Admin, Storefront e Customer exigem um token que você já possui como proprietário, loja ou cliente autenticado.
Preciso de uma chave de API?
Não para dois dos cinco servidores. Catalog (descobrir restaurantes) e Dev (criar temas) são públicos e não precisam de chave alguma. Os outros três se autenticam com um token que você gera no seu painel ou recebe ao fazer login.
Como as gravações são protegidas?
Toda gravação é limitada ao proprietário do token e auditada como via: mcp. Os tokens de Admin têm escopo por capacidade: conceda apenas o que o agente precisa, e as ferramentas sem permissão ficam totalmente ocultas da lista. Mantenha ativado o aviso de confirmação humana do seu cliente para que nenhuma ferramenta seja executada sem que você veja.
Quais são os limites de taxa?
Cada token é limitado a 60 solicitações/minuto e 1000/hora (o servidor Storefront permite 120/minuto). Picos além disso retornam HTTP 429. Aguarde e tente novamente.
Posso criar meu próprio tema ou app?
Sim. Temas: baixe o tema inicial, desenvolva com a referência Liquid e valide com a ferramenta validate_theme do servidor Dev antes de enviar ao marketplace. Apps: registre um app parceiro para acesso OAuth, webhooks, superfícies de painel incorporadas e cobrança por uso. Os dois guias estão em /developers.
Meu domínio white-label pode usar isso?
Sim. Todo servidor, nome e URL nesta página é consciente da marca: em um domínio de revendedor, os endpoints exibem a marca própria do revendedor e nomes de servidor com slug, nunca os da plataforma. O manifesto de descoberta em /.well-known/mcp.json também é consciente da marca.
Como remover meus dados listados?
O servidor público Catalog lista apenas lojas ativas e publicamente listadas, e nunca expõe dados pessoais do proprietário. Desative a listagem pública de uma loja nas configurações do painel e ela deixará de aparecer nos resultados do Catalog.
