Pular para o conteúdo principal

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.

Onde ficaIntegraçõesConexões de IA
Quem acessaA lista: somente o administrador. Conectar a própria IA: toda a equipe (padrão, que o administrador muda em Administração › Permissões dos cargos)
Precisa dePlano 2 ou acima (o módulo Integração via API e Webhook é ligado ao autorizar)

Conectar a sua IA​

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. Clique em Autorizar

    A tela mostra Pronto! e volta para a IA.

Todas as minhas empresas, inclusive as próximas

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.
Os administradores ficam sabendo

Nas empresas em que você não é administrador, os administradores recebem um aviso quando você conecta a sua IA.

As conexões da empresa​

  1. Como funciona — o endereço da conexão e as regras desta página, em resumo.
  2. Situação — Ativa ou Desconectada.
ColunaO que mostra
PessoaQuem conectou.
AppA IA conectada e desde quando.
CargoO 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.
EmpresasToda a equipe (a conexão inclui sozinha as empresas em que a pessoa entrar) ou Escolhidas.
DadosLê e altera ou Só lê.
Último usoQuando a IA usou a conexão pela última vez (ou Nunca usada).
ValidadeAté 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.

Para não conectar de novo

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çãoO que vale
Segue o cargoO que está em Permissões dos cargos.
PermitirLibera só para esta pessoa, mesmo que o cargo não tenha.
BloquearCorta só para esta pessoa, mesmo que o cargo tenha.

Conexão de IA ou acesso de API?​

Conexões de IAAcessos de API
Para quemUma pessoa da equipe e a IA dela.Integração entre sistemas, sem uma pessoa por trás.
Como nasceA pessoa entra com o login dela na IA.O administrador cria o token.
Com que permissãoO cargo da pessoa, que pode mudar.O cargo escolhido no token, fixo.
Em nome de quem gravaDa 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.