Sanovia e MCP: come ChatGPT, Claude e gli altri assistenti AI leggono il tuo studio, piattaforma per piattaforma

In breve

Sanovia è un gestionale cloud per studi medici, professionisti sanitari e poliambulatori in Italia, fornito da SanoXvia LTD. Dal 24 settembre 2026 Sanovia ha un server MCP pubblico all'indirizzo https://sanovia.app/api/v1/mcp, iscritto al registro MCP ufficiale con il nome app.sanovia/sanovia.

Con quattro strumenti in sola lettura, un assistente AI compatibile con MCP può cercare professionisti per specialità e città, leggere profilo, prestazioni, prezzi mostrati e orari liberi, e dare al paziente il link per prenotare.

La prenotazione la conferma sempre il paziente, sulla pagina Sanovia del professionista. Il connettore non restituisce dati dei pazienti. La richiesta di prenotazione inviata dall'assistente, con conferma via email, è in arrivo. Più sotto trovi l'elenco aggiornato delle integrazioni, attive e in attivazione: le schede per ChatGPT e Muse di Meta sono in revisione; Stripe Directory, Grok, Gemini, Le Chat e Perplexity sono in corso.

Cos'è MCP, in parole semplici

Il Model Context Protocol (MCP) è uno standard aperto per collegare gli assistenti AI a strumenti e dati esterni. Un server MCP pubblica un elenco di strumenti: ognuno ha un nome, una descrizione e i parametri che accetta. L'assistente sceglie quale chiamare per rispondere alla domanda dell'utente. Specifica e documentazione sono su modelcontextprotocol.io.

Per uno studio la differenza è concreta. Senza connettore, un assistente a cui chiedono «c'è un fisioterapista libero giovedì a Bologna?» può solo cercare sul web e riassumere quello che trova, a volte una pagina vecchia o un numero che non risponde. Con il connettore legge i dati della tua pagina di prenotazione nel momento in cui il paziente chiede: gli orari davvero liberi, le prestazioni di oggi, i prezzi che hai scelto di mostrare.

Cosa fa il connettore MCP di Sanovia

Una cosa sola: rende leggibile dagli assistenti AI quello che hai già reso pubblico su Sanovia, cioè la tua pagina di prenotazione online e il tuo sito.

• Chi si trova con la ricerca. Nella ricerca per specialità e città compare solo chi ha pubblicato sia il sito sia la pagina di prenotazione online. Il sito può essere il tuo o quello della struttura in cui ricevi.
• Chi si può leggere. Profilo, prestazioni e orari di un professionista con una pagina di prenotazione o un sito pubblici si leggono con il suo codice pubblico, lo stesso del link alla pagina di prenotazione.
• Cosa non fa. Non prenota, non modifica nulla, non legge dati dei pazienti. Per prenotare, l'assistente dà al paziente il link alla tua pagina Sanovia.
• Come sono ordinati i risultati. Per nome. Sanovia non vende visibilità né posizionamenti.

Quali strumenti espone il server MCP di Sanovia?

Quattro, tutti in sola lettura e attivi in produzione. Ogni descrizione, scritta in italiano e in inglese per il modello che la legge, dice anche cosa lo strumento non fa.

Cerca professionisti (search_doctors)

Cerca per specialità o professione e per città: va bene sia la disciplina («Cardiologia», «Fisioterapia») sia il professionista («cardiologo», «fisioterapista», «medico di base»). Serve almeno uno dei due filtri: non esiste una chiamata che elenca tutti. Restituisce fino a 20 risultati, ciascuno con nome, specialità, studio, città, se prenota online, il link alla pagina di prenotazione e quello al sito.

Profilo del professionista (get_doctor_profile)

Il profilo pubblico: specialità, dati di iscrizione all'albo se riportati sul sito, sedi con indirizzo e telefono della sede, orari settimanali, prestazioni con durata e prezzo, la valutazione se pubblicata, e i link al sito e alla prenotazione. Se hai un sito esterno, l'assistente riceve solo il link: Sanovia non lo legge e non lo ripubblica.

Tipi di visita e prezzi (get_visit_types)

Le visite prenotabili online in una sede, con durata, prezzo in euro e se si paga online alla prenotazione. Un prezzo vuoto significa «non indicato o non mostrato online», mai «gratis»: la descrizione dello strumento lo dice al modello in modo esplicito. Le prestazioni che non rendi visibili ai pazienti non compaiono.

Orari liberi (get_availability)

Gli orari di inizio liberi, giorno per giorno, fino a 14 giorni per chiamata. Indicando il tipo di visita, restano solo gli orari in cui quella visita, con la sua durata, ci sta davvero. Per ogni orario c'è un link alla pagina di prenotazione con sede, giorno, ora e visita già scelti: il paziente inserisce i suoi dati e conferma. Lo strumento mostra solo orari liberi, mai chi ha prenotato e mai perché un orario è occupato.

