La Sua IA sulla nostra app: gestire le SOP con Claude

Tempo fa, su LinkedIn, qualcuno ha scritto a un produttore di software più o meno così: «Non voglio la vostra IA dentro la vostra app. Voglio la mia IA sulla vostra app.» La frase coglie un punto che molti fornitori trascurano. Chi lavora ogni giorno con il proprio assistente IA non vuole un assistente diverso e più piccolo in ogni software. Vuole che il suo assistente sappia usare il software.

Abbiamo applicato questa frase a Viali stesso: Viali ora ha un server MCP. Il primo ambito che apre sono le SOP e le linee guida di una clinica.

Il manuale della qualità come cartella piena di file

Nella maggior parte delle cliniche il manuale di gestione della qualità è una cartella: file Word, PDF generati da questi, un elenco Excel delle versioni, più copie sul disco di rete e negli allegati e-mail. Quando cambia una regola di livello superiore, per esempio la direttiva interna sull'igiene delle mani, inizia la ricerca: quali dei quaranta documenti trattano l'argomento? Quale copia è quella valida? Chi ha modificato qualcosa per ultimo?

In Viali una SOP non è un allegato. È un documento digitale con uno stato (bozza o pubblicata), una cronologia delle versioni, richieste di firma al team e un assistente che risponde alle domande del personale in base alle linee guida pubblicate. Questa era la base. Con il server MCP anche un agente IA può lavorare con questi documenti, e con molti alla volta.

Cosa fa il server MCP

MCP (Model Context Protocol) è uno standard aperto con cui gli agenti IA usano gli strumenti di altri programmi. All'indirizzo https://use.viali.app/mcp Viali mette a disposizione 12 strumenti per le SOP di una clinica:

• Leggere e trovare: elencare le SOP (per stato, argomento o parola chiave), leggere una SOP completa, cercare nel testo (bozze incluse).
• Scrivere: creare una nuova SOP (sempre come bozza), modificare una SOP, pubblicarla o riportarla a bozza.
• Versioni: vedere la cronologia delle versioni, leggere una versione precedente e ripristinarla.
• Argomenti: assegnare argomenti (tag), elencare tutti gli argomenti della clinica con la loro frequenza, rinominare un argomento in tutte le SOP o unire due argomenti.

Di proposito non esiste uno strumento per cancellare. Cancellare resta una decisione che una persona prende in Viali.

Una richiesta invece di quaranta finestre

L'esempio sopra mostra una richiesta tipica: «Aggiorna tutte le SOP di igiene alla nuova direttiva sulla disinfezione delle mani e assegna loro l'argomento "Hygiene".» L'agente legge la nuova direttiva da un file locale, cerca in Viali tutte le SOP interessate, le legge una per una, adatta il testo e assegna l'argomento. Alla fine riferisce cosa ha fatto e a cosa deve fare attenzione la clinica.

Lo usiamo noi stessi in Viali. Il nostro fondatore scrive e aggiorna ormai le SOP da utente tramite Claude Code, molto più velocemente che con l'IA nell'editor delle SOP («Genera bozza con AI», «Migliora con AI»). L'editor va bene per una singola linea guida. Per un intero manuale il proprio agente è in vantaggio: ha a portata di mano gli altri documenti della clinica, lavora molte SOP in un solo passaggio e una persona controlla il risultato invece di digitare ogni modifica.

Gli argomenti sono una novità in Viali. Compaiono nell'elenco delle SOP come piccole etichette e come filtro, per gli amministratori e per il personale. Un'infermiera trova tutte le linee guida sull'igiene con un clic.

Nulla va perso

Una clinica può affidare le proprie linee guida a un agente solo se ogni modifica è tracciabile e reversibile. Per questo l'agente segue le stesse regole dell'app:

