Novo: Totem de checkout: o cliente lê a comanda, paga sozinho e sai sem fila Totem de checkout: pague a comanda sozinho Conhecer
Início › Gestão › API MCP do Xefo
No ar · API MCP do Xefo

Gerencie o restaurante conversando com a IA

A API MCP do Xefo deixa uma IA usar o sistema por conversa. Pergunte quais mesas estão ocupadas, peça para cadastrar 50 produtos com o NCM certo ou para faturar um pedido: a IA faz pelo Xefo, com as mesmas regras e permissões.

Mais de 100 ferramentas No Claude com o seu login Auditoria em cada chamada
Dono do restaurante pergunta à IA quais mesas estão ocupadas e quanto tem a receber na semana; a IA responde usando as ferramentas do Xefo pela API MCP
Como funciona

Da pergunta à resposta

A IA não adivinha: ela usa as ferramentas do Xefo e responde com os dados do seu restaurante.

1Adicione o conectorNo Claude, em Configurações → Conectores
2Entre com o seu loginO mesmo login e senha do Xefo
3Peça em portuguêsComo numa conversa com o gerente
4A IA usa o XefoCom as suas permissões e auditoria
Por que usar

Menos tela, mais decisão

Pergunte em vez de procurar

"Quanto deve a mesa 5?" ou "quanto tenho a receber esta semana?": a resposta vem dos dados do Xefo, sem montar relatório.

Tarefa repetida em lote

Cadastrar 50 produtos ou atualizar o preço de vários itens vira um pedido só, em vez de uma tarde de digitação.

Fiscal sem decorar código

A classificação fiscal automática sugere NCM, CEST, CFOP e IBS/CBS pelo nome do produto.

O salão na conversa

Mesas ocupadas, itens em aberto e pedidos de delivery pendentes, consultados de onde você estiver.

As mesmas regras do sistema

Cada ferramenta é uma função da API do Xefo: o que o sistema não deixa fazer, a IA também não faz.

Tudo registrado

Cada chamada da IA vai para o log de auditoria, inclusive quem delegou a tarefa.

O que é

MCP, em uma frase

MCP (Model Context Protocol) é o padrão que permite a uma IA, como o Claude, o ChatGPT, o Cursor ou um agente próprio, usar um sistema por conversa. A API MCP do Xefo envelopa a API REST v1: cada ferramenta da IA corresponde a um endpoint da API.

  • Situação: no ar, com mais de 100 ferramentas.
  • No Claude (web, desktop e celular): conector direto, com o login e as permissões de cada usuário no Xefo.
  • No Claude Code, no Cursor e em agentes próprios: chave de integração da empresa, no cabeçalho X-API-Key.
  • Em breve: ChatGPT.
  • Endereço: https://mcp.xefo.com.br/mcp
  • Guia: como usar a API MCP no dia a dia do restaurante.
API MCP do Xefo
Mais de 100 ferramentas

O que a IA faz no seu restaurante

Cada ferramenta da API MCP corresponde a uma função da API do Xefo. Veja o que dá para pedir em cada área da operação.

Mesas e comandas

Consulta as mesas livres e ocupadas e os itens em aberto de cada mesa ou comanda, com o total da conta.

"Quais mesas estão ocupadas e quanto deve a mesa 5?"

Delivery e viagem

Lista os pedidos de delivery e para viagem que estão em aberto nas últimas 24 horas.

"Quais pedidos de delivery ainda estão em aberto?"

Cardápio e produtos

Cadastra produtos e categorias, inclui fotos, consulta o estoque e atualiza o preço de vários itens de uma vez.

"Atualize o preço destes itens."

Fiscal dos produtos

Classificação fiscal automática: sugere NCM, CEST, CFOP e IBS/CBS pelo nome do produto e grava no cadastro.

"Cadastre estes 50 produtos com o NCM certo."

Caixa

Consulta o saldo, os fechamentos e os lançamentos do caixa, e registra sangria e suprimento.

"Qual o saldo do caixa agora?"

Financeiro

Lista as contas a pagar e a receber, para você saber o que vence e o que entra.

"Quanto tenho a receber esta semana?"

NFC-e e NF-e

Consulta, emite e cancela NFC-e; cria, emite e consulta NF-e, e explica o motivo de uma rejeição.

"Liste as NFC-e emitidas ontem."