In arrivo: richiesta di prenotazione (request_booking)

Il quinto strumento permetterà all'assistente di inviare una richiesta per un orario libero, con solo nome, cognome ed email del paziente. Sanovia manderà al paziente un'email con un link valido 30 minuti e utilizzabile una volta sola; la visita esisterà solo quando il paziente la conferma dalla pagina Sanovia, accettando lui Termini e Privacy. Nessun campo per sintomi, note, telefono o codice fiscale.

Le integrazioni MCP che stiamo attivando

Ultimo aggiornamento: 2 ottobre 2026.

Il server è uno solo e lo stesso indirizzo serve tutti gli assistenti. Cambia il modo in cui ogni piattaforma lo porta all'utente: un connettore che si aggiunge con l'indirizzo, oppure una scheda in una directory da attivare con un clic. Questa pagina tiene il punto su tutte le integrazioni, quelle attive e quelle in arrivo, e la aggiorniamo a ogni cambio di stato.

Come leggere lo stato:

• Attivo: funziona oggi, in produzione.
• Inviato, in revisione: la domanda è stata presentata alla piattaforma, che decide se e quando pubblicarla. Non diamo date e non diamo per scontata l'approvazione.
• In sviluppo: lo stiamo costruendo o provando, non è ancora attivo in produzione.
• In corso: ci stiamo lavorando, ma non è ancora attivo. Non diamo date.

Piattaforme e directory

Copilot e gli altri assistenti non hanno oggi un'integrazione dedicata: possono usare il connettore se e dove permettono di aggiungere un server MCP remoto.

Funzioni del connettore

La colonna «Dal» indica da quando l'integrazione risulta avviata o nello stato attuale. Quando una piattaforma pubblica la scheda di Sanovia, la riga passa ad Attivo e la data cambia.

Per agenti e sviluppatori

Questi sono i fatti tecnici del server, così come risponde oggi in produzione.

• Endpoint: https://sanovia.app/api/v1/mcp
• Trasporto: MCP Streamable HTTP, senza stato. Un messaggio JSON-RPC per richiesta POST, risposta in JSON. Niente stream SSE e niente Mcp-Session-Id; GET e DELETE rispondono 405.
• Autenticazione: nessuna, perché gli strumenti leggono solo dati pubblici. Una richiesta da browser è accettata solo da un'origine Sanovia o locale (controllo dell'header Origin, come chiede la specifica del trasporto).
• Versioni del protocollo: 2025-11-25, 2025-06-18, 2025-03-26 e 2024-11-05.
• Capacità: solo tools, niente resources né prompts. L'elenco non cambia durante la sessione.
• Annotazioni: i quattro strumenti dichiarano readOnlyHint true, destructiveHint false, idempotentHint true, openWorldHint false. La richiesta di prenotazione, quando sarà attiva, dichiarerà readOnlyHint false, destructiveHint false, idempotentHint false, openWorldHint true, perché fa partire un'email.
• Risultati: ogni strumento ha un outputSchema; la risposta porta structuredContent e lo stesso JSON come testo. Gli errori arrivano come risultato con isError e un messaggio in italiano e inglese.
• Istruzioni del server: la risposta a initialize spiega al modello, in italiano e inglese, che i dati sono quelli pubblicati dai professionisti, che non deve mai chiedere dati sanitari e che per prenotare deve dare al paziente il link.
• Chiavi e formati: il campo code restituito dalla ricerca identifica il professionista negli altri strumenti; location_ref sceglie la sede. Date in formato AAAA-MM-GG, fuso orario Europe/Rome.
• Limiti: la ricerca vuole almeno specialità o città e restituisce al massimo 20 risultati; gli orari coprono al massimo 14 giorni per chiamata, a partire da una data entro 90 giorni. Ci sono limiti di frequenza per indirizzo e per professionista: oltre la soglia la risposta è 429 oppure un errore «Troppe richieste, riprova tra un minuto».
• Dove trovarlo: nel registro MCP ufficiale come app.sanovia/sanovia, nella riga «Connettore MCP» di llms.txt e nel profilo Stripe pubblico; robots.txt consente /api/v1/mcp.
• Account e pagamenti: nessuna API crea un account. Un agente può preparare l'iscrizione, ma la completa il professionista su sanovia.app/register (le strutture su sanovia.app/register/clinic). I pagamenti avviati da agenti non sono ancora accettati.

Perché conta per l'economia degli agenti

Quando tra il paziente e lo studio c'è un assistente AI che cerca, confronta e propone, servono due cose: dati veri e regole chiare su chi decide. Il connettore di Sanovia è costruito in quest'ordine.

