Apri Claude o ChatGPT, scrivi «chi non ha ancora pagato il corso di sabato?» — e ricevi un elenco di nomi con i numeri di telefono. Nessun accesso all'app, nessun clic tra eventi e prenotazioni. Questo è esattamente ciò che oggi permette micali.online.
Dietro c'è MCP — Model Context Protocol. È uno standard aperto che risolve una cosa precisa: come un assistente AI può accedere in sicurezza a un'applicazione esterna. Non dandogli una password, e non copiando un export da qualche parte. Ma facendo in modo che l'applicazione stessa dichiari l'elenco delle cose che si possono fare, e l'assistente sceglie da lì — con il tuo accesso e nei tuoi permessi.
micali.online ha ora un suo server MCP. Questo articolo racconta esattamente cosa sa fare, cosa di proposito non sa fare, e perché lo abbiamo progettato così.
Come ti colleghi
Sono tre passaggi e ci vuole meno di un minuto.
- Scrivi al tuo assistente che vuoi collegare un server MCP, e gli mandi l'indirizzo
https://mcp.micali.online— intero, senza nient'altro dopo. Non c'è nulla da cliccare da nessuna parte e nulla da cercare nelle impostazioni; basta scriverlo. Trovi l'indirizzo anche nell'app, in Profilo → Connessioni AI, con un pulsante per copiarlo. - Si apre la nostra pagina di accesso. Inserisci l'email, ti arriva un codice a 6 cifre, lo riscrivi. È esattamente lo stesso accesso dell'app — nessuna nuova password, nessuna chiave API da conservare da qualche parte.
- Fatto. Da quel momento l'assistente vede i tuoi account e puoi fargli domande.
In nessun punto di questo processo nasce un segreto che devi custodire. È voluto: una chiave API incollata in una chat è una chiave che resta per sempre nella cronologia della conversazione.
Cosa puoi chiedere se gestisci un account
Abbiamo dato all'assistente dodici strumenti. Non sono comandi da imparare — l'assistente sceglie da solo tra questi in base a cosa gli chiedi con una frase normale. Ma è corretto scrivere cosa c'è in quell'elenco, perché è esattamente il contorno di ciò che l'AI può scoprire sul tuo account:
- Eventi e date — l'elenco degli eventi con quanto sono piene le singole date, e l'intera configurazione di un evento: capienza, scadenze, pagamenti, conferma.
- Prenotazioni — chi è iscritto a quale data, con contatto e stato confermato / pagato / presente. Si può restringere a una singola data, oppure solo a quelle non pagate o non confermate.
- Lista di attesa — chi aspetta che si liberi un posto, dal più in attesa al più recente.
- Visitatori — una ricerca per nome, email o telefono, e poi il profilo di una persona con i suoi abbonamenti e le sue ultime prenotazioni.
- Piani prepagati — cosa vendi, a quanto, con quale limite e quante persone lo hanno attualmente.
- Servizi e ordini — quali servizi offri e chi ha un appuntamento prenotato in un dato periodo.
- Cambiare lo stato di una prenotazione — confermata, pagata, presente.
- Annullare una prenotazione per conto del cliente.
Dieci dei dodici strumenti si limitano a leggere. Solo due cose si possono modificare: lo stato di una prenotazione e la sua cancellazione. Non è un caso — tutto il capitolo successivo parla di questo.
Per essere più pratici, sono domande del tipo: «quanti posti liberi ci sono la prossima settimana?», «la signora Rossi ha ancora ingressi sull'abbonamento?», «chi del corso di venerdì l'ultima volta non si è presentato?», «segna sabato come pagato per Paolo». L'assistente trova da solo l'account, l'evento e la prenotazione; tu non devi indicarli con identificativi.
Cosa puoi chiedere se sei un cliente
Il server MCP ha anche un secondo volto. Se sei un visitatore — cioè una persona che prenota da qualcuno — ti colleghi esattamente allo stesso modo e ottieni cinque strumenti per te:
- l'elenco delle organizzazioni presso cui sei registrato,
- le tue prenotazioni — eventi e anche servizi ordinati, di default solo quelli futuri,
- i tuoi abbonamenti, con quanti ingressi hai usato e quanti te ne restano,
- la ricerca delle date che puoi prenotare, anche con il numero di posti liberi,
- l'annullamento della tua prenotazione — rispettando la scadenza impostata dall'organizzatore.
«Cosa ho la prossima settimana?» oppure «quanti ingressi mi restano?» è una domanda per cui nessuno dovrebbe dover aprire un sito web.
Cosa l'assistente di proposito non sa
Questa è la parte che consideriamo più importante dell'elenco delle funzioni. Dare a un'AI l'accesso ai dati dei clienti è una decisione che deve avere confini chiari — e che si possono spiegare.
L'assistente non vede mai più di te. Il token di accesso dice solo chi sei; non dice nulla su cosa hai il diritto di vedere. Ogni strumento verifica quindi di nuovo, a ogni chiamata, che tu gestisca davvero quell'account. Non esiste niente come un «account attualmente aperto» su cui fare affidamento — e quindi nemmeno un modo per scivolare, facendo domande, nell'account di qualcun altro.
I membri del team sono per ora disattivati. Se qualcuno nel tuo account ha un ruolo di membro del team, nell'app vede solo gli eventi e i servizi che gli hai assegnato. Questa limitazione andrebbe riprogrammata separatamente in ogni singolo strumento — e basta dimenticarla in una sola query perché gli venga mostrato l'elenco degli iscritti di qualcun altro. Finché non sarà incorporata nativamente negli strumenti, alla connessione riceverà un errore chiaro invece di un accesso a metà. Meglio disattivato che quasi corretto.
Le azioni irreversibili sono segnate come irreversibili. Il protocollo MCP permette, per ogni strumento, di dichiarare se si limita a leggere, se il suo effetto è annullabile e se è distruttivo. L'annullamento di una prenotazione è segnato come distruttivo — cancella una riga, invia un messaggio al cliente e offre subito il posto liberato al primo della lista di attesa. Grazie a questo segno, sia Claude sia ChatGPT chiedono conferma prima di eseguirlo. Nella descrizione dello strumento c'è inoltre l'istruzione di far leggere prima all'assistente il nome del cliente e la data dell'evento, e di attendere una conferma esplicita.
Le tue conversazioni non le vediamo. L'assistente gira sul tuo abbonamento Claude o ChatGPT e parla direttamente con te. Dalla nostra parte vediamo solo le singole chiamate agli strumenti che ci arrivano — cioè esattamente ciò che vedremmo se cliccassi nell'app. Il testo delle tue domande e delle sue risposte non arriva mai da noi.
Accesso e disconnessione
Un accesso che non si può annullare con un solo pulsante non è un accesso serio. Nell'app trovi, in Profilo, la sezione Connessioni AI: l'elenco di tutti gli assistenti collegati con la data di connessione e dell'ultimo utilizzo, e per ciascuno un pulsante Disconnetti.
La disconnessione è immediata e riguarda solo quel singolo connettore — il tuo accesso nel browser e le altre connessioni restano intatte. La stessa sezione esiste anche per i visitatori, nel loro profilo.
Il token di accesso è valido cinque ore e l'assistente lo rinnova automaticamente; il rinnovo ha un limite di 90 giorni. Anche se ti dimenticassi completamente della connessione, quindi, si spegnerà da sola col tempo.
Per chi è interessato al lato tecnico
Il server parla Streamable HTTP e supporta sia la versione di protocollo 2025-06-18 sia 2025-03-26. L'autorizzazione è OAuth 2.1 con PKCE (metodo S256; plain non lo accettiamo affatto) e con registrazione dinamica del client secondo la RFC 7591 — proprio per questo basta incollare l'indirizzo, senza dover creare nulla in anticipo da nessuna parte. I documenti di discovery si trovano dove i client li cercano: /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server. La revoca del token passa per revoke, secondo la RFC 7009.
Questo significa che non si collegano solo Claude e ChatGPT, ma qualsiasi cosa parli MCP — Claude Code, Codex, Cursor e altri strumenti che si aggiungeranno nel frattempo. Non dobbiamo supportare nulla di tutto ciò separatamente; è proprio questo il senso di uno standard.
Quanto costa
Niente. Il server MCP fa parte di micali.online per tutti gli account e non ha un listino proprio. L'AI gira sul tuo abbonamento presso Anthropic o OpenAI, quindi dalla nostra parte non nasce nessun costo di modello — e quindi nessun motivo per addebitartelo.
Se vuoi l'AI direttamente nell'app, c'è anche lì: Chiedi all'AI conosce l'app e il tuo account, e la generazione dei testi dei messaggi ti aiuta a scrivere un'email o un SMS. MCP è un'altra cosa — è per i momenti in cui sei già dentro un assistente e non hai voglia di cambiare finestra.
Come iniziare
Copia l'indirizzo https://mcp.micali.online da Profilo → Connessioni AI, scrivi al tuo assistente che vuoi collegare questo server MCP, e accedi con email e codice. La prima domanda che ti consigliamo di provare è noiosa e dice molto: «cosa ho questa settimana in agenda e chi non ha ancora pagato?»
Se nell'elenco degli strumenti ti manca qualcosa che ti aspetteresti dal tuo assistente, scrivicelo. Aggiungere un altro strumento per noi è facile — difficile è decidere quali di essi possano modificare qualcosa. In questa decisione la tua esperienza ci aiuta più di ogni nostra stima.