Pedidos e orçamentos

Cria pedidos e orçamentos, inclui e ajusta itens, converte orçamento em pedido e fatura o pedido.

"Fature o pedido 123."

Estoque

Registra entrada de mercadoria, ajuste e inventário, define estoque mínimo e transfere entre lojas do mesmo grupo.

"Lance a entrada desta compra no estoque."

Também há ferramentas de clientes, usuários, importação de planilha de produtos, certificado digital (vencimento e situação), configuração fiscal da empresa e, para quem usa, NFS-e e consulta de MDF-e.

Você pedeA IA faz no Xefo
"Quais mesas estão ocupadas e quanto deve a mesa 5?"Consulta as mesas ocupadas e os itens em aberto da mesa 5, com o total.
"Cadastre estes 50 produtos com NCM certo."Classifica cada produto (NCM, CEST, CFOP, IBS/CBS) e cadastra.
"Quanto tenho a receber esta semana?"Lista as contas a receber da semana e soma os valores.
"Fature o pedido 123."Fatura o pedido e gera a NF-e para emissão.
"Atualize o preço destes itens."Atualiza o preço de vários produtos de uma vez.
Conectar no Claude (claude.ai)

Conecte no Claude com o seu login

Funciona no Claude na web, no aplicativo de desktop e no celular. Sem chave para copiar: você entra com o login e a senha que já usa no Xefo.

O Xefo está no diretório de conectores do Claude. O jeito mais rápido: abra a página do Xefo no diretório, conecte e entre com o seu login do Xefo. Se preferir, siga o passo a passo abaixo.
  1. No Claude, abra Configurações → Conectores.
  2. Clique em Adicionar conector personalizado.
  3. No nome, escreva Xefo. No endereço, cole https://mcp.xefo.com.br/mcp e clique em Adicionar.
  4. No conector Xefo, clique em Vincular.
  5. Entre com o seu login e senha do Xefo.
  6. Na tela de autorização, clique em Autorizar. Pronto: é só pedir em português.
Testes: Para testar sem valor fiscal, use uma empresa configurada em homologação.
Tela ilustrativa

O aplicativo Claude quer acessar sua conta Xefo

É esta a tela que aparece depois do login. Confira o nome e clique em Autorizar.

  • Com as suas permissões: a IA entra como você e respeita o que o seu usuário pode fazer no Xefo. Quem não pode fazer algo no sistema também não faz pela IA.
  • Consulta direto, altera com confirmação: as consultas rodam na hora e, antes de qualquer alteração, o Claude pede a sua confirmação.
  • Tudo registrado: cada chamada vai para o log de auditoria do Xefo.
ChatGPT: em breve.
Claude Code, Cursor e agentes

Pela chave de integração da empresa

Para o Claude Code, o Cursor, outros clientes MCP que aceitam o cabeçalho X-API-Key e agentes próprios. A chave libera todas as ferramentas da empresa.

  • Gere a chave de integração. No Xefo, no cadastro da empresa, abra a área Chave de integração e gere a chave. Se a empresa já usa uma integração, use a chave atual: gerar uma nova substitui a anterior e derruba as integrações que usam a antiga. Dúvidas? O suporte ajuda.
  • Configure o endereço da API MCP no Claude Code, no Cursor, no seu cliente MCP ou no seu agente, com a chave no cabeçalho X-API-Key: https://mcp.xefo.com.br/mcp
  • Peça em português. A IA escolhe a ferramenta certa e responde com os dados do seu Xefo.
Como a chave dá acesso a toda a empresa, deixe-a só com quem pode operar o sistema inteiro.
Exemplo de configuração

O formato do arquivo muda de um aplicativo para outro; o que importa são dois dados: o endereço e o cabeçalho com a sua chave. Troque o texto em maiúsculas pela chave gerada no Xefo.

{
  "mcpServers": {
    "xefo": {
      "url": "https://mcp.xefo.com.br/mcp",
      "headers": {
        "X-API-Key": "SUA_CHAVE_DE_INTEGRACAO"
      }
    }
  }
}
Trate a chave como senha: não cole em conversa, planilha ou grupo e não mostre em print de tela.
Segurança e permissões

A IA segue as regras do Xefo