Il paziente chiede, l'assistente legge dati aggiornati

L'assistente non indovina: legge orari liberi, prestazioni e prezzi dalla stessa fonte della tua pagina di prenotazione, nel momento della domanda. Se cambi un orario o un prezzo su Sanovia, la chiamata successiva dell'assistente legge già il dato nuovo.

I dati dei pazienti restano fuori

• Gli strumenti di lettura non scrivono nulla, non chiamano nessun modello di AI e non fanno chiamate verso servizi esterni: è Sanovia a essere lo strumento dell'assistente, non il contrario.
• Il connettore non registra il testo delle richieste, perché chi cerca un medico può scrivere anche dettagli di salute. Registra solo il tipo di strumento, l'esito e la durata, oltre ai dati tecnici di connessione.
• Un codice inesistente, un professionista non pubblico o sospeso ricevono la stessa risposta, «medico non trovato»: il connettore non rivela chi è iscritto e chi no.
• Il resto di Sanovia resta com'è: la cartella clinica è cifrata con una chiave dedicata a ogni medico, i server sono in Europa (Germania), titolare del trattamento sei tu e Sanovia è responsabile ai sensi dell'art. 28 del GDPR. Ne parliamo in GDPR nello studio medico: titolare, responsabile e cosa firma il tuo gestionale.

Il consenso lo dà il paziente, non l'assistente

La prenotazione passa sempre dalla pagina Sanovia, dove è il paziente ad accettare Termini e Privacy dal proprio dispositivo. Quando la richiesta di prenotazione sarà attiva, l'assistente potrà mandare solo nome, cognome ed email; quei dati restano al massimo 30 minuti in attesa della conferma, poi vengono cancellati se nessuno conferma. Lo descrive l'informativa privacy.

Tu decidi cosa è pubblico

Il connettore legge solo quello che pubblichi. Puoi nascondere i prezzi con l'opzione «Mostra i prezzi online» (restano visibili solo quelli che si pagano online alla prenotazione), tenere una prestazione non visibile ai pazienti, o spegnere la prenotazione online e il sito: Sanovia toglie subito i tuoi dati dalle pagine e dall'elenco. Gli assistenti e i motori di ricerca che hanno già letto pagine pubbliche agiscono come titolari autonomi e seguono le loro politiche di aggiornamento, come spiegano i Termini e l'informativa.

Sai da dove arriva la prenotazione

Una visita prenotata da un link dato da un assistente compare nella tua agenda come ogni prenotazione online, con l'origine «Assistente AI». Valgono le tue regole di sempre: sedi prenotabili, orari, approvazione manuale, pagamento online, termine per annullare.

Cosa il connettore MCP di Sanovia non è

• Non è SanovIA. SanovIA è l'AI clinica di Sanovia, un componente aggiuntivo in accesso anticipato: lo attivi oggi, le funzioni si accendono progressivamente, solo con il tuo consenso esplicito e revocabile. Il connettore non c'entra: non usa modelli e non tocca dati clinici.
• Non è l'assistente incluso nel piano. Quello ti aiuta a usare l'app dentro Sanovia e non riceve dati dei pazienti. Il connettore serve gli assistenti esterni scelti dai pazienti.
• Non è un marketplace. Niente pubblicità, niente posizionamenti in vendita, nessun contatto rivenduto: il paziente prenota sulla tua pagina.
• Non prenota da solo. Né oggi né con la richiesta di prenotazione: senza il clic del paziente sulla pagina Sanovia non esiste nessuna visita.

Cosa cambia per te, se usi Sanovia

Poco, ed è voluto.

• Non c'è niente da attivare. Se hai la prenotazione online, la tua pagina è già leggibile dagli assistenti. Per comparire anche nella ricerca per specialità e città, pubblica il sito.
• Non costa nulla in più. Il connettore fa parte della pagina di prenotazione inclusa nel piano.
• Le tue regole valgono anche qui. Prestazioni visibili, sedi, orari, prezzi mostrati: l'assistente vede quello che vede un paziente sulla tua pagina, niente di più.
• Per non comparire spegni la prenotazione online o la pubblicazione del sito.

Per un'agenda che si riempie anche da questo canale, conta che il paziente possa anche disdire facilmente: lo spieghiamo in Ridurre i no-show nello studio medico.

Prova Sanovia 30 giorni, senza carta

Agenda con prenotazione online, cartella cifrata, fatture con Sistema TS, promemoria WhatsApp e una pagina che anche gli assistenti AI sanno leggere: 39 € al mese, contratto mensile, disdici quando vuoi. I prezzi sono quelli della homepage.

Inizia la prova gratuita

Da leggere insieme: GDPR nello studio medico · Quanto costa un gestionale medico · Sanovia per gli assistenti AI (llms.txt)