Collegare strumenti di IA (Claude, ChatGPT)

Redazione Flowtly11 min

Puoi collegare un assistente di IA come Claude o ChatGPT alla tua organizzazione Flowtly e porgli domande sui tuoi dati in linguaggio naturale. Invece di aprire Flowtly e navigare fino alla schermata giusta, puoi chiedere al tuo assistente cose come "Qual è il totale delle fatture scadute di questo mese?" oppure "Mostra le transazioni di questo trimestre per il nostro conto bancario principale" e ottenere una risposta tratta direttamente dai tuoi dati Flowtly in tempo reale.

La connessione può leggere i tuoi dati ed eseguire un insieme limitato di azioni, come creare o aggiornare fornitori, clienti, contratti, conti bancari e gruppi di costo, registrare ore di lavoro, creare o aggiornare attività, caricare un documento su una fattura specifica, e chiudere un prospect di vendita o un'opportunità. Non va mai oltre ciò che i tuoi permessi Flowtly già consentono, e ogni azione è uno strumento specifico e nominato — mai una funzione libera "fai qualsiasi cosa". È basata sul Model Context Protocol (MCP), lo standard aperto che gli strumenti di IA utilizzano per connettersi a fonti di dati esterne.

Cosa ti serve

  • Un account Flowtly con accesso ad almeno un'organizzazione.
  • Uno strumento di IA che supporti connettori MCP personalizzati (ad esempio Claude, ChatGPT o Gemini Enterprise su un piano che consente di aggiungere connettori).
  • L'indirizzo del connettore Flowtly: https://mcp.flowtly.eu

Come collegarsi

La configurazione si effettua una sola volta e richiede circa un minuto.

In Claude:

  1. Apri Impostazioni → Connettori (su un piano che consente connettori personalizzati).
  2. Fai clic su Aggiungi connettore personalizzato.
  3. Incolla l'indirizzo Flowtly https://mcp.flowtly.eu e conferma.
  4. Fai clic su Connetti accanto al nuovo connettore Flowtly. Si apre una finestra di accesso a Flowtly.

In ChatGPT:

  1. Apri le impostazioni dei connettori/integrazioni e scegli di aggiungere un connettore (un server MCP).
  2. Incolla https://mcp.flowtly.eu come indirizzo del server e continua.
  3. Quando richiesto, scegli di accedere / autorizzare.

In Claude Code (riga di comando):

  1. Esegui: claude mcp add --transport http flowtly https://mcp.flowtly.eu/mcp
  2. In Claude Code, seleziona Authenticate per il nuovo server Flowtly; si apre una finestra del browser.

In qualsiasi altro strumento MCP (compreso Gemini Enterprise):

  1. Individua dove il tuo strumento aggiunge un server MCP personalizzato o un connettore personalizzato. In Gemini Enterprise si trova nella console di amministrazione di Google Workspace.
  2. Indica l'indirizzo https://mcp.flowtly.eu. Per la maggior parte degli strumenti è l'unico dato necessario: Flowtly registra il tuo strumento automaticamente, quindi non c'è nulla da richiederci né alcuna chiave da ottenere.
  3. Se il tuo strumento chiede più di un indirizzo, si tratta di una configurazione OAuth standard e questi sono i valori:
    • Registrazione: https://mcp.flowtly.eu/oauth/register
    • Autorizzazione: https://mcp.flowtly.eu/oauth/authorize
    • Token: https://mcp.flowtly.eu/oauth/token
    • Metodo PKCE: S256 (obbligatorio)
    • Segreto client: nessuno — i connettori Flowtly sono client pubblici
  4. Prosegui con il passaggio di accesso qui sotto.

Se il tuo strumento ti mostra un ID client, copialo in un pezzo solo. È un'unica riga lunga senza spazi, e alcuni moduli di amministrazione la mandano a capo quando la incolli, impedendo alla connessione di funzionare. Se una connessione fallisce subito dopo averne incollato uno, cancella il valore e incollalo di nuovo invece di dare per scontato che la configurazione sia sbagliata.

