MCP (assistentes de IA)
Use o Claude e outros clientes MCP com seus dados.
O MCP (Model Context Protocol) é um padrão aberto que permite a assistentes de IA, como o Claude, usar outros sistemas. Ao conectar o Saldo Azul ao seu assistente, você pode pedir em linguagem natural coisas como "quanto gastei com assinaturas este mês?" ou "lança uma despesa de R$ 80 no mercado ontem", e o assistente consulta ou registra os dados por você.
Você pede
Numa conversa com o assistente (ex.: Claude).
O assistente consulta o Saldo Azul
Só com as permissões que você concedeu.
Mesmas regras do app
Valida e lê ou grava só os seus dados.
Resposta
O assistente resume para você.
O assistente passa pelas mesmas regras e validações do app: ele não consegue fazer nada que você não conseguiria fazer pela interface.
Funciona com assistentes que aceitam conectores MCP remotos com login, como o Claude. O endereço do conector é:
https://saldoazul-api.gerolomolab.dev/api/v1/mcpClaude (web e desktop)
Adicione um conector personalizado
Nas configurações do Claude, em Conectores, adicione um conector personalizado e informe o endereço acima.
Faça login
O Claude abre a tela de login do Saldo Azul. Entre com a mesma conta que você usa no app.
Autorize as permissões
Escolha o que o assistente pode fazer: só consultar, também registrar e alterar, e/ou remover (veja Permissões).
Use o conector numa conversa
Ative o conector na conversa e faça seu pedido.
Claude Code (terminal)
No terminal, rode:
claude mcp add --transport http saldoazul https://saldoazul-api.gerolomolab.dev/api/v1/mcpDepois, dentro do Claude Code, digite /mcp e escolha o conector saldoazul para fazer o login.
Novidades não aparecem?
Na autorização, você escolhe até onde o assistente pode ir. Ele só enxerga o que foi permitido.
| Permissão | O assistente pode | Observação |
|---|---|---|
| Leitura | Consultar contas, transações, cartões, faturas, recorrências, perfis, conexões bancárias e o resumo do mês. | Sempre concedida. É a única que vem marcada por padrão. |
| Escrita | Criar e alterar contas, transações, categorias e recorrências. | Só com o seu consentimento. |
| Remoção | Desativar contas e recorrências, cancelar transações, apagar ou desativar categorias. | O assistente pede confirmação antes de cada uma dessas ações. |
Atenção
Consultar (leitura)
- Seus perfis (o seu, outras pessoas e empresas).
- O resumo de um mês, como no Planejamento: receitas e despesas efetivadas e previstas, saldo do mês, despesas fixas, assinaturas, orçamentos, contas e faturas a vencer, aportes e saldo em caixa.
- Contas e seus saldos.
- Transações, com filtros de período, tipo, status, conta, categoria e busca pela descrição.
- Categorias.
- Cartões com limite e fatura atual, as faturas de cada cartão e o detalhe de uma fatura.
- Recorrências (assinaturas, despesas fixas, salários e outras).
- Contas a pagar de um período, com o que está vencido, a forma de pagamento e o código.
- Conexões bancárias, o estado de cada uma na hora (se está atualizando, em dia ou precisa de novo login) e os movimentos exatamente como o banco informou.
Registrar e alterar (escrita)
- Criar e alterar contas, inclusive mover uma conta para outro perfil.
- Lançar receitas, despesas e transferências entre suas contas (compras no cartão não).
- Alterar uma transação e confirmar uma prevista ou pendente, com o valor e a data reais.
- Criar e alterar categorias.
- Criar e alterar recorrências (assinaturas, despesas fixas, salários).
- Cadastrar contas a pagar e transformar uma despesa ou recorrência de despesa em conta a pagar, com a forma de pagamento, o código de barras ou a chave Pix e os dias dos lembretes por e-mail.
Remover (remoção)
- Desativar uma conta: ela deixa de receber lançamentos e o histórico fica.
- Cancelar uma transação: ela fica no histórico e sai de todos os saldos.
- Apagar uma categoria que nunca foi usada, ou desativar uma em uso.
- Encerrar uma recorrência, como uma assinatura cancelada; o que já foi lançado fica.
Nada é apagado de verdade, exceto uma categoria sem uso.
Diga em palavras de qual perfil você está falando ("da minha empresa", "do cônjuge", "só meu"). O assistente consulta seus perfis e usa o certo em cada pedido. Sem indicar um perfil, ele considera todos.
- Contas, cartões, transações, recorrências, contas a pagar e conexões bancárias podem ser listadas só de um perfil.
- O resumo do mês de um perfil trata o dinheiro trocado com outro perfil como receita ou despesa, como no app.
- Uma conta criada pelo assistente vai para o perfil indicado; sem indicação, para o seu.
- Lançamentos e recorrências vão para o perfil da conta ou do cartão usado.
| Você pede | O assistente |
|---|---|
| Quanto entrou e saiu este mês na minha empresa? | Busca o perfil da empresa e traz o resumo do mês dele. |
| Lança uma despesa de R$ 82,40 no mercado ontem, na conta Nubank. | Encontra a conta e a categoria Mercado e lança a despesa. |
| Quais assinaturas eu tenho e quanto somam? | Lista as recorrências do tipo assinatura e soma os valores. |
| Quais boletos vencem esta semana? | Lista as contas a pagar do período, com as vencidas. |
| Confirma o aluguel deste mês com o valor de R$ 2.050. | Encontra o aluguel pendente e o confirma com o valor informado. |
| Mostra minhas compras parceladas que ainda vão cair. | Lista as compras no cartão previstas. |
| Minha conexão com o Inter está funcionando? | Consulta o estado da conexão na hora. |
| Cancelei o Paramount+; encerra essa assinatura. | Encontra a recorrência e a encerra (pedindo sua confirmação). |
- O assistente só acessa os seus dados, identificados pelo seu login.
- Registros de outras pessoas simplesmente não existem para ele.
- Os dados dos bancos não incluem CPF ou CNPJ de terceiros (quem pagou ou recebeu).
- Toda alteração feita pelo assistente fica registrada, sem os valores enviados.
- Você pode revogar o acesso a qualquer momento removendo o conector no assistente.
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O assistente diz que não pode registrar ou remover | Ele foi conectado só com leitura. | Reconecte e autorize escrita (e remoção, se quiser). |
| Uma novidade do Saldo Azul não aparece | O assistente guardou o que existia quando se conectou. | Reconecte o conector. |
| O conector parou de funcionar depois que o Finance passou a se chamar Saldo Azul | Ele foi adicionado com o endereço antigo. | Remova o conector e adicione de novo com o endereço de Conectar um assistente. |
| O assistente pede login de novo ou recusa a conexão | A sessão expirou ou o endereço está incompleto. | Refaça o login; confira o endereço do conector. |
| O assistente não encontra um perfil | O perfil foi arquivado. | Reative o perfil em Configurações → Perfis. |
| O assistente diz que não encontrou um registro que você vê no app | Ele buscou no lugar errado ou com outro filtro. | Peça para listar de novo, indicando conta, período ou perfil. |
| O assistente diz que algum dado é inválido | Algum valor veio fora do formato (data, valor, conta). | Repita o pedido com a informação completa. |