Pular para o conteúdo

Liga o teu agente ao finko

Na appDefinições → Agentes IA

O finko é o motor de previsão do teu agente. Ligas o Claude, o ChatGPT, o Cursor ou outro agente de IA à tua conta e perguntas-lhe pelo teu dinheiro no sítio onde já estás a trabalhar: quanto vais ter até ao próximo salário, o que acontece se gastares 800 € no dia 5, que pagamentos aí vêm. O agente responde com os teus números reais, calculados pelo mesmo motor de previsão que alimenta a app.

A ligação usa o Model Context Protocol (MCP). Cada agente liga-se ao mesmo endereço, o endereço do conector, que encontras em Definições → Agentes IA:

https://api.finko.pt/api/mcp

Por omissão o agente só lê. Se deres permissão de escrita, também pode criar, alterar e apagar o que geres no finko, nas áreas descritas mais abaixo. Nunca move dinheiro.

Ligar o teu agente funciona em todos os planos, também no Free. O agente corre na tua conta do Claude, do ChatGPT ou do cliente que usares, com o plano que esse serviço pedir, por isso do lado do finko não pagas nada a mais.

O agente vê e faz o mesmo que tu na app, com os limites do teu plano:

Free Pro
Previsão do saldo Até ao fim do mês 30 dias e além
Contas Até 2 Ilimitadas
Metas e orçamentos Até 3, no total Ilimitados
Documentos guardados Até 10 Ilimitados
Partilha em grupo Não incluída Incluída

Quando um pedido passa o limite do Free, o agente recebe essa informação e diz-te, em vez de inventar números. O kompanion, o assistente dentro da app, é do plano Pro.

Funciona no claude.ai, na aplicação para computador e no telemóvel. Não há nenhuma chave para copiar.

  1. Abre Definições → Agentes IA no finko e clica em Copiar endereço.

  2. No Claude, abre Definições → Conectores (ou claude.ai/settings/connectors).

  3. Escolhe adicionar um conector personalizado e cola o endereço.

  4. Inicia sessão no finko quando o Claude abrir a janela de autorização e clica em Autorizar.

  1. Abre Definições → Agentes IA no finko e clica em Copiar endereço.

  2. No ChatGPT, abre as definições de conectores (chatgpt.com) e escolhe criar um conector (ou app) personalizado.

  3. Cola o endereço e escolhe a autenticação OAuth.

  4. Inicia sessão no finko quando o ChatGPT abrir a janela de autorização e clica em Autorizar.

  1. Corre este comando no terminal:

    Terminal window
    claude mcp add --transport http finko https://api.finko.pt/api/mcp
  2. Dentro do Claude Code, escreve /mcp, escolhe finko e inicia sessão no browser.

Qualquer cliente que fale MCP remoto com OAuth funciona. Junta este bloco à configuração MCP do cliente (no Cursor, o ficheiro mcp.json):

{
"mcpServers": {
"finko": {
"url": "https://api.finko.pt/api/mcp"
}
}
}

Reinicia o cliente e inicia sessão no finko quando for pedido.

Para clientes que ainda não suportam OAuth, usa uma chave de API e a ponte mcp-remote.

  1. Em Definições → Agentes IA, na secção Avançado: chaves de API, dá um nome à chave.

  2. Se quiseres que o agente possa fazer alterações, liga Permitir que o agente faça alterações. Desligado, a chave só lê.

  3. Clica em Gerar e copia a chave. Começa por finko_sk_live_ e só é mostrada uma vez.

  4. Configura a ponte no teu cliente, trocando <chave> pela chave:

    Terminal window
    npx mcp-remote https://api.finko.pt/api/mcp \
    --header "Authorization: Bearer <chave>"

O agente trabalha por áreas da app, as mesmas que encontras no menu. Não precisas de lhe dizer o que usar: basta pedires, e ele escolhe. O que pode alterar depende da permissão de escrita (ver Permissões).