Poi, lo stesso per tutti gli strumenti:

  1. Accedi a Flowtly nella finestra che si apre — con la tua normale email e password, esattamente come nell'app web. Se hai già effettuato l'accesso, questo passaggio viene saltato.
  2. Compare una schermata di consenso che indica che l'assistente vuole accedere ai tuoi dati Flowtly, mostrando esattamente cosa viene richiesto. Scegli l'organizzazione che vuoi collegare, quindi fai clic su Approva (oppure Rifiuta per annullare).
  3. Vieni riportato al tuo strumento di IA. Il connettore Flowtly è ora attivo e puoi iniziare a porre domande su quell'organizzazione.

Ogni connessione è legata a un'unica organizzazione. Se lavori su più organizzazioni, ripeti i passaggi e scegli un'organizzazione diversa ogni volta; l'assistente le mantiene separate.

Come funziona nella pratica

Dopo esserti collegato, basta chattare normalmente. Ad esempio, scrivi:

Quanto ci resta ancora da incassare in fatture questo mese?

L'assistente riconosce che si tratta di una domanda relativa a Flowtly, legge i dati delle fatture per l'organizzazione collegata e risponde con la cifra — ad esempio "Hai 4 fatture non pagate questo mese per un totale di 18.200 zł" — tratta dai tuoi dati in tempo reale. Non hai aperto Flowtly, eseguito un report o esportato nulla; hai posto una domanda e ottenuto una risposta. Puoi continuare a porre domande di approfondimento ("quali di queste sono scadute?") nella stessa conversazione.

Cosa puoi chiedere

Una volta collegato, il tuo assistente può leggere le parti della tua organizzazione che puoi già vedere in Flowtly, tra cui:

  • Transazioni — saldi, movimenti recenti, spese con una determinata controparte in un periodo.
  • Fatture — importi in sospeso, ciò che è stato pagato o ricevuto, totali per stato.
  • Contratti e i relativi piani di pagamento.
  • Controparti, fornitori, conti bancari, gruppi di costo e dati di riferimento correlati.
  • Resourcing — il piano confrontato con le ore effettivamente registrate, per persona per settimana; chi è in panchina in un periodo; cosa è prenotato in prospettiva; e le richieste di personale aperte, insieme a quanto già deciso su quelle precedenti. Se il tuo accesso lo consente, è possibile leggere anche i dati di ricavi, costi e margine alla base del piano. Le domande sul resourcing richiedono il modulo Resourcing nel tuo abbonamento.
  • Calendari di lavoro — i modelli di orario di lavoro definiti dalla tua organizzazione, quali sono in vigore in una determinata data e chi è assegnato a ciascuno.
  • Risorse umane — le richieste di assunzione aperte e i candidati proposti per esse.

Le domande relative a un periodo richiedono una data di inizio e una di fine — specifica quale periodo intendi, ad esempio "tra il 1° aprile e il 30 giugno" oppure "per luglio". L'assistente legge queste informazioni; le prenotazioni, i calendari e le richieste di assunzione vengono comunque creati e modificati in Flowtly.

Domande utili da provare:

  • "Quanto abbiamo speso con [controparte] lo scorso trimestre?"
  • "Elenca le nostre fatture scadute."
  • "Qual è il saldo del nostro conto principale e le ultime cinque transazioni?"
  • "A settembre, chi è in panchina?"
  • "Tra il 1° luglio e il 30 settembre, il piano ha retto — ore pianificate rispetto alle ore registrate per persona?"
  • "Quali richieste di personale sono ancora aperte e qualcuna di queste era già stata richiesta e rifiutata in precedenza?"

L'assistente restituisce solo cifre presenti in Flowtly e ogni risposta si basa sui tuoi dati reali e aggiornati per l'organizzazione collegata.

Onboarding di un collega

