01
Lo studio accende il server
Impostazioni del gestionale
Un utente autorizzato attiva il server MCP dalle impostazioni di MedicHub; il gestionale registra il consenso insieme al testo mostrato.
Approfondimento tecnico
Come si collega un assistente esterno a un gestionale sanitario: il server MCP di MedicHub
Un assistente esterno si collega a un gestionale sanitario attraverso un server MCP: è il gestionale a decidere quali dati espone, a chi e con quali permessi. MedicHub, il gestionale per studi medici sviluppato da AraLith, software house in provincia di Roma attiva dal 2007, non contiene né chiama modelli di intelligenza artificiale: espone 29 strumenti MCP, e l'assistente da collegare lo sceglie lo studio.
I fatti chiave
In sintesi
Il server MCP di MedicHub è il punto in cui il gestionale apre i propri dati a un assistente esterno, con confini decisi dallo studio.
- Nessuna AI dentro MedicHub: il gestionale non contiene né chiama modelli di intelligenza artificiale; l'assistente esterno lo sceglie lo studio.
- 29 strumenti in 4 gruppi: Configurazione 9, Agenda 5, Amministrazione 9, Dati clinici 6. Di questi, 21 leggono e 8 scrivono.
- Accesso con OAuth 2.1 e PKCE: l'assistente agisce con gli stessi permessi dell'utente nel gestionale.
- Pazienti come «paziente N»: è pseudonimizzazione, non anonimizzazione.
- Tutto spento per impostazione predefinita: server e strumenti si attivano uno per uno con consenso registrato; le scritture su agenda, diario, moduli e modelli dei messaggi restano in attesa di conferma nel gestionale, i preventivi nascono in bozza.
Che cos'è un server MCP e a cosa serve in un gestionale sanitario?
Un server MCP è il componente di un software che espone le sue funzioni secondo il Model Context Protocol, un protocollo aperto con cui un assistente esterno elenca gli strumenti disponibili e li chiama. In un gestionale sanitario serve a lasciare che lo studio usi l'assistente che preferisce senza dargli accesso diretto al database: ogni richiesta passa dagli stessi controlli dell'interfaccia del gestionale.
Cosa resta al gestionale
Autenticazione, permessi, pseudonimizzazione dei pazienti, registro delle chiamate e conferma delle scritture. È MedicHub a decidere quali dati escono e quali modifiche entrano.
Cosa fa l'assistente esterno
Interpreta la richiesta dell'utente e chiama gli strumenti attivi. Modello, fornitore e contratto li sceglie lo studio: MedicHub non li fornisce e non li incorpora.
Quali strumenti espone il server MCP di MedicHub?
Il server MCP di MedicHub espone 29 strumenti divisi in 4 gruppi: 21 leggono dati già registrati nel gestionale e 8 scrivono, cioè creano o modificano un elemento. Nessuno strumento elabora diagnosi, terapie o immagini cliniche: gli strumenti dei dati clinici restituiscono ciò che lo studio ha già annotato.
-
Configurazione
Moduli, modelli di SMS e di email, listino, medici, documentazione del gestionale e link alle schede. Scrivono 3 strumenti: moduli e modelli dei messaggi.
9 -
Agenda
Appuntamenti, analisi dell'agenda e ricerca degli spazi liberi. Scrivono 2 strumenti: creazione di un appuntamento e proposta di spostamento.
5 -
Amministrazione
Ricerca e dettaglio dei pazienti, preventivi, fatture, statistiche, proiezioni ed esportazione dei dati per il GDPR. Scrivono 2 strumenti: nuovo preventivo e nuova voce di preventivo.
9 -
Dati clinici
Lettura di diario clinico, cartella, prescrizioni, anamnesi e situazione della bocca registrate dallo studio. Scrive 1 strumento: una nota nel diario.
6
Sicurezza dei dati
Come protegge i dati dei pazienti il server MCP di MedicHub?
Il server MCP di MedicHub protegge i dati dei pazienti con sei confini che valgono prima di qualunque funzione: spegnimento predefinito, autorizzazione OAuth 2.1, permessi del gestionale, pseudonimizzazione, conferma delle scritture e limiti a ogni chiamata. I dati sanitari sono categorie particolari di dati personali (GDPR, Reg. UE 2016/679, art. 9): i confini si progettano prima del codice.
-
Spento per impostazione predefinita
Il server e ogni singolo strumento sono disattivati finché lo studio non li attiva, uno per uno, con un consenso registrato nel gestionale.
-
Accesso con OAuth 2.1 e PKCE
L'assistente riceve un accesso autorizzato dall'utente del gestionale: non conosce la sua password e la connessione si può revocare.
-
Stessi permessi del gestionale
Ogni strumento applica i permessi dell'utente collegato: l'assistente vede e fa solo ciò che quell'utente vedrebbe e farebbe nell'interfaccia.
-
Pazienti come «paziente N»
Per impostazione predefinita nomi, recapiti e testo libero non escono in chiaro. È pseudonimizzazione (GDPR, art. 4, punto 5): i dati restano personali.
-
Scritture in attesa di conferma
Per impostazione predefinita appuntamenti, note di diario, moduli e modelli restano in attesa nel gestionale; gli spostamenti sempre. I preventivi nascono in bozza.
-
Limiti a ogni chiamata
Intervalli di date fino a 31 giorni, al massimo 200 righe per chiamata, risposte oltre 256 KB troncate e dichiarate come tali.
Come si collega un assistente al server MCP di MedicHub, passo per passo?
Un assistente si collega al server MCP di MedicHub in cinque passaggi, e ognuno resta sotto il controllo dello studio: accensione del server, scelta degli strumenti, autorizzazione dell'assistente, lavoro con i pazienti pseudonimizzati e conferma delle scritture nel gestionale.
02
Sceglie gli strumenti
Uno per uno
Ogni strumento si attiva singolarmente: uno strumento spento non compare all'assistente, che non può chiamarlo.
03
Autorizza l'assistente
OAuth 2.1 con PKCE
L'utente collega l'assistente scelto dallo studio e lo autorizza; la connessione compare nella pagina Connessioni del gestionale e si può revocare.
04
L'assistente legge
Pazienti come «paziente N»
Le risposte indicano i pazienti con lo pseudonimo «paziente N» e un link alla scheda nel gestionale; ogni chiamata resta nel registro delle chiamate.
05
Un utente conferma le scritture
Nel gestionale
Per impostazione predefinita appuntamenti, note di diario, moduli e modelli dei messaggi proposti dall'assistente restano in attesa finché un utente non li conferma o li rifiuta; gli spostamenti sempre. I preventivi nascono in bozza, non finalizzati.
Cosa abbiamo imparato progettando il server MCP di MedicHub?
Progettare il server MCP di MedicHub ci ha lasciato tre regole che valgono per qualunque software gestionale su misura che apre i propri dati a un assistente esterno.
I confini vengono prima delle funzioni
In un gestionale sanitario permessi, pseudonimizzazione e conferma delle scritture si progettano prima del primo strumento: aggiungerli dopo vuol dire riscrivere gli strumenti.
Il gestionale non decide al posto del professionista
MedicHub non elabora diagnosi, terapie o immagini cliniche: restituisce i dati registrati dallo studio. Anche ciò che si scrive di un software ne definisce la destinazione d'uso (Reg. UE 2017/745, art. 2, punto 12).
Un protocollo aperto lascia la scelta allo studio
Con MCP lo studio sceglie e cambia l'assistente senza modificare il gestionale; la valutazione del fornitore dell'assistente resta allo studio, come per ogni trattamento di dati sanitari.
Domande frequenti sul server MCP di MedicHub
No. MedicHub, il gestionale per studi medici sviluppato da AraLith, non contiene né chiama modelli di intelligenza artificiale. Espone un server MCP: se lo studio vuole usare un assistente, anche basato su un modello di intelligenza artificiale, lo sceglie e lo collega lui, con i permessi e i confini decisi nel gestionale.
Al server MCP di MedicHub si collega un client compatibile con il Model Context Protocol che supporti l'autorizzazione OAuth 2.1 con PKCE. La scelta del client e del fornitore, e la valutazione di come quel fornitore tratta i dati, restano allo studio: MedicHub non fornisce un assistente proprio.
No. La pseudonimizzazione sostituisce i dati che identificano il paziente con uno pseudonimo, come «paziente N», mentre le informazioni per risalire alla persona restano nel gestionale. Per il GDPR i dati pseudonimizzati restano dati personali (Reg. UE 2016/679, art. 4, punto 5, e considerando 26); i dati anonimi no.
Un assistente collegato al server MCP di MedicHub può usare solo gli strumenti di scrittura che lo studio ha attivato, al massimo 8, con i permessi dell'utente. Per impostazione predefinita appuntamenti, note di diario, moduli e modelli dei messaggi restano in attesa finché un utente del gestionale non li conferma; gli spostamenti sempre, e i preventivi nascono in bozza.
No. Gli strumenti dei dati clinici di MedicHub restituiscono ciò che lo studio ha già registrato, cioè diario, cartella, prescrizioni, anamnesi e situazione della bocca, senza elaborazioni cliniche. MedicHub non analizza immagini né radiografie e ogni valutazione clinica resta al professionista. Il quadro normativo è riassunto nella guida all'intelligenza artificiale in odontoiatria.
Sì, l'approccio del server MCP di MedicHub si applica anche a un software su misura: strumenti spenti per impostazione predefinita, permessi del gestionale, pseudonimizzazione e conferma delle scritture. Per valutarlo serve un colloquio tecnico sul software e sui dati da esporre. Gli altri criteri per scegliere un gestionale sanitario sono nella guida al gestionale per dentisti.
Vuoi aprire il tuo gestionale a un assistente, con confini chiari?
Portiamo nello sviluppo di software su misura l'esperienza del server MCP di MedicHub: permessi, pseudonimizzazione e scritture da confermare. Il primo colloquio tecnico è gratuito.
