Jornada 18 · Conectar

Você pergunta o faturamento do mês ao assistente de IA.
Ele responde um número plausível — e falso.

No Mineer a sua IA conversa com o sistema pelo servidor MCP: 75 ferramentas com a identidade e a permissão do usuário dono da chave, escrita com simulação e idempotência, tudo registrado. Webhooks de saída para o que não tem conector. Automação nativa gatilho → condição → ação, com log e anti-loop. E a sua própria chave de IA, se preferir.

A permissão é a do usuário, não do robô Escrita simula antes de gravar Automação com log e anti-loop
Servidor MCP: o que é, como conectar, o que a IA enxerga
Servidor MCP: o que é, como conectar, o que a IA enxerga
75ferramentas MCP; 15 escrevem, as outras só leem
0permissões próprias do robô: ele herda as do usuário dono da chave
1simulação antes de toda escrita — mostra o efeito sem gravar
4providers de IA com fallback: OpenAI, Google, Anthropic, Ollama
BYOKno Enterprise: a sua própria chave de IA, com o custo indo para a sua conta
O problema

A IA que não vê o seu sistema só sabe escrever bonito

  • Você pergunta o faturamento e o assistente responde com um número plausível e falso.
  • Copiar relatório para dentro do chat é o trabalho que a IA deveria evitar.
  • Integrar por API exige alguém escrever o cliente, tratar erro e manter contrato.
  • Dar acesso ao robô virou uma chave de administrador esquecida num arquivo.
  • A automação externa (Zapier/Make) não enxerga seus dados — e ninguém sabe o que ela fez quando falhou.
  • Ficar refém de um provedor de IA trava a operação.
Rastro da operação
Rastro da operação

O dado que a sua IA lê pelo MCP é este: a venda, o pagamento, o caixa, o título e o lançamento.

O fluxo, etapa a etapa

Da chave criada à sua IA respondendo com o dado real

Cada etapa acontece num menu do produto. A tela ao lado é a tela real.

01

Crie um usuário de serviço e a chave

Grupo de acesso restrito ao que o robô precisa; a chave de API herda exatamente essa permissão — não existe permissão só da chave. Revogação imediata, sem mexer no acesso das pessoas.

Configurações → Grupos de Acesso · API
Configurações → Grupos de Acesso · API
Configurações → Grupos de Acesso · API
02

Conecte o cliente MCP com um comando

Claude Code, Codex, agents-core ou qualquer cliente do protocolo. A tela mostra a URL do tenant e o catálogo de ferramentas daquele usuário — filtrado pelo que ele pode ver e pelos módulos ativos.

Mineer IA → Servidor MCP
Mineer IA → Servidor MCP
Mineer IA → Servidor MCP
03

Pergunte — a resposta vem do sistema

Leads, pipeline, pedidos, comandas, saldo de estoque, faturas, tickets, produtos, pessoas, expedição. Leitura em tempo real; nada de número plausível.

cliente MCP
cliente MCP
cliente MCP
04

Aja com freio

Toda escrita aceita simular: mostra o efeito sem gravar. Chave de idempotência: repetir a chamada não duplica. Execução registrada com quem chamou, o que pediu e o que voltou. A aplicação nem sobe se uma ferramenta violar as regras do registro.

MCP → ferramentas de escrita
MCP → ferramentas de escrita
MCP → ferramentas de escrita
05

Automação no-code para o repetitivo

Gatilho (evento de CRM, vendas, financeiro, projetos, desk) → condição → ação, com smart values do próprio registro. Log append-only de cada execução e detecção de loops. Regras fiscais e de marketing na mesma lógica.

Automação · Fiscal → Automações · Marketing → Automações
Automação · Fiscal → Automações · Marketing → Automações
Automação · Fiscal → Automações · Marketing → Automações
06

Webhooks, providers e a sua chave

Webhooks de saída para o que não tem conector. Providers com fallback, modelo por feature, prompt editável na tela. BYOK: OpenAI, Google, Anthropic ou Ollama com a sua chave — disponível no plano Enterprise (Business Pro).

Configurações → API · IA · Minha Chave de IA
Configurações → API · IA · Minha Chave de IA
Configurações → API · IA · Minha Chave de IA
O que entra

Tudo o que existe em MCP, API, webhooks e automação — e o que cada coisa muda

Servidor MCP

  • JSON-RPC 2.0 sobre HTTP, sem estado; versão do protocolo no handshake
  • 75 ferramentas: CRM, vendas, estoque, financeiro, desk, produtos, pessoas, fornecedores, tabelas de preço, RH, expedição
  • Listagem filtrada pelo principal; a chamada revalida permissão e módulo ativo
  • Clientes: Claude Code, Codex, agents-core e qualquer cliente MCP

