Come configurare la connessione MCP?

Introduzione

Per collegare il tuo account mobile-calendar a Claude o ChatGPT, ti basta copiare l’indirizzo del server dal pannello, aggiungerlo nell’applicazione AI e concedere l’accesso sulla pagina mobile-calendar. Configuri la connessione una sola volta e puoi revocare l’accesso in qualsiasi momento. L’articolo Che cos’è un server MCP? descrive questa funzionalità e cosa può fare l’applicazione.

Istruzioni

Copiare l’indirizzo del server

• Nel menu a sinistra, fai clic sulla scheda Integrazioni -> API & MCP.
• Vai alla scheda Server MCP.
• Sullo schermo apparirà la scheda «Server MCP» con l’indirizzo del server, i passaggi per la connessione e le regole di sicurezza.

• Nella sezione «Come connettersi?» fai clic sul pulsante Copia indirizzo.
• L’indirizzo nel campo Indirizzo del server MCP verrà copiato negli appunti.

Aggiungere il server nell’applicazione Claude

• Nell’applicazione Claude, apri le impostazioni e seleziona Connettori (Connectors).
• Scegli di aggiungere un connettore personalizzato (Add custom connector).
• Inserisci il nome del connettore, ad esempio mobile-calendar, e incolla l’indirizzo del server che hai copiato.
• Conferma l’aggiunta del connettore. Se accanto al connettore appare il pulsante Connect, fai clic su di esso.
• Nel browser si aprirà la schermata di consenso di mobile-calendar.

Aggiungere il server nell’applicazione ChatGPT

• In ChatGPT, nel browser, apri la pagina Plugin (Plugins).
• Fai clic sul pulsante + e seleziona Add custom MCP server.
• Inserisci un nome, ad esempio mobile-calendar, e incolla l’indirizzo del server copiato nel campo Server URL.
• Se l’applicazione ti chiede la modalità di accesso (Authentication), seleziona OAuth.
• Conferma l’avviso sui rischi (I understand and want to continue) e fai clic su Create as a plugin.
• Installa il plugin creato per usarlo nella conversazione.
• Durante la connessione, nel browser si aprirà la schermata di consenso di mobile-calendar.

Concedere l’accesso

• Accedi a mobile-calendar come fai per entrare nel pannello. Concedi l’accesso sulla pagina mobile-calendar: l’applicazione AI non viene a conoscenza della tua password.
• Nella schermata di consenso, verifica:
  • il nome e l’indirizzo dell’applicazione che richiede l’accesso all’account,
  • l’account indicato sotto la dicitura «Accesso effettuato come»,
  • l’elenco «L’applicazione potrà:», che indica l’ambito di accesso in base ai tuoi permessi.

• Fai clic sul pulsante Consenti per collegare l’applicazione. Il pulsante Rifiuta interrompe la connessione.
• L’applicazione apparirà nell’elenco «Applicazioni connesse».
• All’indirizzo e-mail del proprietario dell’account verrà inviato il messaggio «Nuova applicazione AI collegata all’account». Se l’applicazione è stata collegata da un dipendente, anche lui riceverà il messaggio.

L’etichetta gialla «Applicazione non verificata» indica che non è stato possibile confermare chi si cela dietro l’applicazione, anche se il nome o l’indirizzo ti sembrano familiari. Collega un’applicazione di questo tipo solo se sei certo della sua provenienza.

Usare un’applicazione connessa

• Nella conversazione con l’applicazione AI, scrivi ciò di cui hai bisogno, ad esempio «Quali prenotazioni arrivano domani?».
• L’applicazione leggerà i dati del tuo account mobile-calendar oppure vi registrerà la modifica richiesta.

Disconnettere un’applicazione

• Vai alla scheda Integrazioni -> API & MCP e poi alla scheda Server MCP.
• Nell’elenco «Applicazioni connesse», trova l’applicazione a cui vuoi revocare l’accesso.

• Fai clic sul pulsante Disconnetti accanto all’applicazione selezionata.
  • Al centro dello schermo apparirà la finestra «Disconnettere l’applicazione?».
  • Fai clic sul pulsante Disconnetti.

• L’applicazione perderà immediatamente l’accesso all’account. Potrai collegarla di nuovo in seguito.

Alla scadenza dell’abbonamento, le applicazioni connesse perderanno l’accesso all’account fino al rinnovo.

Applicazioni dei dipendenti

Il dipendente collega l’applicazione con le proprie credenziali, proprio come il proprietario dell’account. L’applicazione può visualizzare e modificare solo ciò che il dipendente può vedere e modificare nel pannello, in base ai suoi permessi e alle camere assegnate.

• Elenco delle connessioni: il proprietario dell’account vede nell’elenco «Applicazioni connesse» anche le applicazioni dei dipendenti e può disconnetterle. La colonna Chi ha collegato indica a chi appartiene la connessione. Il dipendente vede solo le applicazioni collegate con le proprie credenziali.
• Modifica dei permessi: ha effetto immediato, anche nell’applicazione connessa.
• Perdita dell’accesso: le applicazioni del dipendente verranno disconnesse se il proprietario cambia la sua password o il suo indirizzo e-mail, disconnette i suoi dispositivi o rimuove il dipendente.

Verificare le operazioni nei log

• Vai alla scheda Integrazioni -> API & MCP e poi alla scheda Logi.
• Nel campo Account, seleziona Server MCP dall’elenco a discesa.

• L’elenco mostrerà solo le operazioni eseguite dalle applicazioni connesse.

La voce Server MCP appare nell’elenco dopo aver collegato la prima applicazione e comprende tutte le applicazioni connesse. Nel campo Account puoi selezionare anche Mobi e i tuoi account API. Gli altri filtri e i dettagli delle voci sono descritti nell’articolo Log.

Problemi più comuni

L’applicazione AI chiede conferma prima di una modifica

Claude e ChatGPT potrebbero chiederti di confermare un’operazione prima di salvare una modifica. Si tratta di una misura di sicurezza dell’applicazione AI, non di un errore di connessione. Verifica cosa vuole modificare l’applicazione e conferma o rifiuta l’operazione.

L’applicazione ha rifiutato di eseguire un’operazione

L’applicazione AI esterna non esegue alcune operazioni: ad esempio, non ridurrà un prezzo della metà o più, non fornirà un codice della porta e non invierà un messaggio a un destinatario diverso dall’ospite della prenotazione. Esegui queste operazioni nel pannello o con Mobi.

Nell’applicazione AI non è disponibile l’opzione per aggiungere un server

La possibilità di aggiungere un server MCP personalizzato dipende dal piano Claude o ChatGPT; nei piani aziendali dipende anche dai permessi assegnati dall’amministratore. Consulta la guida dell’applicazione o chiedi all’amministratore della tua organizzazione.

La schermata di consenso è in un’altra lingua

Nell’angolo in alto a destra della schermata di consenso, fai clic sulla bandiera della lingua e seleziona la tua lingua.

L’applicazione non è nell’elenco «Applicazioni connesse»

Nell’elenco «Applicazioni connesse», fai clic su Aggiorna. Se l’applicazione non appare ancora, collegala di nuovo nell’applicazione AI.