Connettore Ufficiale

Flusia CRM · Server MCP

Connetti Flusia CRM agli assistenti AI compatibili con il Model Context Protocol: Claude.ai, Claude Desktop, Claude Code, ChatGPT Connectors e mobile app Claude.

Endpoint MCP:https://api.flusia.it/mcp
Versione:1.0.0

1. Cos’è

In parole semplici: collegando Flusia al tuo assistente AI (per esempio Claude o ChatGPT) puoi chiedergli, scrivendo come parleresti a un collega, di cercare dati, preparare un report o creare attività nel CRM. Il collegamento lo attivi e lo stacchi tu, e l’assistente può fare solo ciò che i tuoi permessi consentono.

Il server MCP di Flusia (il “ponte” tecnico che rende possibile il collegamento) permette all’assistente di lavorare su lead, offerte, task, progetti, fatture, newsletter e chat WhatsApp del CRM, attraverso gli strumenti autorizzati per il collegamento.

Gli strumenti disponibili dipendono dalla configurazione del servizio e dai permessi del collegamento Flusia. Verifica quali azioni autorizzi quando connetti il tuo assistente.

2. Funzionalità e casi d’uso

Esempi di aree del CRM su cui l’assistente può lavorare, secondo i permessi del collegamento. La colonna “Prefisso strumenti” è il nome tecnico che vedono gli sviluppatori: puoi ignorarla.

RisorsaPrefisso strumentiCapacità
Lead / Clienticrm_clients_*Crea, leggi, modifica, elimina, ricerca, offerte collegate, note, registrazioni
Offertecrm_deals_*Crea, leggi, modifica, elimina, stato, servizi, contatti, provvigioni, note
Taskcrm_tasks_*Crea, leggi, modifica, elimina, checklist, allegati, tag, assegnazione
Progetticrm_projects_*Crea, leggi, modifica, elimina, brief, attività, archivio, assegnazioni
Attivitàcrm_activities_*Timeline call, meeting, email, note
Servizicrm_services_*Catalogo servizi/prodotti
Pipelinecrm_pipelines_*Pipeline e stage di vendita
Fatturecrm_invoices_*Lettura fatture Fatture in Cloud, allocazione, coda
Newslettercrm_newsletter_*Liste, campagne email, blacklist, quota, domini
WhatsAppcrm_whatsapp_*Chat, messaggi, note, con accesso limitato alle chat di ciascun utente
QR Codescrm_qr_codes_*Generazione e gestione QR tracking
Wikicrm_wiki_*Knowledge base organizzazione
Workflowcrm_workflows_*Passaggi e trigger delle automazioni
Settingscrm_settings_*Impostazioni dell’azienda (utenti, ruoli, template)
Statistichecrm_stats_*Indicatori chiave e analisi del fatturato

Ogni strumento dice all’assistente se si limita a leggere oppure se può modificare o eliminare dati.

Casi d’uso tipici

  • Assistente vendite in conversazione: cerca lead, aggiorna lo stato, crea task di follow-up, invia messaggi WhatsApp.
  • Report a partire da una richiesta scritta in linguaggio naturale (“Riepilogo delle offerte vinte questa settimana per la pipeline X”).
  • Operazioni sui dati del CRM: verifica le azioni proposte e le impostazioni di conferma del tuo assistente prima di autorizzarle.
  • Avvio di un nuovo cliente: lead, offerta, task e checklist in un’unica conversazione.
  • Controlli: l’assistente consulta lo stato del CRM per capire anomalie segnalate dal team.

3. Come connetterti

Claude.ai (web)

  1. Accedi a claude.ai e apri Personalizza → Connettori → Aggiungi
  2. Nome: "Flusia CRM"
  3. URL del server MCP remoto: https://api.flusia.it/mcp
  4. Continua. Al primo utilizzo Claude ti chiede di accedere con il tuo account Flusia (OAuth): non serve generare né incollare nessun token.
  5. Funziona anche con il piano gratuito di Claude, che però consente un solo connettore personalizzato.
La finestra di Claude "Aggiungi connettore personalizzato" con dentro l'indirizzo del server MCP di Flusia
In Claude: Personalizza → Connettori → Aggiungi. Nome libero, indirizzo https://api.flusia.it/mcp.

ChatGPT

Su ChatGPT web, Business ed Enterprise/Edu supportano MCP completo; Pro consente collegamenti con accesso in lettura. In Plugins aggiungi il server MCP: la modalità sviluppatore non è un passaggio obbligatorio. Disponibilità e azioni dipendono dai permessi del workspace.