• Ogni modifica è una versione. La cronologia mostra il nome della persona che ha creato l'accesso con l'aggiunta «(Claude)», per esempio «Dr. Anna Keller (Claude)». Ogni versione precedente può essere ripristinata in qualsiasi momento.
• Nessuna sovrascrittura silenziosa. Ogni modifica indica la versione su cui si basa. Se nel frattempo una collega ha modificato la SOP in Viali, Viali rifiuta la modifica. L'agente rilegge il testo attuale e applica la sua modifica a quello.
• Le nuove SOP nascono come bozza. Il personale le vede solo dopo la pubblicazione.
• Le firme restano nelle Sue mani. La pubblicazione non invia richieste di firma. Se ci sono ancora richieste aperte su una versione precedente, l'agente riceve un avviso che quelle persone stanno firmando il testo vecchio.

Sicurezza: una clinica, solo SOP, nessun dato dei pazienti

• Solo SOP. Il server MCP non conosce pazienti, appuntamenti, fatture o altri dati. Nessuno strumento va oltre le SOP, e nessun'altra interfaccia di Viali accetta questo accesso.
• Una clinica. Ogni accesso appartiene a una sola clinica.
• Personale e a tempo. Un amministratore della clinica crea l'accesso per sé. Viene mostrato una sola volta, vale 30, 60 o 90 giorni e può essere revocato in qualsiasi momento. Se la persona perde il ruolo di admin o manager, l'accesso smette subito di funzionare.
• Limitato. Al massimo 120 richieste al minuto per accesso. Quando una clinica è in sola lettura per motivi di fatturazione, Viali rifiuta ogni modifica.

Maggiori dettagli su come Viali conserva i dati nella pagina sicurezza.

Come iniziare

1. 1In Viali, in Admin → Integrazioni, scheda API Key, aprire il riquadro Accesso IA (MCP), scegliere un nome e la validità e fare clic su Crea accesso.
2. 2Incollare il comando mostrato una sola volta in un terminale in cui gira Claude Code:

claude mcp add --transport http viali https://use.viali.app/mcp --header "Authorization: Bearer vct_…"

1. 1Dare una richiesta a Claude Code, per esempio: «Elenca tutte le SOP senza argomento e proponi argomenti adatti.»

Oggi Claude Code si collega con l'accesso. È previsto un collegamento per claude.ai e Claude Desktop tramite OAuth. La descrizione tecnica si trova nella documentazione API di Viali.

Perché lo costruiamo così

Un software per cliniche non deve inventare da sé ogni assistente IA. Deve offrire i propri dati ben strutturati, versionati e limitati in modo sicuro, perché l'assistente della clinica possa lavorarci. Le SOP sono il primo ambito. Le regole restano le stesse: accesso chiaramente limitato, ogni modifica tracciabile, nessun dato dei pazienti.

Domande frequenti

Che cos'è il server MCP di Viali?

Un endpoint all'indirizzo https://use.viali.app/mcp che usa il Model Context Protocol (Streamable HTTP). Permette a un agente IA come Claude Code di elencare, leggere, cercare, creare, modificare, pubblicare, versionare ed etichettare le SOP di una clinica. Gli strumenti sono 12. Non esiste uno strumento per cancellare.

L'agente IA vede i dati dei pazienti?

No. L'accesso vale per una sola clinica e solo per le SOP. Nessuno strumento del server MCP raggiunge pazienti, appuntamenti o altri dati, e nessun'altra interfaccia di Viali accetta questo accesso.

Chi può creare un accesso e per quanto tempo vale?

Un amministratore della clinica crea un accesso personale in Admin → Integrazioni, scheda API Key, riquadro Accesso IA (MCP). Il token viene mostrato una sola volta. Vale 30, 60 o 90 giorni, può essere revocato in qualsiasi momento e smette di funzionare quando la persona perde il ruolo di admin o manager.

Cosa succede se un collega modifica la stessa SOP nello stesso momento?

Ogni modifica deve indicare la versione su cui si basa. Se nel frattempo la SOP è cambiata, Viali rifiuta la modifica e indica il numero della versione attuale. L'agente rilegge il testo attuale e applica la sua modifica a quello. Nulla viene sovrascritto in silenzio.

Con quali strumenti IA funziona?

Oggi con Claude Code, collegato con un solo comando. È previsto un collegamento per claude.ai e Claude Desktop tramite OAuth.