Integração com IA (perguntar sobre os dados da loja)

Gere chaves de acesso para uma IA consultar os dados da loja (só leitura), siga o passo a passo "Como conectar" e revogue a chave quando não for mais usar.

Atualizado na versão 1.0.0.19.17

A Integração com IA permite fazer perguntas sobre a loja em linguagem normal — "Quanto vendemos em setembro, por vendedor?", "Quais produtos estão acabando?", "Clientes com parcela vencida há mais de 60 dias, com telefone" — e receber a resposta com os números tirados do próprio sistema.

A IA se conecta por uma ponte de IA instalada junto do servidor. O acesso é só de leitura: a IA consulta, mas não altera nada.

O que é o MCP#

MCP (Model Context Protocol) é o padrão aberto que programas de IA como o Claude Code e o Codex usam para se conectar a outras fontes de dados. A ponte de IA do ALPHA ERP, instalada junto com o servidor, oferece um servidor MCP: com uma chave gerada nesta tela, a IA consulta os dados da loja (vendas, estoque, crediário, caixa…) pelas consultas prontas da ponte, só para leitura — ela não altera nada no sistema.

Na prática você não precisa configurar o MCP à mão: o guia Como conectar (abaixo) já traz o endereço e a chave preenchidos para colar no Claude Code ou no Codex.

Antes de começar#

Você precisa da permissão especial Acessar Configurações.
A ponte de IA precisa estar instalada e funcionando no servidor (peça ao suporte).
Para usar de outro computador (fora do servidor), é preciso um endereço de acesso externo (túnel) configurado pelo suporte.

Gerar uma chave#

No menu, abra Administração → Integração com IA.
Clique em + Nova chave.
Preencha:
- Nome * — quem ou o que vai usar a chave (ex.: o nome da pessoa e o programa).
- Endereço da ponte (URL) — já vem com o endereço padrão, que serve quando a IA roda no próprio servidor. Para usar de outro computador, coloque o endereço do túnel informado pelo suporte. O endereço fica guardado para as próximas chaves.
- Validade — 1 dia, 7 dias, 30 dias, 90 dias, 1 ano ou Não expira.
Clique em Gerar chave.
Copie a chave na hora (botão Copiar só a chave): ela não aparece de novo. Se perder, revogue esta e gere outra.

Logo abaixo da chave gerada aparece o passo a passo Como conectar a IA, já com o endereço e a chave preenchidos.

Como conectar#

O botão Como conectar (no alto da tela) abre o mesmo guia a qualquer momento. Ele tem três abas, cada uma com os textos prontos e o botão Copiar:

Claude Code — instalar o programa, pedir para ele se conectar à loja e colar o prompt inicial.
Codex — guardar a chave no Windows, cadastrar a loja no Codex e colar o prompt inicial.
Tela de perguntas (navegador) — abrir o endereço da ponte no navegador, colar a chave de acesso e informar uma chave do serviço de IA usado pela tela.

O prompt inicial é um texto que ensina a IA a trabalhar com os dados da loja: usar as consultas prontas (vendas, produtos mais vendidos, comissão, estoque, inadimplência, fechamentos de caixa), nunca inventar números, responder em português com valores em R$ e datas em dd/mm/aaaa, e sempre dizer o período considerado.

Acompanhar e revogar chaves#

A lista mostra cada chave com Nome, o começo da Chave, Criada (data e quem criou), Expira, Último uso e a Situação: Ativa, Expirada ou Revogada.

Para cortar o acesso:

Clique em Revogar na linha da chave.
Confirme: "Quem estiver usando perde o acesso na hora."

Sem nenhuma chave ativa, ninguém acessa a ponte de IA.

Problemas comuns#

Mensagem	O que fazer
Dê um nome pra chave (quem ou o que vai usar).	Preencha o nome com pelo menos 2 letras.
Informe o endereço da ponte ...	Preencha o endereço (ou volte ao padrão que aparece no campo).
A IA diz que não consegue se conectar.	Confira se a chave está Ativa (não expirada nem revogada), se o endereço é o certo para o computador onde a IA roda e se a ponte de IA está ligada no servidor.
Perdi a chave.	Ela não pode ser mostrada de novo: revogue e gere outra.