Requisiti e istruzioni ufficiali OpenAI

4. Esempi di utilizzo

Esempio 1: creare un lead scrivendo in linguaggio naturale

Richiesta dell’utente (esempio)

"Crea un nuovo lead chiamato Studio Dentistico Bianchi, partita IVA 12345678901, con sede a Milano in via Roma 10, e assegna l’opportunità a Mario Rossi. Aggiungi una task di follow-up per chiamarlo domani."

Passaggi che l’assistente compie (esempio)
  1. crm_users_list (cerca Mario Rossi → ottiene user_id)
  2. crm_clients_create_lead con business_name, vat_number, indirizzo, assigned_to
  3. crm_tasks_create con client_id del lead appena creato, due_date = domani
Risposta (esempio)
L’AI conferma con i 2 ID creati e un riepilogo verbale.

Esempio 2: report delle offerte vinte nell’ultimo mese

Richiesta dell’utente (esempio)

"Quali offerte abbiamo chiuso come vinte nell’ultimo mese? Mostra il fatturato totale e le prime 3 per valore."

Passaggi che l’assistente compie (esempio)
  1. crm_stats_revenue con start_date e end_date → ottiene il fatturato totale e il tasso di successo
  2. crm_deals_list con status: "accepted", limit: 50
  3. L’assistente ordina i risultati e prepara tabella e indicatori
Risposta (esempio)
Esempio con cifre di fantasia.
Fatturato chiuso nell’ultimo mese: €127.430
Tasso di successo: 34%
Prime 3 offerte: ACME Corp €45.000, Studio Verdi €28.500, TechStart €19.800

Esempio 3: pulizia dei dati con conferma

Richiesta dell’utente (esempio)

"Cancella tutti i lead duplicati di ‘Mario Rossi’ con la stessa partita IVA."

Passaggi che l’assistente compie (esempio)
  1. crm_clients_search con q: "Mario Rossi" → candidati
  2. L’assistente individua le partite IVA duplicate
  3. L’assistente chiede conferma esplicita all’utente, perché crm_clients_delete è segnalato come azione che elimina dati
  4. Solo dopo la conferma esegue crm_clients_delete
Risposta (esempio)
Esempio: l’utente vede la richiesta di conferma per ogni operazione e, alla fine, un riepilogo di ciò che è stato fatto.

Gli strumenti che eliminano o annullano dati (cancellare, rimuovere, annullare, archiviare, togliere un’assegnazione) sono segnalati come “distruttivi” (destructiveHint: true). In questi casi l’assistente deve prima chiedere la tua conferma: è il principio “human-in-the-loop”, cioè l’ultima parola resta a una persona.

5. Privacy e protezione dati

Il trattamento dei dati avviene secondo:

Cosa transita dal MCP

  • Solo quello che l’assistente chiede davvero: se gli domandi le offerte ferme, passano quelle, non il resto
  • Quello che l’assistente riceve finisce nella tua conversazione con lui, quindi viene trattato da chi lo fornisce (Anthropic per Claude, OpenAI per ChatGPT), secondo le condizioni che hai accettato con loro: sono aziende statunitensi, e questo vale anche se il tuo Flusia resta in Europa
  • Il collegamento lo attivi tu e lo puoi staccare quando vuoi: finché non lo colleghi, dal CRM non esce nulla
  • Di ogni richiesta teniamo traccia per 30 giorni, senza conservare il contenuto

Cosa NON transita

  • Il server Flusia non riceve la conversazione tra te e l’assistente, ma solo le richieste degli strumenti che l’assistente decide di usare
  • Chi fornisce l’assistente (Anthropic o OpenAI) vede le risposte dentro la conversazione, ma non ha nessun accesso diretto al database di Flusia

6. Supporto

Supporto tecnicosupport@flusia.it
Security / vulnerabilitàsecurity@flusia.it
Privacy / GDPRprivacy@flusia.it
Status pagehttps://status.flusia.it
Documentazione utente/wiki

Tempi di risposta: prima risposta entro 24 ore lavorative per l’assistenza standard; le segnalazioni di sicurezza confermate sono trattate con priorità.

Pronto a connettere il CRM al tuo assistente AI?

Crea un account Flusia, verifica i requisiti del tuo assistente e segui i passaggi per autorizzare il collegamento.