Dare accesso a qualcuno ha tre parti, e un assistente collegato può eseguirle tutte senza che tu apra Flowtly:

  1. Aggiungere la persona. L'assistente crea il suo profilo dipendente.
  2. Invitarla ad accedere. L'assistente invia un invito all'indirizzo email che fornisci, e Flowtly invia alla persona un invito scritto nella lingua dell'interfaccia configurata per la tua organizzazione. L'invito rimane in sospeso finché la persona non lo apre e configura il proprio accesso; l'assistente non può scegliere una password né accedere per suo conto.
  3. Impostare a cosa ha accesso. L'assistente assegna i gruppi di autorizzazioni.

L'invito e i gruppi di autorizzazioni sono indipendenti l'uno dall'altro, quindi l'accesso può essere concesso prima o dopo l'invio dell'invito. Si noti che i due non sono sostituti l'uno dell'altro: qualcuno che ha gruppi di autorizzazioni ma non è mai stato invitato non ha ancora modo di accedere, e una persona invitata senza gruppi di autorizzazioni può accedere ma vedere molto poco.

Richiedilo in linguaggio naturale, ad esempio "Aggiungi Anna Kowalska come dipendente, invitala a anna.kowalska@example.com e assegnale gli stessi gruppi di autorizzazioni del resto del team di consegna". Invitare qualcuno richiede la stessa autorizzazione necessaria per gestire le persone in Flowtly. Chiedere di invitare una persona che ha già un accesso non cambia nulla — l'assistente ti informa che ne ha già uno anziché inviare una seconda email.

Per gli stessi passaggi eseguiti a schermo, consulta le pagine Invite your team, Creating a New Employee e Permission groups.

Chiudere un prospect o un'opportunità

Un assistente collegato può chiudere il lavoro di vendita oltre che registrarlo. Può chiudere un prospect che non hai vinto, chiudere un'opportunità come vinta o persa, e riaprire entrambe in seguito.

La chiusura come persa chiede un motivo, scelto dall'elenco fisso che la tua organizzazione gestisce — non digitato come testo libero — il che è ciò che rende il lavoro perso contabilizzabile a fine trimestre. Una nota facoltativa può affiancarla. Chiedi in linguaggio naturale, ad esempio "Chiudi il prospect Acme come perso — hanno scelto un concorrente", e l'assistente abbina ciò che hai detto a una voce dell'elenco. Un motivo non presente nell'elenco viene rifiutato anziché registrato come scritto.

Due cose vale la pena sapere prima di chiedere:

  • La chiusura è un passaggio a sé, non una modifica. Un prospect o un'opportunità viene chiuso(a) da un'apposita azione di chiusura, non modificando un campo di stato nel record — quindi chiedi di chiuderlo, non di cambiarne lo stato.
  • Perso non è lo stesso di Non contattare. «Non contattare» è una richiesta di soppressione e blocca qualsiasi ulteriore registrazione nei confronti dell'azienda. Chiudere come perso registra solo che questa particolare opportunità non si è concretizzata, e ti lascia libero di ricontattare l'azienda in seguito.

La riapertura si comporta in modo diverso per i due, il che vale la pena sapere prima di chiederla. Un prospect riaperto riprende esattamente alla fase del funnel in cui si trovava. Un'opportunità riaperta torna alla prima fase della pipeline, non alla fase in cui si trovava al momento della chiusura, quindi la fai avanzare di nuovo tu stesso.

Sicurezza e privacy

  • Legge i tuoi dati e può eseguire un insieme limitato di azioni di scrittura. Un assistente collegato può creare o aggiornare dati come fornitori, clienti, contratti, conti bancari e gruppi di costo, registrare ore di lavoro, creare o aggiornare attività, caricare un documento su una fattura specifica, e chiudere un prospect o un'opportunità — sempre tramite azioni specifiche e nominate, e sempre limitato a ciò che il tuo stesso account può fare.
  • Limitato a una sola organizzazione. Una connessione vede sempre e solo l'unica organizzazione selezionata al momento della concessione dell'accesso. Non può raggiungere le tue altre organizzazioni.
  • Si applicano le tue autorizzazioni. L'assistente vede i dati tramite il tuo account, quindi è limitato a ciò che ti è consentito vedere in quell'organizzazione.
  • Mantieni il controllo. L'accesso è concesso da te, per un'unica organizzazione, e puoi disconnettere il connettore dal tuo strumento di IA in qualsiasi momento per revocarlo.

