Conectar o Claude, o ChatGPT e outras IAs (e criar chaves de API)

Com a sua permissão, uma IA de fora passa a ver seus números e a lançar por você, sem sair da conversa dela. É opcional e pensado pra quem já usa o Claude, o ChatGPT ou outra IA. Pra falar com o Dino, a IA do Dinzo, não precisa de nada disso: ele já está no app (o círculo do Dino na barra de baixo), na web (botão Dino na barra do topo) e no WhatsApp.

Onde fica

App: Configurações → Conexões de IA e API (no grupo Sua conta, logo depois de Conexões bancárias)
Web: Configurações → aba Conexões de IA e API (a aba Integrações tem um atalho pra ela)

Conectar IAs e criar chaves de API são recursos do Premium e do Ultra. No gratuito a tela aparece, mas as ações levam pra tela de planos. Começando a conexão pela própria IA numa conta sem plano pago, a página do Dinzo já avisa que o recurso não está no seu plano, no lugar da escolha de permissão e antes do código de confirmação.

O que a IA vê e o que ela nunca faz

Na hora de conectar, você escolhe o nível de acesso:

Somente leitura: saldos, contas, cartões e faturas, lançamentos, metas, assinaturas e investimentos
Leitura e escrita: tudo isso e também criar, editar e apagar lançamentos, transferências, contas, categorias, tags e metas, e registrar pagamentos de faturas. Nada disso movimenta dinheiro

Com leitura e escrita, o que você corrige pela IA vale como no app: trocar a categoria de um lançamento que veio do banco, ou ocultá-lo, ensina o Dinzo, e os próximos parecidos já chegam assim. A IA também consegue dar baixa numa ocorrência de recorrência com o lançamento do banco que a pagou e criar metas com prazo.

Leitura e escrita só aparece quando o próprio programa pediu escrita. Pra trocar o nível depois, desconecte e conecte de novo.

O que nenhuma IA conectada faz, em nenhum nível: movimentar dinheiro (registrar um pagamento de fatura ou uma transferência só anota no Dinzo, e Pix, pagamento ou transferência no banco não existem por aqui), ver sua senha ou os dados de acesso do banco, conectar bancos, mudar seu plano ou apagar sua conta.

O que a IA busca no Dinzo passa a seguir também os termos e a política de privacidade de quem faz a IA, o que pode incluir o uso pra treinar modelos, conforme as configurações da sua conta lá. O Dinzo registra cada chamada, mas nunca o conteúdo das mensagens (veja a Política de Privacidade).

Conectar o Claude, o ChatGPT ou outra IA

Em Conectar uma IA, abra o que você usa, Claude, ChatGPT, Grok, Perplexity ou Mistral (toque no app, clique na web): abre um passo a passo próprio, com o endereço do Dinzo pra copiar. O que cada um pede:

Claude: funciona no grátis (1 conexão), Pro, Max, Team e Enterprise. Recomendamos o computador
ChatGPT: faça pelo computador
Grok: qualquer conta, no computador ou no app do Grok. O Grok de dentro do X não tem conectores
Perplexity: precisa do Pro, Max ou Enterprise, e a conexão é feita no computador, em perplexity.ai
Mistral: qualquer plano, inclusive o grátis, pelo computador, em chat.mistral.ai

No Claude, no Grok, no Perplexity e no Mistral, em plano de empresa (Team, Business ou Enterprise), o administrador precisa liberar os conectores antes. O Gemini (Google) não aceita conexões como essa no Brasil.

Quando o programa pedir a conexão, o Dinzo abre no navegador com "quer acessar a conta Dinzo de (seu e-mail)". Confira o site que aparece ali, escolha a permissão e toque em Permitir acesso. Aparece "Tudo certo!" e você volta sozinho pra IA.

O que a IA lançar aparece no app em até 30 segundos com ele aberto. No site, aparece em até 2 minutos com a aba aberta, e na hora quando você volta pra aba. Com o app fechado, entra na próxima vez que você abrir.

Se a IA disser que só consegue ver o básico, ou que não acha os gastos de uma categoria, peça citando a categoria, por exemplo: "Liste minhas categorias do Dinzo e some os lançamentos da categoria Açougue do mês passado". No ChatGPT, se parecer que falta alguma ferramenta, use Atualizar na conexão do Dinzo e comece uma conversa nova.

O código de confirmação

Conectar uma IA e criar uma chave de API passam sempre pela tela Confirme que é você, com um código de 6 dígitos. Você escolhe Receber no WhatsApp ou Receber por e-mail (assunto "Seu código de acesso"), e o código dura 10 minutos. Escolher outro canal manda um novo.

O código vai sempre pro número principal ou pro e-mail da sua conta, nunca pra outro destino, e a opção do WhatsApp só aparece se você tiver número cadastrado. Ninguém do Dinzo pede esse código: se alguém pedir, não passe.

A cada conexão chega o e-mail Nova IA conectada à sua conta Dinzo, e a cada chave, Nova chave de API criada na sua conta Dinzo. Não reconheceu? Desconecte na mesma tela e troque sua senha.

Para desenvolvedores e chaves de API

No app, a linha Para desenvolvedores abre Claude Code, Codex, Outro (Cursor, VS Code, Antigravity) e Chaves de API. Na web é tudo na mesma aba. Qualquer programa que aceite servidor MCP remoto funciona: o endereço é https://api.dinzo.com.br/mcp, do tipo HTTP.

Em Criar chave você define nome, permissão (Somente leitura ou Leitura e escrita) e validade (30 dias, 90 dias, 1 ano ou Sem validade, com 1 ano de padrão). Chave de leitura e escrita nunca fica sem prazo: mesmo em Sem validade, ela vale 1 ano.

A chave começa com dz_live_ e aparece uma vez só, na criação. Copie na hora: depois a lista mostra apenas o começo e os 4 últimos caracteres, o último uso e a validade. Perdeu? Apague e crie outra. Cada conta tem até 10 chaves.

O guia completo, com escopos, limites de chamadas e a referência de todos os endpoints, fica em dinzo.com.br/docs.

Desconectar

Em IAs conectadas aparece o site do assistente, a etiqueta de leitura ou de leitura e escrita e o último uso. No app, toque na linha e em Desconectar; na web, use o botão de desconectar. O acesso cai na hora, e dá pra conectar de novo quando quiser. Apagar uma chave de API corta na mesma hora quem estiver usando aquela chave.

Uma conexão feita pelo login também expira sozinha depois de 30 dias sem uso, ou 180 dias depois de autorizada: aí é só conectar de novo pela IA.