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/mcpPor 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.
Em que planos está
Seção intitulada “Em que planos está”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.
Ligar o Claude
Seção intitulada “Ligar o Claude”Funciona no claude.ai, na aplicação para computador e no telemóvel. Não há nenhuma chave para copiar.
-
Abre Definições → Agentes IA no finko e clica em Copiar endereço.
-
No Claude, abre Definições → Conectores (ou claude.ai/settings/connectors).
-
Escolhe adicionar um conector personalizado e cola o endereço.
-
Inicia sessão no finko quando o Claude abrir a janela de autorização e clica em Autorizar.
Ligar o ChatGPT
Seção intitulada “Ligar o ChatGPT”-
Abre Definições → Agentes IA no finko e clica em Copiar endereço.
-
No ChatGPT, abre as definições de conectores (chatgpt.com) e escolhe criar um conector (ou app) personalizado.
-
Cola o endereço e escolhe a autenticação OAuth.
-
Inicia sessão no finko quando o ChatGPT abrir a janela de autorização e clica em Autorizar.
Ligar o Claude Code
Seção intitulada “Ligar o Claude Code”-
Corre este comando no terminal:
Terminal window claude mcp add --transport http finko https://api.finko.pt/api/mcp -
Dentro do Claude Code, escreve
/mcp, escolhe finko e inicia sessão no browser.
Ligar o Cursor e outros clientes MCP
Seção intitulada “Ligar o Cursor e outros clientes MCP”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.
Ligar um cliente sem OAuth, com chave de API
Seção intitulada “Ligar um cliente sem OAuth, com chave de API”Para clientes que ainda não suportam OAuth, usa uma chave de API e a ponte
mcp-remote.
-
Em Definições → Agentes IA, na secção Avançado: chaves de API, dá um nome à chave.
-
Se quiseres que o agente possa fazer alterações, liga Permitir que o agente faça alterações. Desligado, a chave só lê.
-
Clica em Gerar e copia a chave. Começa por
finko_sk_live_e só é mostrada uma vez. -
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 que o teu agente pode fazer
Seção intitulada “O que o teu agente pode fazer”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. |
Perguntas para experimentar
Seção intitulada “Perguntas para experimentar”- “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?”
Faturas que chegam por email
Seção intitulada “Faturas que chegam por email”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.
- O agente vê que pagamentos ainda não têm fatura e procura a fatura no email.
- 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.
- 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.
O que fica sempre contigo
Seção intitulada “O que fica sempre contigo”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.
Permissões
Seção intitulada “Permissões”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.
Revogar o acesso
Seção intitulada “Revogar o acesso”- 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.
Ver o que está ligado
Seção intitulada “Ver o que está ligado”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.
Privacidade e segurança
Seção intitulada “Privacidade e segurança”- 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.
Resolução de problemas
Seção intitulada “Resolução de problemas”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.