Istruzioni del server MCP di Finch
Collega Finch al tuo assistente AI preferito
Porta il tuo quadro finanziario direttamente nella tua interfaccia di chat AI preferita. Collegando Finch ad assistenti come Claude, ChatGPT o Gemini, puoi fare domande sui tuoi soldi in linguaggio semplice, ad esempio:
La connessione è completamente senza password e immediata. Non devi copiare chiavi API né gestire token complessi — abbini semplicemente il tuo assistente tramite l'app Finch e approvi l'accesso con la sicurezza biometrica come Face ID o impronta digitale.
Cosa può fare il tuo assistente
Finch gestisce un server Model Context Protocol (MCP) che concede al tuo assistente un singolo ambito data:read con 11 strumenti di sola lettura, lavorando esclusivamente sui dati che Finch già possiede. Tutto è in sola lettura: l'assistente può vedere la tua panoramica finanziaria, ma non può modificare nulla, non può spostare denaro e non spinge mai Finch a contattare una banca. I dati sono aggiornati all'ultimo refresh nell'app Finch, e puoi interrompere la connessione dall'app in qualsiasi momento.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
get_net_worth | Vedi l'andamento del tuo patrimonio netto su 1D, 1W, 1M, 6M o YTD nella tua valuta di base. |
list_accounts | Vedi i conti con tipo, valuta, saldo e timestamp dell'ultimo aggiornamento (numeri di conto mascherati alle ultime 4 cifre). |
list_transactions | Recupera le tue transazioni recenti, dalla più recente, con un intervallo di date opzionale (fino a 100 per chiamata). |
search_transactions | Cerca nella cronologia delle transazioni in linguaggio naturale (fino a 25 risultati). |
get_spending_summary | Confronta entrate e uscite su 1W, 1M, 6M, 1Y o YTD su tutti i conti. |
list_stock_holdings | Vedi le tue posizioni in azioni ed ETF. |
list_crypto_holdings | Vedi le tue posizioni in criptovalute. |
search_investment_transactions | Sfoglia i tuoi acquisti e vendite, filtrabili per simbolo. |
list_goals | Controlla i tuoi obiettivi di risparmio e i tuoi progressi. |
list_assets | Vedi gli altri beni che monitori manualmente (immobili, veicoli, oggetti di valore). |
get_market_snapshot | Leggi il briefing di mercato condiviso di Finch — umore, movimenti e titoli (non personale). |
Importante
- Limiti del piano: La disponibilità dei dati e la frequenza di aggiornamento tra l'app Finch e il tuo server MCP dipendono dal tuo abbonamento (Free o Premium).
- Aggiornamento dei conti: Deve essere avviato direttamente nell'app Finch (trascinando per aggiornare). Il tuo assistente legge sempre i dati più recenti disponibili nella tua app.
- Collegare e rimuovere conti: I conti bancari possono essere aggiunti solo in modo sicuro all'interno dell'app Finch. La gestione o la rimozione dei conti tramite MCP non è supportata nella versione attuale.
- Azioni di scrittura e chat: Il server MCP di Finch è strettamente in sola lettura. La chat Finch AI in-app e le operazioni di scrittura non sono disponibili tramite MCP. Le ricerche web sono gestite direttamente dall'assistente AI che hai scelto, non da Finch.
Quanto sono aggiornati i dati?
Il tuo assistente legge i dati che Finch già possiede e non contatta mai la tua banca.
Ogni conto mostra quando è stato aggiornato l'ultima volta, e il tuo assistente ti avvisa se un dato ha più di qualche giorno.
Per aggiornare i dati, apri l'app Finch (o trascina per aggiornare nell'app), poi chiedi di nuovo al tuo assistente.
I dati delle banche svizzere (ad esempio UBS, ZKB, PostFinance e altre) sono mostrati in base al loro ultimo aggiornamento nell'app Finch stessa.
Come collegare il tuo assistente
- 1
Aggiungi l'URL del server Finch nel tuo assistente
Aggiungi l'URL ufficiale del server Finch come connettore personalizzato nel tuo assistente. La connessione non richiede chiavi API, token o login web — il tuo assistente aprirà la pagina di abbinamento Finch nel tuo browser con un codice di 8 caratteri.
https://api.fjnch.ch/mcp - 2
Apri l'app Finch (richiede Finch 0.4.8 o successivo)
Sul telefono, tocca «Open Finch on this device» oppure apri l'app manualmente e vai su Menu › API keys › Connect an AI assistant.
- 3
Approva la connessione
Verifica il nome di dominio registrato dell'assistente nella schermata di consenso e conferma con Face ID o la tua impronta digitale. La connessione si completa automaticamente in pochi secondi.
- 4
Inizia a fare domande
La finestra di abbinamento del browser reindirizza o conferma automaticamente la connessione, e Finch appare nell'elenco dei tuoi assistenti collegati nell'app. Non ci sono token o credenziali da conservare.
Istruzioni passo passo per assistente
Claude (Web & Desktop)
- 1Vai su Settings › Connectors › Add custom connector.
- 2Imposta il nome su Finch e la Remote MCP server URL sull'URL ufficiale del server Finch. Lascia vuoti i campi del client OAuth — Finch gestisce automaticamente la registrazione del client.
- 3Clicca su Add, poi su Connect per aprire la pagina di abbinamento Finch.
- 4Completa i passaggi di approvazione nella tua app Finch.
- 5In qualsiasi sessione di chat, verifica che Finch sia abilitato nel menu degli strumenti e inizia a fare domande sulle tue finanze. (Cowork usa lo stesso connettore.)
ChatGPT
- 1Vai su Settings › Connectors › Advanced e attiva la Developer mode.
- 2Seleziona Connectors › Create. Inserisci Finch come nome e imposta la MCP server URL sull'URL ufficiale del server Finch. Scegli OAuth come tipo di autenticazione e clicca su Save/Create.
- 3Apri una nuova chat, seleziona il connettore Finch tra gli strumenti della modalità sviluppatore e segui le istruzioni del browser per abbinare la tua app.
Gemini CLI
- 1Apri il terminale e aggiungi il server Finch:
- 2Esegui /mcp auth finch in Gemini CLI per aprire la finestra di abbinamento, poi completa l'autorizzazione nell'app mobile Finch.
gemini mcp add --transport http finch https://api.fjnch.ch/mcpPrivacy e sicurezza
Dove vanno i tuoi dati
Qualsiasi informazione finanziaria che richiedi durante una conversazione viene inviata al provider dell'assistente che hai scelto (come Anthropic, OpenAI o Google), che può elaborarla al di fuori della Svizzera secondo i propri termini.
Controlla il dominio, non il nome
Qualsiasi applicazione può chiamarsi «Claude» o «ChatGPT». Verifica sempre il dominio registrato dell'assistente nella schermata di consenso dell'app Finch (ad es. claude.ai) e approva solo le richieste che hai avviato tu stesso da quel sito.
Non contatta mai la tua banca
Un assistente non può avviare un aggiornamento bancario né consumare le quote di aggiornamento bancario del tuo piano. Legge solo ciò che Finch già possiede.
Disconnetti quando vuoi
Disconnettiti in qualsiasi momento nell'app Finch tramite Menu › API keys › Connected assistants. La disconnessione ha effetto dalla richiesta successiva dell'assistente — eliminare semplicemente il connettore nell'app dell'assistente non revoca l'accesso lato Finch.
Nessun token da gestire
Non c'è nessuna chiave da conservare o tenere segreta. Le connessioni restano attive finché le usi; le connessioni inutilizzate per 7 giorni scadono e richiedono una nuova approvazione.
Dati del conto protetti
I numeri di conto sono sempre mascherati alle ultime quattro cifre. Gli IBAN completi e gli identificatori sensibili non lasciano mai i server di Finch.
Risoluzione dei problemi e FAQ
Il codice è scaduto.+
I codici di abbinamento sono validi per 10 minuti. Riavvia la configurazione della connessione dal tuo assistente per generare un nuovo codice.
Nessuna connessione in sospeso corrisponde a questo codice.+
Controlla bene i caratteri inseriti. I codici non contengono mai 0, O, 1 o I. Dopo 10 codici errati, l'inserimento viene sospeso per 10 minuti.
Reindirizzamento non registrato.+
L'assistente ha rimandato Finch a un indirizzo diverso da quello registrato. Rimuovi il connettore nel tuo assistente e aggiungilo di nuovo.
L'assistente dice che Finch non è autorizzato.+
Ciò accade dopo una disconnessione manuale nell'app o dopo 7 giorni consecutivi di inattività. Riavvia la connessione dal tuo assistente per approvare di nuovo l'accesso.
La pagina di abbinamento non torna all'assistente.+
Torna al tuo assistente e controlla se Finch risulta connesso. In caso contrario, rimuovi il connettore nel tuo assistente e aggiungilo di nuovo.
L'assistente risponde con saldi vecchi.+
L'assistente legge i dati Finch esistenti e non contatta mai direttamente la banca. Apri l'app Finch, trascina per aggiornare i tuoi conti, poi chiedi di nuovo all'assistente. Se l'app ti chiede di ricollegare la banca, completa prima quel passaggio.
Il pulsante «Open Finch on this device» non fa nulla / Non trovo «Connect an AI assistant».+
La versione dell'app installata è precedente alla 0.4.8. Aggiorna l'app Finch dall'App Store, poi inserisci il codice di abbinamento manualmente in Menu › API keys › Connect an AI assistant.
Accesso e supporto
Contatta il nostro team di supporto se hai problemi ad accedere al tuo server MCP o se vuoi richiedere una funzione MCP Server estesa per te o il tuo team.
Richiedi supporto





