App web
Apri il tuo avatar → Impostazioni → Assistenti IA collegati.
FINANCEIA · GUIDA AL COLLEGAMENTO CON L’IA
Collega Financeia a ChatGPT, Gemini e Claude
Dal primo collegamento a una transazione approvata: scegli cosa condividere, consulta i tuoi dati e verifica ogni modifica proposta.
URL del server MCP di produzione
https://api.financeia.app/mcpScegli OAuth. Non serve una chiave API del fornitore. La disponibilità dipende dall’account, dalla regione e dalle regole dell’area di lavoro; le interfacce possono cambiare.
Inizia con l’account e il profilo giusti
Accedi a Financeia e sincronizza i dati. I collegamenti con l’IA sono inclusi in tutti i piani e restano disattivati finché non dai il consenso.
Attiva Assistenti IA collegati, leggi tutte le dichiarazioni di consenso e conferma con la password attuale.
Condividi solo i profili personali o congiunti desiderati. Il permesso di lettura consente i resoconti; quello di proposta aggiunge suggerimenti alla revisione IA. L’accesso congiunto non supera mai i tuoi permessi.
App mobile
Apri il tuo avatar → Impostazioni → Preferenze di sicurezza → Assistenti IA collegati. Attiva l’interruttore e leggi il consenso.
ChatGPT
Aggiungi un plugin MCP personalizzato in ChatGPT
Usa ChatGPT sul web in un’area di lavoro che consenta server MCP personalizzati.
Apri Plugin → Aggiungi (+) → Aggiungi server MCP personalizzato. Nelle interfacce precedenti l’opzione può essere in App o Modalità sviluppatore.
Assegna il nome Financeia, inserisci l’URL di produzione indicato sopra e scegli OAuth. Lascia vuote le credenziali client, salvo che Financeia le abbia fornite alla tua organizzazione.
Leggi e conferma l’avviso, scegli Crea come plugin, poi Installa/Collega. Completa l’autorizzazione Financeia descritta sotto.
Apri una nuova chat. Digita @, scegli Financeia e chiedi l’elenco dei profili condivisi. Controlla l’account prima di proseguire.
Gemini
Crea un’app personalizzata in Gemini
Google richiede attualmente un account personale idoneo di un adulto negli Stati Uniti, la lingua inglese e il salvataggio dell’attività attivo. Un abbonamento non garantisce l’accesso; consulta i requisiti attuali di Google.
Apri Personalizza → Connettori, oppure Impostazioni → Intelligenza personale → App collegate.
Scegli Crea app personalizzata, inserisci l’URL MCP di produzione e seleziona Avanti.
Leggi gli avvisi di Google, procedi con il collegamento degli account e completa l’autorizzazione Financeia sotto.
In una nuova chat, digita @ e scegli Financeia. Chiedi i profili condivisi. Se le app personalizzate non compaiono, verifica i requisiti di Google.
Claude
Aggiungi un connettore remoto in Claude
In Team o Enterprise, il proprietario dell’organizzazione potrebbe dover aggiungere il connettore; ogni membro autorizza poi il proprio account Financeia.
Apri Personalizza → Connettori → Aggiungi → Aggiungi connettore personalizzato. I proprietari possono usare anche Impostazioni organizzazione → Connettori.
Inserisci Financeia e l’URL MCP di produzione, poi Continua.
Scegli Accedi ora. Usa l’identità pubblicata supportata da Claude o la registrazione automatica; non scegliere Senza accesso e non incollare un token. Aggiungi → Collega.
Completa l’autorizzazione Financeia sotto. Attiva Financeia nel menu connettori/strumenti della chat e chiedi i profili condivisi in una nuova conversazione.
Trasforma un suggerimento in un dato confermato
Esempio con dati fittizi
Nel mio profilo Personale, proponi una spesa di 25 USD da Everyday checking, categoria Food & groceries, il 21 ottobre 2026, con descrizione «Pranzo dimostrativo della guida». Chiedimi i dettagli mancanti. Inviala una sola volta per la revisione.
Chiedi prima all’assistente di individuare profilo, conto e categoria esatti e confermare valuta, data e fuso orario. Deve chiedere i dati mancanti.
Controlla i dati della chiamata allo strumento prima di consentire la proposta. Una proposta non registra una transazione e non cambia il saldo.
Apri Revisione IA in Financeia sul web o sul telefono, scegli il profilo corretto e verifica importo, conto, valuta, data, categoria, descrizione e avvisi di duplicati. Approva la versione verificata, modificala e ricontrollala oppure rifiutala. Controlla la selezione prima delle approvazioni multiple.
Attendi la conferma. Dopo un’interruzione, usa get_proposal_status o get_batch_status e verifica la transazione tramite ricerca o dettagli prima di riprovare. Non reinviare mai un gruppo dall’esito incerto.
Almeno tre possibili duplicati in 30 secondi possono generare un avviso informativo. L’assistente deve controllare gli invii ripetuti; l’avviso non li rifiuta automaticamente.
Tutte le azioni supportate
Tutti i 58 strumenti, con permessi e campi di input. Gli identificatori tecnici restano invariati per corrispondere alle chiamate reali.
Inizia con list_profiles, poi passa il profile_id scelto. Usa get_capabilities, get_profile_context e get_data_completeness per funzioni, fuso orario, valute e copertura.
Riferimento JSON Schema completo (contratto tecnico)
Profili condivisi e permessilist_profilesLeggi / simula
Permesso: financeia:read
Input: Nessuno
Cerca conti consentitifind_accountsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), query, include_inactive, offset
Cerca categoriefind_categoriesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), kind, query, offset
Cerca posizioni di investimentofind_holdingsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), query, offset
Cerca immobilifind_propertiesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), query, offset
Cerca strumenti finanziarifind_instrumentsLeggi / simula
Permesso: financeia:read
Input: query (obbligatorio)
Quadro della situazione finanziariaget_financial_snapshotLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), currency
Spese per categoria e periodoget_spending_summaryLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start (obbligatorio), period_end (obbligatorio), currency
Riepilogo dei flussi di cassaget_cashflow_summaryLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), months, currency
Durata del fondo di emergenzaget_emergency_runwayLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), currency
Simula un acquisto senza registrarlosimulate_purchase_impactLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), amount (obbligatorio), currency (obbligatorio)
Cerca transazioni registratesearch_transactionsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start, period_end, text, category_id, account_id, limit, cursor
Saldi e riepilogo del contoget_account_summaryLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit
Riepilogo degli investimentiget_holdings_summaryLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit
Riepilogo degli immobiliget_property_summaryLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit
Copertura e qualità dei datiget_data_completenessLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio)
Proponi transazionipropose_transactionsProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), items (obbligatorio)
Proponi una correzionepropose_correctionProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), correction (obbligatorio)
Proponi una categoriapropose_categoryProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), category (obbligatorio)
Proponi un contopropose_accountProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), account (obbligatorio)
Proponi un investimentopropose_holdingProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), holding (obbligatorio)
Proponi un immobilepropose_propertyProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), property (obbligatorio)
Proponi l’ordine dei contipropose_account_orderProponi per revisione
Permesso: financeia:propose
Input: profile_id (obbligatorio), request_summary (obbligatorio), order (obbligatorio)
Stato della propostaget_proposal_statusLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), proposal_id (obbligatorio)
Stato del gruppoget_batch_statusLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), batch_id (obbligatorio)
Entità e identificatorifind_entitiesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Budget configurati per categorialist_budget_categoriesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Budget storici salvatilist_budget_snapshotsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Eventi pianificati e ricorrentilist_planned_eventsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Obiettivi e accantonamenti di risparmiolist_savings_goalsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Piani di debito e ipotesilist_debt_plansLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Modelli di inserimento salvatilist_entry_templatesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Regole di riconoscimento degli esercentilist_merchant_aliasesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Elenchi di monitoraggio delle speselist_spending_watchlistsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Definizioni dei rapporti salvatilist_saved_reportsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Programmazioni dei rapporti senza esecuzionelist_report_schedulesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit, expected_version, query
Funzioni disponibiliget_capabilitiesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio)
Fuso orario e valute del profiloget_profile_contextLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio)
Calendario finanziarioget_finance_calendarLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start (obbligatorio), period_end (obbligatorio)
Ricorrenze degli eventi pianificatiget_planned_occurrencesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start (obbligatorio), period_end (obbligatorio), series_id
Andamento delle entitàget_entity_performanceLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start (obbligatorio), period_end (obbligatorio), currency, entity_code (obbligatorio)
Revisione del ciclo di budgetget_budget_period_reviewLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start (obbligatorio), period_end (obbligatorio)
Storico dei cicli di budgetlist_budget_period_historyLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), offset, limit
Dettagli della transazioneget_transaction_detailLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), event_id (obbligatorio)
Cronologia delle modificheget_transaction_historyLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), event_id (obbligatorio), cursor
Ripartizioni della transazioneget_transaction_allocationsLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), event_id (obbligatorio)
Storico dei saldi registratiget_account_balance_historyLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), account_id (obbligatorio), months, through
Storico delle valutazioni degli investimentiget_holding_valuation_historyLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), holding_id (obbligatorio), offset, limit, expected_version
Dettagli dell’investimentoget_holding_detailLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), holding_id (obbligatorio)
Dettagli dell’immobileget_property_detailLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), property_id (obbligatorio)
Storico delle valutazioni immobiliariget_property_valuation_historyLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), property_id (obbligatorio), offset, limit, expected_version
Coda di revisione delle transazioniget_transaction_review_queueLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), query
Avanzamento del monitoraggio delle speseget_spending_watchlist_progressLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio)
Preferenze di notificaget_notification_preferencesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio)
Tassi di cambio dei rapportiget_reporting_ratesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), currency
Ricerche salvate in Libriget_saved_book_searchesLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio)
Evidenze dei valori del portafoglioget_portfolio_evidenceLeggi / simula
Permesso: financeia:read
Input: profile_id (obbligatorio), period_start (obbligatorio), period_end (obbligatorio), currency
Leggi ogni risultato nel suo contesto
Conserva periodo, valuta, date di osservazione, revisione e metadati di qualità. Segui la paginazione: la ricerca restituisce al massimo 25 transazioni per pagina. Se cambia la revisione, ricomincia in modo coerente. Un valore mancante non è zero. I budget salvati sono evidenze storiche. Le spiegazioni dell’assistente non sono consulenza finanziaria professionale.
Aiuto, ripristino e controllo
Manca l’opzione del connettore personalizzato
Verifica piano, regione, lingua e regole del fornitore. Potrebbe doverlo aggiungere il proprietario del team; consulta le istruzioni ufficiali sopra.
Il controllo di sicurezza non è disponibile
Ricarica la scheda di accesso a Financeia e lascia terminare il normale controllo Cloudflare. Verifica connessione e blocchi dei contenuti. Se persiste, comunica al supporto orario ed errore; non aggirare la verifica.
L’assistente vede il profilo sbagliato o nessun dato
Richiedi list_profiles. Verifica account Financeia, profili selezionati, sincronizzazione e copertura. Ricollega se l’autorizzazione è scaduta.
Una proposta compare due volte
Controlla prima lo stato della proposta/gruppo e Revisione IA. Leggi gli avvisi e rifiuta i suggerimenti in sospeso indesiderati; non reinviare alla cieca.
Disconnettere o limitare l’accesso
In Impostazioni Financeia → Assistenti IA collegati, revoca il collegamento, rimuovi un profilo o disattiva le connessioni. Rimuovilo anche presso il fornitore. L’accesso futuro si interrompe, ma i dati già inviati non vengono cancellati.
Quale ambiente usare?
Questa guida usa la produzione. L’ambiente di test ha account e controlli separati. Non condividere per errore dati privati con un collegamento di prova.