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’è

Il server MCP di Flusia espone ~212 strumenti che permettono a un assistente AI di leggere e modificare in autonomia lead, deal, task, progetti, fatture, campagne newsletter, chat WhatsApp e altre entità del CRM dell’organizzazione associata al token.

Il modello di permessi granulare configurato dall’amministratore viene rispettato: l’AI non può mai fare via MCP più di quanto l’utente è già autorizzato a fare lato CRM.

2. Funzionalità e casi d’uso

Risorse esposte (212 strumenti totali):

RisorsaPrefisso strumentiCapacità
Lead / Clienticrm_clients_*CRUD, ricerca, deal correlati, note, registrazioni
Dealcrm_deals_*CRUD, status, servizi, contatti, commissioni, note
Taskcrm_tasks_*CRUD, checklist, allegati, tag, assegnazione
Progetticrm_projects_*CRUD, brief, attività, archive, 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, ACL per-utente
QR Codescrm_qr_codes_*Generazione e gestione QR tracking
Wikicrm_wiki_*Knowledge base organizzazione
Workflowcrm_workflows_*Automation builder steps + trigger
Settingscrm_settings_*Configurazioni org (utenti, ruoli, template)
Statistichecrm_stats_*Snapshot KPI + revenue analytics

Ogni strumento dichiara le annotazioni MCP standard (readOnlyHint per le letture, destructiveHint per le operazioni irreversibili) come richiesto dalla MCP Directory Policy di Anthropic.

Casi d’uso tipici

  • Assistente vendite conversazionale: cerca lead, aggiorna stato, crea task di follow-up, invia messaggi WhatsApp.
  • Reporting automatico da prompt naturale ("Riepilogo dei deal vinti questa settimana per pipeline X").
  • Bulk operation safe: l’AI propone, l’utente conferma esecuzione (human-in-the-loop sui tool distruttivi).
  • Onboarding cliente: lead + deal + task + checklist in un singolo turno conversazionale.
  • Diagnostica: l’AI interroga lo stato del CRM per investigare anomalie segnalate dagli operatori.

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

Lo stesso indirizzo si aggiunge fra i connettori di ChatGPT. Attenzione al piano: il supporto completo a MCP passa dalla modalità sviluppatore ed è riservato ai piani Business ed Enterprise/Edu su ChatGPT web (documentazione OpenAI, settembre 2026). Sui piani personali la funzione non è disponibile.

5. Esempi di utilizzo

Esempio 1: Creare un lead da chat naturale

Prompt utente

"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."

Tool chain attesa
  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
Output atteso
L’AI conferma con i 2 ID creati e un riepilogo verbale.

Esempio 2: Report deal vinti dell’ultimo mese

Prompt utente

"Quali deal abbiamo chiuso vinti nell’ultimo mese? Mostra revenue totale e il top 3 per valore."

Tool chain attesa
  1. crm_stats_revenue con start_date e end_date → ottiene total_revenue e win_rate
  2. crm_deals_list con status: "accepted", limit: 50
  3. L’AI ordina e produce tabella + KPI
Output atteso
Revenue chiuso ultimo mese: €127.430
Win rate: 34%
Top 3 deal: ACME Corp €45.000, Studio Verdi €28.500, TechStart €19.800

Esempio 3: Cleanup conversazionale con conferma

Prompt utente

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

Tool chain attesa
  1. crm_clients_search con q: "Mario Rossi" → candidati
  2. Filtro client-side per VAT duplicate
  3. Il client MCP chiede conferma esplicita all’utente perché crm_clients_delete ha destructiveHint: true
  4. Su conferma → loop di crm_clients_delete
Output atteso
L’utente vede il prompt di conferma per ogni operazione, l’AI mostra il riepilogo finale.

I tool con destructiveHint: true (delete, remove, cancel, archive, unassign) attivano automaticamente il pattern human-in-the-loop nei client MCP, che chiedono conferma utente prima dell’esecuzione.

6. 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 utente-AI, solo gli argomenti dei tool che l’AI decide di invocare
  • Chi fornisce l’assistente (Anthropic o OpenAI) vede le risposte dentro la conversazione, ma non ha nessun accesso diretto al database di Flusia

7. Supporto

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

SLA: risposta entro 1 giorno lavorativo per supporto standard, entro 4 ore lavorative per problematiche di sicurezza confermate.

Pronto a connettere il CRM al tuo assistente AI?

Crea un account Flusia e collega il connector MCP in meno di 5 minuti. Nessuna configurazione lato server richiesta.

Inizia gratis Documentazione completa