A API MCP não abre um caminho paralelo: cada ação passa pela mesma API, com as mesmas validações, permissões e limites.

  • Uma ferramenta, um endpoint: cada ferramenta chama uma função da API REST v1 do Xefo, com as mesmas regras de negócio do sistema.
  • Conector direto, com o login de cada pessoa: no Claude, a IA entra com o login do usuário e respeita as permissões dele no Xefo. Quem não pode fazer algo no sistema também não faz pela IA.
  • Consulta direto, altera com confirmação: as consultas rodam na hora; antes de qualquer alteração, o Claude pede confirmação.
  • Chave de integração da empresa: no Claude Code, no Cursor e em agentes próprios (cabeçalho X-API-Key), com acesso a todas as ferramentas da empresa. Guarde como senha; gerar uma nova chave substitui a anterior e derruba as integrações que usam a antiga.
  • Auditoria: toda chamada vai para o log de auditoria, que pode registrar qual pessoa delegou a tarefa à IA.
  • Mesmos limites de uso da API: a API MCP e a API do Xefo compartilham os mesmos limites.
Dúvidas

Perguntas frequentes

Não achou sua dúvida? Fale com um especialista no WhatsApp.

É a forma de uma IA usar o Xefo por conversa. Ela segue o MCP (Model Context Protocol), o padrão que conecta assistentes como o Claude, o Cursor e agentes próprios a sistemas. Cada ferramenta da IA corresponde a um endpoint da API REST v1 do Xefo, com as mesmas regras e permissões.
No Claude, sim: pelo conector direto, no Claude na web (claude.ai), no aplicativo de desktop e no celular, com o seu login do Xefo. No ChatGPT, em breve. A API MCP também funciona no Claude Code, no Cursor, em outros clientes MCP que aceitam o cabeçalho X-API-Key e em agentes próprios, com a chave de integração da empresa.
No Claude, abra Configurações, depois Conectores, e clique em Adicionar conector personalizado. No nome, escreva Xefo; no endereço, cole https://mcp.xefo.com.br/mcp e clique em Adicionar. Depois clique em Vincular, entre com o seu login e senha do Xefo e, na tela "O aplicativo Claude quer acessar sua conta Xefo", clique em Autorizar. Para testar sem valor fiscal, use uma empresa configurada em homologação.
Use a chave de integração da empresa: gere a chave no cadastro da empresa no Xefo e configure o endereço https://mcp.xefo.com.br/mcp com a chave no cabeçalho X-API-Key. A chave libera todas as ferramentas da empresa. Se a empresa já usa uma integração, use a chave atual: gerar uma nova substitui a anterior e derruba as integrações que usam a antiga.
Para usar no Claude, não: é adicionar o conector, entrar com o seu login do Xefo e conversar. No Claude Code e no Cursor, a configuração com o endereço e a chave é feita uma vez. Para ligar a API MCP a um agente próprio, aí sim é trabalho de desenvolvedor.
Não. No salão e no delivery, a IA consulta: mesas livres e ocupadas, itens em aberto e total de cada mesa ou comanda, e pedidos de delivery e viagem em aberto. O atendimento continua no PDV, na comanda do garçom e no autoatendimento.
Não. Cada ferramenta passa pela API do Xefo, com as mesmas validações. No Claude, pelo conector direto, a IA entra com o seu login e respeita as suas permissões no Xefo: quem não pode fazer algo no sistema também não faz pela IA. As consultas rodam direto e, antes de qualquer alteração, o Claude pede a sua confirmação. Já a chave de integração da empresa, usada no Claude Code, no Cursor e em agentes próprios, libera todas as ferramentas da empresa, por isso deve ficar só com quem pode operar o sistema inteiro e ser guardada como senha.
Fica. Toda chamada vai para o log de auditoria do Xefo, que pode registrar também qual pessoa delegou a tarefa à IA. A API MCP segue os mesmos limites de uso da API.
Não. Ela sugere NCM, CEST, CFOP e IBS/CBS a partir do nome do produto e grava no cadastro, o que poupa a digitação. As regras fiscais variam por estado, regime e produto: confira a classificação com o seu contador.

Quer ver a IA trabalhando no seu restaurante?

Numa demonstração ao vivo, tire suas dúvidas sobre a API MCP e veja o Xefo funcionando com o seu cardápio.

Fale com um especialista:
Fale com um especialista: Fale com
a gente:
Agendar demonstração