Segurança por herança

  • A chave herda as permissões do usuário dono — não existe permissão só do robô
  • Usuário de serviço restrito recomendado, nunca administrador
  • Autenticação por chave e segredo, ou JWT da própria sessão
  • Revogação imediata

Escrita com freio

  • 15 das 75 ferramentas escrevem; as outras só leem
  • Toda escrita aceita simular: mostra o efeito sem gravar
  • Chave de idempotência: repetir a chamada não duplica o registro
  • Execução registrada: quem chamou, o que pediu, o que voltou
  • Trava de boot: ferramenta sem permissão não sobe

Automação no-code

  • Gatilhos por evento de CRM, vendas, financeiro, projetos e desk
  • Condições e ações montadas visualmente; smart values do registro
  • Log append-only de cada execução; detecção de loops
  • Automações fiscais (pago → NF-e → envio → etiqueta) e de marketing (recomendação)

Webhooks e API

  • Webhooks de saída genéricos por evento
  • Chaves de API para integrações externas com o mesmo controle do MCP
  • Modelos de exportação configuráveis; alertas por evento

Providers e BYOK

  • OpenAI, Google, Anthropic e Ollama com fallback
  • Modelo escolhido por feature e por variante
  • Prompt de cada operação editável na tela — nenhum prompt no código
  • BYOK no Enterprise: a sua chave, com o custo indo para a sua conta — condição por plano confirmada na demonstração
Inteligência artificial

O que muda quando o assistente enxerga o sistema

A diferença entre um bot que irrita e um copiloto que resolve é de onde vem a resposta.

Pergunta operacional, resposta real

"Quanto tem no pipeline para fechar este mês?" — o número da tela, não um palpite.

Ação com rede de proteção

Simula, registra, não duplica — e só faz o que o usuário dono da chave pode.

ODEX pela mesma ponte

O agente executivo do Mineer usa o MCP em tempo de execução: módulo novo aparece sozinho.

Combinações

O que só existe porque é a mesma base

Tudo que é evento vira gatilho; tudo que é dado vira ferramenta.

Integrações

Conectores reais deste tema

E ainda

Mais 2 telas que fazem parte do mesmo módulo

Automações por regra
Automações por regra
Automações fiscais encadeadas
Automações fiscais encadeadas

Quer ver o Claude Code respondendo com o seu estoque?

Uma demonstração guiada, com a sua conta, sem compromisso.

Para quem é

Para quem essa jornada foi desenhada

Empresa com TI ou dev parceiro

Integra sem escrever cliente nem manter contrato.

Quem já usa assistentes de IA

Claude Code ou Codex passam a responder sobre o negócio, com permissão.

Agência de automação

Regras nativas com log e anti-loop, sem Zapier cego.

Contador ou parceiro

Consulta pelo MCP com permissão restrita ao que precisa.

Diferenciais

Diferente de "temos API"

A permissão é a do usuário

O robô não tem poder próprio; a listagem já vem filtrada.

Simular antes de gravar

Toda escrita mostra o efeito sem gravar; repetir não duplica.

A regra é verificada na subida

Ferramenta sem permissão derruba o boot — não passa numa revisão que alguém esquece.

Automação que enxerga o dado

Roda na mesma base, com log e anti-loop — não depende de conectar você a você mesmo.

Dúvidas

O que perguntam antes de dar acesso a um robô

É API?

É MCP — a IA usa direto, sem você escrever cliente — e também API com chave. As duas herdam a permissão do usuário dono.

O robô pode apagar coisa?

Só o que o usuário dono da chave pode. Toda escrita aceita simulação, tem chave de idempotência e é registrada.

Posso usar minha chave da OpenAI ou do Claude?

Sim, no plano Enterprise (Business Pro): BYOK por empresa, com o custo indo para a sua conta.

Substitui o Zapier?

Para o que acontece dentro do Mineer, sim: gatilho, condição e ação na mesma base, com log e anti-loop. Para fora, webhooks de saída.

E se a automação entrar em loop?

A engine detecta ciclos e interrompe; cada execução fica no log append-only.

Em qual plano entra?

MCP e API no núcleo; Automação à escolha a partir do Pro, inclusa no Business.

Sua IA responde sobre o seu negócio ou sobre a internet?

A diferença entre as duas é ter acesso ao dado — com permissão, e com rastro.

Sem compromisso. Respondemos em horário comercial.

A história continua
WhatsApp
Quero minha IA lendo meu sistema