Quando usar
Use esta página quando quiser que um assistente de IA (ex.: Claude, ChatGPT) consulte seus dados financeiros em linguagem natural — "quanto gastei este mês?", "quem está me devendo?" — sem precisar exportar planilhas ou conceder acesso completo à conta.
Quem recebeu um compartilhamento (papel de visualizador ou editor) também pode ter um token para consultar os dados de quem compartilhou — veja "Acesso para o contador".
Antes de começar
- Você precisa estar autenticado como proprietário da conta.
- Para dar acesso a um contador: o contador precisa ter aceito um convite em "Compartilhar dados" (papel de visualização). O compartilhamento é só leitura: pelo token MCP ninguém cria ou edita lançamentos. Convites antigos com papel "Edição" continuam valendo, também só para leitura.
Passo a passo
- Acesse o menu lateral em "Integrações MCP" (grupo Integrações).
- Clique em "Gerar token MCP".
- Copie o token imediatamente — ele é exibido apenas uma vez por segurança.
- Cole o token no campo de autenticação do assistente de IA ou ferramenta de integração.
- Formato:
Authorization: Bearer <token> - Endpoint do servidor: exibido na tela em "Endpoint do servidor MCP"
- Formato:
O token expira automaticamente em 30 dias. Após a expiração, gere um novo.
Revogar o token
- Acesse "Integrações MCP".
- Clique em "Revogar token" e confirme no diálogo.
O acesso é bloqueado imediatamente após a revogação.
Acesso para o contador
Por padrão, o token consulta a sua conta ativa — mesmo que você também seja contador de outra pessoa.
Para ler os dados de quem compartilhou com você:
- Acesse "Integrações MCP".
- Em "Conta que o token vai ler", escolha a conta compartilhada (aparecem as contas de compartilhamentos com papel de visualizador ou editor).
- Clique em "Gerar token MCP". A tela avisa que o token anterior — da sua conta ou de outra conta compartilhada — será revogado; confirme em "Gerar novo".
- Copie o token.
O status do token mostra de qual conta ele lê ("minha conta ativa" ou "conta (compartilhada por dono)").
Esse token só vale enquanto o compartilhamento existir:
- Se o dono desfizer o compartilhamento, o token é revogado na hora.
- O histórico de acesso do dono mostra as consultas feitas pelo token do contador.
- Cada conta sua tem no máximo 1 token ativo: gerar um token para a conta compartilhada revoga o token anterior da sua conta ativa, e vice-versa.
Erros comuns
- Token não copiado a tempo — gere um novo token; o anterior é revogado automaticamente. Não há como recuperar o token anterior.
- Assistente retorna "Token inválido" — verifique se o token não expirou (validade de 30 dias) ou foi revogado. Gere um novo se necessário. O token também deixa de funcionar se o compartilhamento que dava acesso foi desfeito ou se a exclusão da conta foi solicitada.
- Meu token parou de funcionar depois da atualização de setembro/2026 — tokens antigos de quem era convidado em algum compartilhamento apontavam, por engano, para a conta de outra pessoa, e foram revogados. Gere um novo token e escolha a conta certa em "Conta que o token vai ler".
- Assistente não encontra lançamentos — confira qual conta estava ativa quando você gerou o token: ele consulta só essa conta. Troque a conta ativa e gere de novo, se precisar.
Perguntas frequentes
O assistente pode criar ou editar lançamentos pela integração MCP? Não. O acesso é estritamente somente-leitura. Ferramentas de escrita são bloqueadas sem exceção.
Como sei quem consultou meus dados? O histórico de acesso na mesma tela lista todas as consultas feitas com o token: ferramenta chamada, status (Permitido/Rejeitado) e data/hora.
Posso ter mais de um token ativo? Não. Cada conta tem no máximo 1 token ativo. Gerar um novo revoga o anterior automaticamente.