Área Consultar Com permissão de escrita
Previsão e saldo Prever o saldo dia a dia, simular uma despesa ou receita e ver o que aí vem. Planear movimentos futuros, ajustar a previsão de um mês e mudar a estimativa dos gastos do dia a dia.
Movimentos e categorias Procurar movimentos por data, texto, categoria ou tipo, e ver as categorias, os comerciantes e as regras. Registar, editar e apagar movimentos, categorizar (e os semelhantes) e gerir categorias, regras e comerciantes.
Recorrências Ver o salário, as rendas e as subscrições. Criar, editar, pausar e apagar recorrências, aceitar sugestões, marcar o salário, ligar movimentos parecidos (com pré-visualização) e desfazer.
Documentos Listar e ver documentos (faturas, recibos, garantias, contratos) e ver os pagamentos que ainda não têm fatura. Guardar um documento novo a partir de um ficheiro (só num agente ligado por MCP), editar os dados e ligar ou desligar documentos de movimentos, recorrências, itens de orçamento e comerciantes.
Orçamentos Ver os orçamentos e os seus itens, com ícone, fornecedor, notas e pagamentos. Criar, editar e apagar orçamentos e itens (incluindo o ícone), associar pagamentos aos itens e registar pagamentos sem movimento.
Metas Ver as metas de poupança e o progresso. Criar, editar e apagar metas.
Limites Ver os limites de gastos por categoria, quanto já gastaste e quanto falta. Criar, editar e apagar limites.
Contas e bancos Ver as contas, os saldos e o estado das ligações aos bancos. Criar, editar e apagar contas e sincronizá-las com o banco. Ligar um banco é sempre contigo.
Património e créditos Ver o património (bens e dívidas) e os créditos, com prestações e simulações. Criar, editar e apagar bens e créditos, registar avaliações e amortizações.
Relatórios Ver o balancete do mês, realizado ou previsto. Só consulta.
Notificações e preferências Ver as notificações e as preferências do teu perfil. Marcar notificações como lidas ou apagá-las e mudar as preferências.
Grupos Ver os teus grupos e quem os integra. Responder a convites e deixar de partilhar o que partilhaste. Convidar e partilhar coisas novas fica contigo.
  • “Quanto vou ter até ao próximo salário?”
  • “Se gastar 800 € no dia 5, como fico?”
  • “Que pagamentos tenho nos próximos 15 dias?”
  • “Categoriza os movimentos sem categoria da última semana.”
  • “Cria um orçamento para o casamento com o fotógrafo a 1 200 € e a quinta a 4 500 €.”
  • “Cria uma meta de 3 000 € para as férias até junho.”
  • “Vai buscar as faturas desta semana ao meu email e junta-as aos pagamentos.”
  • “Que pagamentos ainda não têm fatura?”

Se o teu agente (o ChatGPT, por exemplo, ou um agente teu) também tem acesso ao teu email, pode ir buscar as faturas que lá chegam e guardá-las nos Documentos do finko, ligadas ao pagamento a que dizem respeito. Precisa de permissão de escrita.

  1. O agente vê que pagamentos ainda não têm fatura e procura a fatura no email.
  2. Guarda o ficheiro no finko, com o tipo, o título, o valor e as datas que tirou do documento: o finko não lê o ficheiro.
  3. Só liga a fatura a um pagamento quando exatamente um movimento corresponde. Quando há dúvida, guarda a fatura sem ligação, e ela fica na lista para decidires tu (filtro Sem ligação).

O mesmo ficheiro nunca fica guardado duas vezes: se o agente o enviar outra vez, o finko devolve o documento que já existe. Valem os mesmos limites da app: PDF ou fotografia (JPG, PNG, WebP ou HEIC), até 10 MB, e o limite de documentos do teu plano (10 no Free). Se o limite do Free estiver atingido, o agente diz-te em vez de insistir.

Um pagamento que o agente já ligou a um documento não te é perguntado dois dias depois: a pergunta de fatura só aparece para o que continua sem documento.

