Conexões de IA
Cada pessoa da equipe pode ligar a IA que já usa (Claude, ChatGPT, Gemini, Cursor e outras) ao CleanFin, entrando com o próprio login. A IA passa a ler os dados e os relatórios da empresa com o cargo dessa pessoa, como na tela, e, se autorizada, também cadastra e altera, sempre no nome dela. Esta tela mostra quem conectou e deixa desconectar.
Conectar a sua IA
- Adicione o CleanFin como conector na sua IA
O endereço é https://api.cleanfin.com.br/mcp. No Claude e no ChatGPT, ele entra como conector personalizado; o passo a passo de cada IA está na página Integração com API do site.
- Entre com o seu login do CleanFin
A IA abre a tela do CleanFin, com o pedido (nome da IA) quer acessar os dados da sua empresa.
- Escolha as empresas
Em Acesso: Todas as minhas empresas, inclusive as próximas ou Escolher as empresas (com Marcar todas). Cada empresa aparece com o seu cargo nela.
- Escolha a validade e se a IA pode alterar dados
Validade: 30, 90 ou 180 dias, ou 1 ano. Ligue Permitir que a IA altere dados só se quiser que ela grave.
- Clique em Autorizar
A tela mostra Pronto! e volta para a IA.
Para quem atende várias empresas (escritório de contabilidade, BPO financeiro): as empresas em que você entrar depois aparecem na IA em até 1 hora, sem conectar de novo. Uma conexão alcança até 100 empresas.
O que a IA pode fazer
- Ler os dados e os relatórios de cada empresa, uma de cada vez, com o seu cargo nela. Se o cargo mudar, o acesso da IA muda junto, na hora.
- Cadastrar, alterar e excluir, só com Permitir que a IA altere dados ligado e só o que o seu cargo faz na tela, pelas mesmas telas e regras do sistema e sempre mostrando uma prévia antes. O que ela grava sai no seu nome.
- Emitir nota não pede código. Excluir (um registro por vez) e as ações sem volta, como cancelar uma nota, pedem um código de segurança: o do seu app autenticador ou um enviado ao seu e-mail ou WhatsApp, como você preferir.
Nas empresas em que você não é administrador, os administradores recebem um aviso quando você conecta a sua IA.
As conexões da empresa
- Como funciona — o endereço da conexão e as regras desta página, em resumo.
- Situação — Ativa ou Desconectada.
| Coluna | O que mostra |
|---|---|
| Pessoa | Quem conectou. |
| App | A IA conectada e desde quando. |
| Cargo | O cargo da pessoa nesta empresa. Fora da equipe quando ela não faz mais parte da equipe: aí a IA não acessa a empresa. |
| Empresas | Toda a equipe (a conexão inclui sozinha as empresas em que a pessoa entrar) ou Escolhidas. |
| Dados | Lê e altera ou Só lê. |
| Último uso | Quando a IA usou a conexão pela última vez (ou Nunca usada). |
| Validade | Até quando a conexão vale. |
Desconectar
No ⋮ da linha, Desconectar. A IA daquela pessoa deixa de acessar esta empresa; as outras empresas da conexão dela continuam. A pessoa também vê a conexão nos Dispositivos dela, onde desconectar corta tudo.
Desconectar não impede a pessoa de autorizar a IA outra vez. Para isso, bloqueie em Cargos e acessos (abaixo).
Quem pode conectar
As regras ficam em Administração › Permissões dos cargos, no grupo Conexões de IA: Conectar a própria IA e Alterar dados pela IA vêm liberados para toda a equipe. Veja Permissões dos cargos.
Para uma pessoa só, use a exceção no cadastro dela, em Administração › Cargos e acessos, bloco IA conectada:
| Opção | O que vale |
|---|---|
| Segue o cargo | O que está em Permissões dos cargos. |
| Permitir | Libera só para esta pessoa, mesmo que o cargo não tenha. |
| Bloquear | Corta só para esta pessoa, mesmo que o cargo tenha. |
Conexão de IA ou acesso de API?
| Conexões de IA | Acessos de API | |
|---|---|---|
| Para quem | Uma pessoa da equipe e a IA dela. | Integração entre sistemas, sem uma pessoa por trás. |
| Como nasce | A pessoa entra com o login dela na IA. | O administrador cria o token. |
| Com que permissão | O cargo da pessoa, que pode mudar. | O cargo escolhido no token, fixo. |
| Em nome de quem grava | Da pessoa. | Do token. |
Dúvidas comuns
A tela de autorização diz que não tenho permissão.
Você não tem permissão para conectar a IA nas suas empresas. Um administrador libera em Administração › Permissões dos cargos (Conexões de IA) ou só para você em Cargos e acessos.
Uma das minhas empresas ficou de fora.
O acesso por IA depende do plano da empresa. A tela de autorização diz quais ficaram de fora e a partir de que plano entram. Com Todas as minhas empresas, inclusive as próximas, elas entram sozinhas quando o plano mudar.
Eu já tinha conectado a IA por um token de Acessos de API. Preciso refazer?
Em geral, não. As conexões feitas pelo login antes desta mudança passam sozinhas para Conexões de IA na primeira renovação, no nome de quem tinha autorizado. Se a IA pedir para entrar de novo, é só conectar outra vez.