Flusia CRM — Server MCP

2. Funzionalità e casi d’uso

Risorse esposte (212 strumenti totali):

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 → Settings → Connectors → Add custom connector
2. Nome: "Flusia CRM"
3. Server URL: https://api.flusia.it/mcp
4. Conferma. Al primo utilizzo Claude avvia il flusso OAuth.

Claude Desktop

In ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "flusia-crm": {
      "url": "https://api.flusia.it/mcp"
    }
  }
}

Riavvia Claude Desktop. Al primo tool call partirà il flusso OAuth nel browser.

Claude Code

claude mcp add flusia-crm https://api.flusia.it/mcp

Token API statico (server-to-server)

Per integrazioni server-to-server (script, automazioni) genera un token API permanente:

1. Accedi a app.flusia.it → Impostazioni → API Tokens
2. Crea nuovo token con i permessi necessari (per risorsa: read/write/delete)
3. Usa il token come Authorization: Bearer flusia_<token>

4. OAuth 2.1

Il server espone i metadati di discovery standard:

Caratteristiche

• Grant type: authorization_code + refresh_token
• PKCE obbligatorio (S256)
• Token endpoint auth: none (public client)
• Scope: mcp:full (limitato dai permessi CRM dell’utente)
• Tutti i redirect URI HTTPS validi sono accettati in produzione

Callback supportati senza configurazione

• https://claude.ai/api/mcp/auth_callback
• https://claude.com/api/mcp/auth_callback
• http://localhost:6274/oauth/callback (MCP Inspector)
• http://localhost:6274/oauth/callback/debug

5. Esempi di utilizzo

L’AI conferma con i 2 ID creati e un riepilogo verbale.

Revenue chiuso ultimo mese: €127.430
Win rate: 34%
Top 3 deal: ACME Corp €45.000, Studio Verdi €28.500, TechStart €19.800

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:

• Privacy Policy
• Termini e Condizioni
• DPA (Data Processing Agreement) su richiesta a privacy@flusia.it

Cosa transita dal MCP

• Solo le richieste/risposte ai tool MCP esplicitamente invocati dall’AI
• I log includono solo organization_id, tool name, timing e status code — non i payload utente
• Retention log: 30 giorni
• Server: OVH Roubaix (Francia, UE)
• Dato applicativo: Supabase EU (Frankfurt, eu-central-1)

Cosa NON transita

• Il server Flusia non riceve la conversazione utente-AI, solo gli argomenti dei tool che l’AI decide di invocare
• Anthropic (claude.ai) può vedere le risposte dei tool nella conversazione, ma non ha accesso diretto al database Flusia

7. Supporto

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