Pular para o conteúdo

Agentes de IA externos

Na appDefinições → Assistentes IA

Se usas um assistente de IA fora do finko, podes dar-lhe acesso só de leitura à tua conta. A partir daí perguntas-lhe pelas tuas finanças no sítio onde já estás a trabalhar, sem abrir a app.

A ligação usa o Model Context Protocol (MCP), e as consultas disponíveis são exatamente as mesmas do kompanion.

É a forma mais simples, e não há nenhum segredo para copiar. Funciona em clientes que suportem conectores remotos, como o Claude.

  1. Abre Definições → Assistentes IA.

  2. Copia o endereço do conector MCP.

  3. No teu cliente, adiciona um conector remoto e cola o endereço.

  4. És reencaminhado para o finko para iniciares sessão e autorizares o acesso, que é só de leitura.

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

  1. Em Definições → Assistentes IA, na secção das chaves de API, dá um nome à chave e clica em Gerar.

  2. Copia a chave. Começa por finko_sk_live_ e só é mostrada uma vez.

  3. No teu cliente, configura a ponte com essa chave:

    Terminal window
    npx mcp-remote <endereço-do-conector> \
    --header "Authorization: Bearer finko_sk_live_…"
  1. Abre Definições → Assistentes IA.

  2. Revoga a chave ou o conector que já não usas.

O acesso é estruturalmente de leitura, não por política: as consultas expostas devolvem dados e mais nada. Não há nenhuma que crie, altere ou apague seja o que for, e nenhuma aceita argumentos que alarguem o âmbito para lá da conta autenticada.

O conector nativo usa OAuth 2.1 — autorizas no finko, e o cliente nunca vê a tua palavra-passe. Com chave de API, o segredo é a chave, e é por isso que ela é revogável a qualquer momento.