A Era dos Agentes Chegou ao Delivery: Como Transformei o Cardápio do IBN Battuta com o Protocolo WebMCP

A Era dos Agentes Chegou ao Delivery: Como Transformei o Cardápio do IBN Battuta com o Protocolo WebMCP

Como webmaster e desenvolvedor, há anos venho acompanhando a evolução da internet: saímos dos sites estáticos dos anos 2000, passamos pelas SPAs interativas da última década e agora entramos oficialmente na Web Agêntica — onde o usuário não navega mais apenas clicando botão por botão, mas interage com a web através de agentes de Inteligência Artificial autônomos.

Recentemente, tive a honra de projetar e colocar no ar uma inovação pioneira no setor gastronômico de Teresópolis e do Brasil: o suporte nativo ao protocolo WebMCP (Web Model Context Protocol) no cardápio digital do IBN Battuta Esfihas.

O Desafio: Indo Além dos Cardápios Tradicionais

Aplicativos de entrega tradicionais e cardápios digitais convencionais costumam sofrer do mesmo mal: fricção. O cliente precisa baixar um app de 100MB, criar conta, navegar por dezenas de telas, selecionar categoria, descer scroll e torcer para o carrinho não zerar no meio do caminho.

Minha premissa no projeto do IBN Battuta foi direta: como permitir que o cliente peça suas esfihas artesanais favoritas em menos de 10 segundos, seja pelo próprio celular ou delegando para sua IA de confiança (ChatGPT, Claude, Gemini ou assistentes por voz)?

A resposta foi construir a ponte perfeita entre a interface visual humana e o protocolo padronizado para robôs.

O Que É o WebMCP e Como Ele Funciona na Prática?

Até pouco tempo, quando uma IA tentava interagir com uma página web, ela dependia de screen scraping e automação de cliques no DOM — um processo frágil que quebrava a qualquer mudança de layout ou cor.

O WebMCP (Web Model Context Protocol), derivado das discussões da W3C Web Machine Learning Community Group e do padrão aberto da Anthropic, resolve isso na raiz. O site declara explicitamente suas capacidades como ferramentas executáveis (tools) com tipagem e schemas JSON estritos.

No IBN Battuta, desenvolvi uma camada dupla:

1. Client-Side WebMCP (Browser-Native): Registrado diretamente em navigator.modelContext e window.webmcp no navegador do cliente. Quando um agente acessa a página, ele tem acesso imediato a 10 ferramentas reativas que manipulam o carrinho, validam endereço e acionam o checkout.
2. Server-Side MCP JSON-RPC 2.0: Um endpoint oficial em /api/mcp e manifesto de autodescoberta em /.well-known/mcp.json, permitindo que agentes externos de servidor (como Claude Desktop ou instâncias autônomas) consultem cardápio e gerem pedidos via requisições HTTP seguras.

O Catálogo de 10 Ferramentas Integradas

Diferente de uma simples API genérica, cada ferramenta foi calibrada para a realidade da cozinha e da logística de Teresópolis:

• consultar_cardapio: Lista esfihas tradicionais, especiais, doces, kibes e bebidas com preços atualizados.
• consultar_status_loja: Checa se o forno está aceso e pronto para pedidos no horário de funcionamento.
• calcular_taxa_entrega: Mapeia o frete exato para os 30 bairros atendidos em Teresópolis (Várzea, Agriões, Alto, Tijuca, Ermitage, Barra, etc.).
• adicionar_ao_carrinho & remover_do_carrinho: Manipulação direta com feedback sonoro e visual reativo na tela.
• ver_carrinho & limpar_carrinho: Inspeção de itens, subtotal e valor mínimo.
• preencher_dados_entrega: Validação de endereço e integração com ViaCEP.
• finalizar_pedido: Submissão do pedido, acionamento do Asaas para PIX instantâneo e despacho direto para a cozinha.
• consultar_pedido: Acompanhamento em tempo real do status de preparo e entrega.

Segurança Blindada: Financeiro, Horários e Logística

Um dos pontos mais críticos em permitir que IAs realizem pedidos é a segurança. Como garantir que um robô não mande um preço falso de R$ 0,01 ou peça entrega fora do horário?

A arquitetura foi desenhada com Zero Trust:

• Cálculo Financeiro Autorizado: O cliente ou agente pode escolher os itens, mas o recálculo dos preços é feito integralmente no servidor através da base autoritativa de produtos. Preços manipulados são sumariamente descartados.
• Travamento de Frete por Bairro: O agente não pode inventar taxas; o sistema confere a tabela oficial de bairros e recusa entregas fora do perímetro mapeado.
• Filtro Rígido de Expediente: O backend valida o relógio oficial no fuso America/Sao_Paulo e os dias da semana ativos (Segunda a Sábado, das 09h às 23h). Tentativas de pedidos com a loja fechada são bloqueadas com código de erro padronizado.
• PIX Instantâneo Oficial: Integração com conta jurídica no Asaas que gera QR Code e Copia-e-Cola no mesmo segundo, com conciliação automática via webhook.

AEO: Otimizando para Motores de Inteligência Artificial

Além do WebMCP, implementamos um pacote completo de AEO (Agent Engine Optimization):

• Publicação dos arquivos llms.txt e llms-full.txt para alimentar com dados limpos modelos de linguagem como SearchGPT, Perplexity e Gemini.
• Configuração amigável de robots.txt autorizando robôs legítimos de IA.
• Metadados semânticos Schema.org (tipo Restaurant e OrderAction) integrados ao HTML da página.

Como Testar Agora Mesmo?

Se você tem curiosidade de ver o futuro do e-commerce rodando hoje:

1. Acesse esfihasbattuta.com.br no seu navegador.
2. Repare no botão flutuante 🤖 WebMCP Ativo no canto inferior esquerdo. Ao clicar nele, você abre um painel interativo de testes com histórico em tempo real e botões de teste rápido.
3. Ou abra o console do desenvolvedor (F12) e digite:
   window.webmcp.adicionarAoCarrinho({ nomeItem: "Esfiha de Carne", quantidade: 5 })

Desenvolver soluções que unam a paixão artesanal de um cliente com a ponta da tecnologia mundial é o que move o meu trabalho. O futuro não é esperar as IAs chegarem — é construir as portas para que elas já possam entrar.

Um abraço,
Diniz Webmaster