Como ter um agente de IA no ERP Sankhya com o Claude (MCP + Cloudflare Workers)

Resposta direta: para ter um agente de IA dentro do ERP Sankhya, construímos um servidor MCP que conversa com a API do Sankhya, hospedamos esse servidor na Cloudflare Workers e o adicionamos ao Claude como conector personalizado. A diretoria pergunta em português ("quanto entrou no caixa hoje?") e o Claude busca o dado no ERP na hora. Fizemos isso para uma indústria cerâmica: são 23 consultas ao Sankhya, do caixa à DRE.

Por que colocar IA no ERP

Na maior parte das indústrias que usam o Sankhya, o dado existe e está certo. O problema é o caminho até ele. Para saber o caixa do dia, a inadimplência por faixa de atraso ou o desempenho de cada vendedor, a diretoria pede a alguém do financeiro ou do comercial, que abre o ERP, exporta, monta a planilha e envia. A resposta chega horas depois, e a pergunta seguinte recomeça o ciclo.

Um painel de BI resolve parte disso, mas só responde às perguntas que alguém previu quando montou o painel. Um agente de IA ligado ao ERP responde à pergunta que a diretoria tem agora, do jeito que ela fala.

Como funciona a integração do Claude com o Sankhya

A peça central é o MCP (Model Context Protocol), o padrão aberto criado pela Anthropic para ligar o Claude a sistemas externos. Um servidor MCP expõe "ferramentas", e o Claude decide sozinho qual chamar a partir da pergunta.

Na prática, a montagem tem quatro camadas:

1. O servidor MCP na Cloudflare. Escrito em TypeScript e publicado na Cloudflare Workers, com o transporte Streamable HTTP que o Claude usa em conectores remotos. A própria Cloudflare documenta esse caminho em MCP na Cloudflare. Para o volume de uma diretoria, o projeto roda no plano gratuito da Cloudflare.
2. A autenticação na API do Sankhya. O servidor faz login na API do Sankhya, guarda o token por cerca de 4 minutos no armazenamento KV da Cloudflare e renova sozinho quando ele expira. Assim cada pergunta não precisa de um login novo.
3. As consultas. Cada ferramenta do servidor é uma consulta de leitura ao banco do ERP, feita pelo serviço de consulta da própria API do Sankhya (DbExplorerSP.executeQuery). Nada é instalado no servidor do ERP.
4. O conector no Claude. O endereço do servidor é adicionado ao Claude como conector personalizado. A partir daí, as consultas aparecem para quem tem acesso, sem instalar nada no computador.

Por que um servidor MCP remoto, e não um script

A primeira ideia costuma ser rodar um script em Python dentro do próprio Claude. Em contas de equipe, o ambiente onde o Claude executa código não tem saída de rede liberada para o ERP: a conexão é recusada. O servidor MCP remoto resolve isso porque roda fora, na Cloudflare, e o Claude só chama o endereço dele. De quebra, as credenciais do Sankhya ficam guardadas como segredo no servidor, e não na conversa.

As 23 consultas que a diretoria faz ao Sankhya

A lista nasce das perguntas reais da diretoria e cresce com elas: cada pergunta nova vira uma consulta conferida. É por isso que há itens tão específicos da rotina, como a balança do dia e os clientes para reativar.

O resultado

São 23 consultas ao Sankhya disponíveis em português, mais 2 ferramentas que transformam a resposta em relatório ou e-mail. A diretoria pergunta no momento em que a dúvida aparece, em vez de pedir relatório e esperar. O ganho que mais aparece no dia a dia não é técnico: a conversa sobre o número acontece enquanto a decisão ainda está sendo tomada.

Boas práticas que aplicamos na integração com o Sankhya

1. A descrição de cada consulta diz o que o dado é, sem sugerir conclusão. O Claude lê essa descrição para decidir o que responder. Por isso ela explica o dado como o financeiro o entende: um lançamento de caixa ainda marcado como "A Definir" é o fluxo normal do dia, porque o financeiro classifica ao longo do expediente. A diretoria recebe o número com o contexto certo, e o agente só chama atenção para o que de fato pede atenção.

2. Nenhuma consulta entra no ar sem bater com a tela do Sankhya. O método: abrir o card do dashboard em que a equipe já confia dentro do Sankhya, pegar a consulta por trás dele e conferir o resultado contra a tela, número por número. A regra de negócio vem do que a empresa já usa, não do nome da tabela.

3. A regra de negócio é da empresa, não do ERP. O faturamento que a diretoria acompanha é contado por carga entregue, não pela data da nota, e cada consulta segue o critério que o financeiro já usa. Cada regra é validada com quem trabalha com o número todo dia.

4. Autenticação na API do Sankhya no formato certo. O login na API do Sankhya é enviado como formulário simples (application/x-www-form-urlencoded), e o token fica guardado por alguns minutos na Cloudflare e é renovado sozinho. É o tipo de detalhe que deixa a integração estável desde o primeiro dia.

5. Segurança vem antes da primeira pergunta. O servidor só aceita chamadas vindas da infraestrutura da Anthropic, tem uma chave própria como segunda camada e todas as consultas ao Sankhya são de leitura. O agente responde e explica, mas não lança nem altera nada no ERP.

Como a Nexus usa IA nesse tipo de projeto

Para nós, IA em dado de gestão começa pela pergunta, não pelo painel. Primeiro levantamos o que a diretoria pergunta toda semana e quem para o trabalho para responder. Depois construímos uma consulta para cada pergunta, conferida contra o sistema da empresa, e só então ligamos o Claude a elas pelo MCP. O modelo de IA entende a pergunta e explica o resultado; quem garante que o número está certo é a consulta validada.

O desenho não depende do Sankhya. Com outro ERP muda a camada que conversa com o sistema, e o resto (servidor MCP, conector no Claude, validação contra a tela) continua igual. É o mesmo princípio da nossa solução de copiloto de dados com IA: o dado fica onde já está, a regra de negócio é da empresa e a IA encurta a distância entre a dúvida e a resposta.

Se quiser ver outro exemplo de agente montado no Claude, o kit do agente de CRM no WhatsApp mostra a mesma lógica aplicada ao comercial.

Perguntas frequentes

Dá para integrar o Claude com o Sankhya? Sim. O caminho é um servidor MCP (Model Context Protocol) que conversa com a API do Sankhya e é adicionado ao Claude como conector personalizado. O Claude passa a chamar consultas prontas do ERP sempre que a pergunta pede um dado.

Preciso instalar alguma coisa no servidor do Sankhya? Não. O conector usa a API que o Sankhya já oferece. Nada é instalado no ERP e a rotina de quem lança os dados não muda.

O agente de IA pode alterar dados no ERP? No projeto descrito, não. Todas as consultas ao Sankhya são de leitura. O agente responde, compara e explica, mas não lança nem edita nada no sistema.

Os números que o Claude responde são confiáveis? Eles vêm do Sankhya no momento da pergunta. Cada consulta foi conferida contra o relatório que a equipe já usa dentro do ERP antes de entrar no ar.

Funciona com outros ERPs além do Sankhya? Sim, desde que o ERP tenha API ou acesso a banco. Muda a camada que fala com o sistema; o desenho com MCP e Claude é o mesmo para TOTVS, Omie, Bling e outros.