Documentação

O que é

O ERP IA conecta Claude, ChatGPT e outros clientes MCP aos serviços usados pela sua empresa. Você conversa em português, e o assistente consulta ou executa operações nos sistemas que você escolher.

Atualmente, o produto integra o Omie — nas áreas financeira, comercial, estoque e fiscal — e o Zapier, que amplia a conversa para milhares de aplicativos. Com ele, você pode trabalhar com WhatsApp, e-mail, agenda, Office, cobranças e outros serviços disponíveis na sua conta.

Antes de começar

Tenha uma conta no Claude, ChatGPT ou outro cliente compatível com MCP.
Tenha acesso aos serviços que deseja conectar, como Omie ou Zapier.
Não envie credenciais pela conversa. A IA sempre fornecerá um formulário seguro para configurá-las.

A assinatura é vinculada à sua conta do ERP IA. A ordem recomendada é adicionar o conector, autorizar a conta, assinar e pedir à IA para configurar os serviços desejados.

Conectar o ERP IA

O endereço do conector é https://mcp.botia.chat/mcp.

No Claude

Abra Customize › Connectors, clique em + e depois em Add custom connector.
Informe ERP IA no nome e https://mcp.botia.chat/mcp em Remote MCP server URL. Deixe os campos avançados vazios.
Clique em Add e, na lista de conectores, clique em Connect.
Na página do ERP IA, revise as permissões, guarde o código de recuperação da conta e autorize a conexão. Essa tela não solicita credenciais do Omie nem do Zapier.
Abra uma conversa nova, clique em + › Connectors e ative o ERP IA.

No ChatGPT

No navegador, abra Settings › Apps › Advanced settings e ative Developer mode.
Volte a Settings › Apps, clique em Create e use o nome ERP IA.
Em Connection, informe https://mcp.botia.chat/mcp, escolha OAuth e clique em Scan tools.
Na página do ERP IA, revise as permissões, guarde o código de recuperação e autorize. Ao voltar, conclua a criação do aplicativo.
Abra uma conversa nova e selecione ERP IA no menu de ferramentas.

Configurar integrações com a IA

Depois de adicionar o conector, faça o restante pela conversa. Pergunte “Quais serviços posso conectar?” ou diga “Quero conectar meu Omie”. O assistente identifica a integração e gera um link temporário e de uso único para o formulário correto.

Peça à IA para conectar o serviço desejado.
Abra o link seguro enviado na resposta.
Siga as instruções do formulário para obter e informar as credenciais.
Após a validação, volte à conversa e faça o seu pedido.

As credenciais vão diretamente do navegador para o cofre cifrado do ERP IA. Elas não passam pela conversa, não são entregues ao modelo e nunca são incluídas no token de acesso. Para atualizar ou remover uma integração, basta pedir à IA um novo link.

Autenticação

O ERP IA usa OAuth 2.1 com PKCE e registro dinâmico de clientes para autorizar o assistente. Essa autorização identifica a conta do ERP IA, mas não concede automaticamente acesso ao Omie, ao Zapier ou a outro serviço. Cada integração é configurada separadamente pelo link seguro gerado na conversa.

O token de acesso contém apenas um identificador interno da conta. Segredos de integração nunca são incluídos nele. O código de recuperação exibido na primeira autorização permite reencontrar a mesma conta em outro navegador ou assistente e deve ser guardado em local seguro.

Exemplos de uso

Financeiro — “Quais contas vencem esta semana?”, “Registre o pagamento do aluguel” ou “Compare o fluxo previsto e realizado”. A IA pode usar pesquisar_lancamentos_financeiros e consultar_fluxo_caixa.

Comercial — “Cadastre este cliente”, “Em que etapa está esta oportunidade?” ou “Crie um pedido de venda”. Para o pedido, pode usar incluir_pedido_venda.

Estoque e compras — “Quais produtos estão com estoque baixo?”, “Consulte a posição deste item” ou “Crie uma requisição de compra”. A consulta pode usar produtos_com_estoque_baixo.

Fiscal e serviços — “Localize a nota deste cliente”, “Importe esta NF-e” ou “Consulte as ordens de serviço em aberto”. Para localizar notas, pode usar listar_notas_fiscais.

Zapier — “Envie este resumo por WhatsApp”, “Crie o compromisso na agenda”, “Mande a cobrança por e-mail” ou “Atualize este arquivo do Office”. A IA consulta zapier_ferramentas_disponiveis e usa zapier_executar_ferramenta para uma ação liberada pelo cliente no Zapier MCP.

No Zapier, as ações disponíveis são exatamente as que você adicionou ao seu servidor em mcp.zapier.com. Toda configuração é feita pelo navegador; não é necessário instalar programas ou usar terminal. A IA confere as opções antes de executar e pede confirmação porque a ferramenta pode enviar, criar ou alterar dados.

Estado da conta e assinatura

Pergunte “Qual é o status da minha conexão?” para ver os serviços conectados, a situação da assinatura e o limite de uso. Se a assinatura ainda não estiver ativa, a própria resposta apresentará o link de contratação.

Erros comuns

Mensagem ou situação	O que fazer
Serviço ainda não conectado	Peça à IA para conectar o Omie ou o Zapier e abra o link temporário.
Link inválido, expirado ou já usado	Peça um novo link na conversa. Cada formulário vale por poucos minutos e uma única vez.
Credenciais recusadas	Confira os dados no serviço de origem e solicite um novo formulário à IA.
Assinatura inativa	Regularize pelo link apresentado pelo assistente.
Limite de uso atingido	Aguarde o período informado e tente novamente.
Consulta ampla demais	Informe um período menor, um status ou outro filtro.

Suporte

Consulte a página de suporte.