Domande frequenti

È sicuro affidarlo a uno strumento di IA? Sì. La connessione è limitata a una sola organizzazione e ai permessi del tuo account, e utilizza lo stesso accesso sicuro dell'app web di Flowtly. L'assistente può leggere i tuoi dati ed eseguire un insieme limitato di azioni (come creare o aggiornare fornitori, clienti, contratti e conti bancari, registrare ore di lavoro e caricare un documento su una fattura), ma solo ciò che tu stesso puoi fare in quell'organizzazione.

Può vedere le mie altre organizzazioni? No. Ogni connessione è vincolata all'unica organizzazione che scegli durante l'accesso. Per lavorare con un'altra organizzazione, aggiungi una connessione separata per essa.

Come la disconnetto? Rimuovi il connettore Flowtly dal tuo strumento di IA. Una volta rimosso, non potrà più leggere i tuoi dati Flowtly. Se la sessione scade, ti basterà accedere di nuovo la volta successiva che ti colleghi.

Quali strumenti di IA sono supportati? Qualsiasi strumento che supporti connettori MCP personalizzati — tra cui Claude, ChatGPT e Gemini Enterprise, su un piano che consente di aggiungerli. Non c'è un'app Flowtly separata da installare per ogni strumento né alcuna approvazione da richiedere: indirizza il connettore verso https://mcp.flowtly.eu e segui i passaggi di accesso sopra descritti. Uno strumento non citato qui funziona allo stesso modo, purché supporti lo standard aperto.

Per gli sviluppatori

Stai creando un'integrazione? Consulta il riferimento tecnico MCP — gli strumenti (tools/list / tools/call) e i dettagli JSON-RPC del connettore.

Mappa delle relazioni

Fa riferimento aConsumaDerivato daParte di
Documentato quiDocumentato altrove
invoice fatturato a counterparty. invoice tassato da tax-group. cost imputa a budget. cost dovuto a counterparty. bank-transaction riconciliato con invoice. bank-connection imports bank-transaction. contract pianifica payment-schedule-line. contract concordato con counterparty. contract allegato a budget. budget copre project. invoice fatturato da project. project collegato a budget. lead diventa counterparty. deal venduto a counterparty.fatturato atassato daimputa adovuto ariconciliato conimportspianificaconcordato conallegato acoprefatturato dacollegato adiventavenduto aFFattura — A sales document issued to a client: line items, dates, tax. It is created, reviewed, previewed and then sent.FatturaCControparte — The other side of a financial document — a client billed, or a supplier owed.ControparteGGruppo di imposte — The tax treatment applied to a line, so rates are set once rather than per document.Gruppo di imposteCCosto — Money the organisation owes or has spent, tracked against a budget.CostoBBudget — The financial envelope an engagement is measured against — what was planned, versus what has actually been spent.BudgetMMovimento bancario — A movement on a connected bank account. Matching it to an invoice or a cost is what makes the books agree with the bank.Movimento bancarioBBank connection — The consented link to one bank that transactions arrive through. It can stop working on its own — a consent expires or is withdrawn — so it reports whether it is still working.Bank connectionCContratto — The financial terms of an engagement: a structured set of payment schedule lines, in one direction or the other.ContrattoSScadenza di pagamento — One dated amount on a contract, in a direction — money owed to a supplier, or due from a client.Scadenza di pagamentoPProgetto — The core organizational unit for a business initiative, client engagement or internal work. Everything tracked — time, cost, invoicing, profitability — hangs off one.ProgettoPPotenziale cliente — A company you are working but that is not a customer yet. It sits at New, Contacted or Qualified, and everything done to it is logged against it.Potenziale clienteTTrattativa — A sale in progress: a customer, an amount, and the stage it has reached. It cannot exist without a customer, and its stage is never blank.Trattativa