Algumas coisas o agente nunca faz, mesmo com permissão de escrita:

  • ligar um banco;
  • importar extratos;
  • faturação e plano;
  • partilhar com outras pessoas, incluindo convidar para um grupo;
  • mudar a palavra-passe ou apagar a conta;
  • mover dinheiro.

Há dois níveis de acesso:

  • Leitura: o agente consulta os teus dados. É sempre concedida.
  • Escrita: o agente também cria, altera e apaga o que geres no finko, nas áreas da tabela acima. Só existe se a deres.

Com o conector (OAuth), a permissão de escrita aparece no ecrã de autorização do finko, com a descrição do que o agente passa a poder fazer. Com uma chave de API, decides ao gerá-la, com o interruptor Permitir que o agente faça alterações.

Nenhum nível move dinheiro. O finko não executa pagamentos nem transferências, e o agente também não: um movimento planeado é só uma previsão, que passa a real quando o banco o reporta.

  • Conector (OAuth): em Definições → Agentes IA → Agentes ligados, clica no ícone do lixo ao lado do agente e confirma. O acesso termina de imediato: o agente deixa de conseguir consultar os teus dados e de renovar a ligação. Para voltar a ligar, adiciona o conector outra vez no agente. Convém também remover o conector no próprio agente (no Claude, em Definições → Conectores; no ChatGPT, nas definições de conectores), para não ficar uma entrada inativa.
  • Chave de API: em Definições → Agentes IA → Avançado: chaves de API, clica no ícone do lixo ao lado da chave e confirma. A chave deixa de funcionar de imediato.

Definições → Agentes IA → Agentes ligados lista os agentes ligados por conector, com o nome, o nível de acesso (Só leitura ou Leitura e escrita), há quanto tempo estão ligados e a última vez que foram usados. As chaves de API ficam logo abaixo, em Avançado: chaves de API.

  • O agente só vê o que as ferramentas devolvem. Não tem acesso à base de dados, nem às credenciais do banco, nem à tua palavra-passe.
  • Só a tua conta. Todas as consultas ficam limitadas à conta com que iniciaste sessão. Nenhuma aceita argumentos que alarguem o âmbito.
  • Escrita limitada às áreas acima. Com permissão de escrita, o agente cria, altera e apaga dentro dessas áreas, e mais nada. Não liga bancos, não importa extratos, não partilha com outras pessoas, não mexe na palavra-passe nem na conta, e não move dinheiro.
  • Os dados seguem para o fornecedor do agente. O que o agente lê passa a fazer parte da conversa que tens com o Claude, o ChatGPT ou outro. Aplica-se a política de privacidade desse fornecedor, não a do finko.
  • OAuth 2.1. Autorizas no finko e o agente nunca vê a tua palavra-passe. Com chave de API, o segredo é a chave, e é por isso que é revogável a qualquer momento.

O agente consulta mas não consegue alterar nada. Não lhe deste a permissão de escrita, ou ligaste-o antes de ela existir. Remove o conector no agente e adiciona-o outra vez: o ecrã de autorização volta a mostrar a permissão. Com chave de API, gera uma nova com o interruptor de escrita ligado.

Erro 401 ou “não autorizado”. A sessão expirou ou a chave foi revogada. Com o conector, volta a iniciar sessão (ou remove e adiciona o conector). Com chave de API, confirma que copiaste a chave inteira, que começa por finko_sk_live_, e que ela não aparece revogada em Definições → Agentes IA.

A janela de autorização não abre. Verifica se o browser bloqueou a janela de pop-up e permite-a para o site do agente. Se o pedido tiver expirado (o ecrã diz “Pedido inválido ou expirado”), volta ao agente e tenta ligar de novo.

O agente não encontra o finko ou diz que a ligação falhou. Confirma o endereço, que termina em /api/mcp, sem espaços nem barra a mais. Podes copiá-lo outra vez em Definições → Agentes IA.