WhatsApp e automação

API MCP no restaurante: como gerenciar o Xefo conversando com a IA

Para saber quanto deve a mesa 5, quanto entra no caixa esta semana ou para trocar o preço de vinte itens, o dono abre três telas e perde meia hora. Com uma API MCP, isso vira uma pergunta para a IA.

Publicado em 02/11/2026 · Equipe Xefo

A maior parte das perguntas do dono de restaurante tem resposta dentro do sistema. O problema é o caminho até ela: abrir o relatório certo, escolher o filtro, somar duas telas, exportar para a planilha. No meio do movimento, ninguém faz isso. A pergunta fica sem resposta e a decisão sai no chute.

A API MCP muda esse caminho. Em vez de ir até o dado, você pede para a IA buscar, ou fazer a tarefa, e ela usa as funções do próprio sistema para isso. Este guia explica o que é, o que a API MCP do Xefo já faz no restaurante, como conectar hoje e o que olhar em segurança antes de ligar.

O que é MCP, sem jargão

MCP (Model Context Protocol) é um padrão aberto que permite a uma IA usar um sistema por conversa. Assistentes como o Claude, o ChatGPT, o Cursor ou um agente feito pela sua equipe falam esse padrão. Do outro lado, o sistema oferece ferramentas: "listar mesas", "consultar contas a receber", "atualizar preços em lote" e assim por diante.

Quando você faz um pedido, a IA entende o que precisa, escolhe a ferramenta, chama o sistema e responde em português com o resultado. Ela não inventa o número: busca no sistema.

No Xefo, a API MCP envelopa a API REST v1 do sistema. Cada ferramenta da IA corresponde a um endpoint da API, com as mesmas regras e permissões. Já são mais de 90 ferramentas no ar, cobrindo produtos, cardápio, salão, caixa, financeiro, estoque e fiscal.

O que muda na rotina do restaurante

A diferença aparece nas tarefas que hoje dependem de abrir tela, filtrar e somar, ou de digitar a mesma coisa muitas vezes:

Repare que as perguntas são as mesmas que você faria ao gerente. A diferença é que a resposta vem do sistema, na hora, sem depender de alguém parar o que está fazendo.

O que a IA já faz no Xefo, área por área

• Mesas e comandas (consulta): mesas livres e ocupadas e os itens em aberto de cada mesa ou comanda, com o total.
• Delivery e viagem (consulta): os pedidos de delivery e para viagem em aberto nas últimas 24 horas.
• Cardápio e produtos: cadastro de produtos e categorias, fotos, consulta de estoque e preço de vários itens de uma vez.
• Fiscal dos produtos: classificação fiscal automática, que sugere NCM, CEST, CFOP e IBS/CBS pelo nome do produto e grava no cadastro.
• Caixa: saldo, fechamentos e lançamentos, além do registro de sangria e suprimento.
• Financeiro: contas a pagar e a receber.
• NFC-e e NF-e: consulta, emissão e cancelamento de NFC-e; criação, emissão e consulta de NF-e, com a explicação do motivo de uma rejeição.
• Pedidos e orçamentos: criar, incluir e ajustar itens, converter orçamento em pedido e faturar.
• Estoque: entrada de mercadoria, ajuste, inventário, estoque mínimo e transferência entre lojas do mesmo grupo.
• Cadastros e configuração: clientes, usuários, importação de planilha de produtos, situação e vencimento do certificado digital e configuração fiscal da empresa.

No salão e no delivery a IA consulta, não lança. Pedido continua entrando pelo PDV, pela comanda do garçom, pelo autoatendimento, pelo cardápio digital e pelos aplicativos. A IA entra para responder e para tirar do seu caminho o trabalho de escritório: cadastro, preço, estoque, caixa e nota.

IA na gestão não é o mesmo que IA no WhatsApp

Vale separar duas coisas que costumam ser chamadas pelo mesmo nome. O atendente com inteligência no WhatsApp conversa com o cliente: mostra o cardápio, monta o pedido, informa a taxa de entrega e passa para um humano quando o assunto é reclamação ou exceção.

A API MCP conversa com você e a sua equipe. É a IA que você usa para consultar e operar o sistema por dentro. Uma não substitui a outra: o atendente cuida do canal de venda, a API MCP cuida da gestão. As duas dependem da mesma base, um cadastro de produtos e preços organizado.

Como conectar hoje

O caminho que funciona hoje tem três passos e é feito uma vez:

1. Gere a chave de integração. No Xefo, no cadastro da empresa, a área Chave de integração gera a chave. Se a empresa já usa outra integração, use a chave atual, porque gerar uma nova substitui a anterior e derruba as integrações que usam a antiga.
2. Configure o endereço da API MCP (https://app.mysebr.com.br/app/mcp) no arquivo de configuração local do Claude Desktop ou do Cursor (não pelo botão "Adicionar conector"), em outro cliente MCP que aceite o cabeçalho X-API-Key ou no agente da sua equipe, com a chave nesse cabeçalho. Para testes, existe o endereço de homologação (https://beta.mysebr.com.br/app/mcp).
3. Comece a pedir. Em português, como numa conversa.

E o ChatGPT e o claude.ai na web? Eles só aceitam conectores remotos com login pelo navegador (OAuth). Esse conector direto do Xefo está chegando. Até lá, o caminho é o aplicativo de desktop, o Cursor ou um agente próprio.

Segurança: o que conferir antes de ligar uma IA ao sistema

Ligar uma IA ao sistema que guarda vendas, caixa e notas fiscais pede o mesmo cuidado de dar acesso a um funcionário novo. Estas são as perguntas certas, e as respostas no caso do Xefo:

1. A IA passa pelas regras do sistema? Sim. Cada ferramenta chama uma função da API do Xefo, com as mesmas validações. O que o sistema não deixa fazer, a IA também não faz.
2. Dá para limitar o que ela acessa? Ainda não: hoje o acesso é pela chave de integração da empresa, que libera todas as ferramentas da empresa. O acesso por usuário, limitado por áreas (financeiro, vendas, estoque, cadastros, fiscal) e pelas permissões de cada pessoa, chega junto com o conector direto. Até lá, deixe a chave só com quem já pode operar o sistema inteiro.
3. Fica registrado? Toda chamada vai para o log de auditoria, que pode registrar qual pessoa delegou a tarefa à IA.
4. Existe limite de uso? Sim, os mesmos limites da API.
5. Onde fica a chave? Só na configuração do aplicativo. Trate como senha: não cole em conversa, planilha ou grupo de mensagens.

Por onde começar: cinco pedidos para a primeira semana

Comece pelas consultas, que não mudam nada, e só depois passe para as tarefas em lote:

1. "Quais mesas estão ocupadas agora?" Teste no meio do movimento e compare com o PDV.
2. "Qual o saldo do caixa?" Confira com o fechamento do dia, como no roteiro de fechamento de caixa do restaurante.
3. "Quanto tenho a pagar e a receber esta semana?" É a base do fluxo de caixa semanal.
4. "Sugira o NCM, o CFOP e o IBS/CBS destes produtos novos." Revise a sugestão com o contador antes de gravar. O assunto ganhou peso com o IBS e a CBS na NFC-e.
5. "Atualize o preço destes itens." Mande a lista, peça para a IA mostrar como fica e confirme.

Depois da primeira semana, a pergunta muda de "funciona?" para "o que mais eu delego?". A resposta costuma estar nos indicadores que o dono deveria olhar toda semana: cada um deles vira uma pergunta para a IA. E tudo sai do mesmo sistema que recebe o salão, o balcão, os aplicativos e o seu delivery próprio, sem comissão por pedido.