Come connettere il server MCP di OneCal Calendar a Claude

OneCal mette a disposizione un server Model Context Protocol (MCP) che consente a client AI come Claude di leggere e gestire per tuo conto i calendari che hai collegato. Una volta effettuata la connessione, puoi chiedere a Claude di elencare i tuoi calendari, verificare la tua disponibilità e creare, aggiornare o eliminare eventi del calendario.

Questa guida ti accompagnerà nella creazione di un client MCP in OneCal e nella sua connessione a Claude come connettore personalizzato.

A differenza di alcuni client, Claude utilizza un callback URL OAuth fisso, quindi puoi creare prima il client MCP in OneCal e poi aggiungere il connettore in Claude.

Prerequisiti

Prima di iniziare assicurati di avere quanto segue:

• Un account OneCal con una Free Trial attiva oppure un qualsiasi piano a pagamento.
• Almeno un calendario collegato al tuo account OneCal.
• Aver già effettuato l'accesso al tuo account OneCal.
• Un piano Claude che supporta i connettori personalizzati (Pro, Max, Team o Enterprise). Nei piani Team ed Enterprise, solo gli Owner possono aggiungere un connettore personalizzato.

Passaggio 1: crea un client MCP in OneCal

1. Vai su https://app.onecal.io/ e apri Settings > MCP Config.

2. Clicca sul pulsante New Client.

3. Assegna al client un nome riconoscibile, ad esempio: "Claude". Questo ti aiuta a identificare in seguito a quale app appartiene il client.

4. Lascia abilitato Supports client-secret OAuth authentication.

5. Scegli gli scope che vuoi concedere. Gli scope controllano cosa può fare Claude tramite il server MCP. Per l'accesso completo al calendario, abilita Read your calendar events e Create and modify calendar events. L'accesso a profilo, email e offline è obbligatorio e sempre incluso. Concedi solo gli scope di cui hai effettivamente bisogno.

6. Nel campo Default Redirect URI, inserisci il callback URL OAuth di Claude:

https://claude.ai/api/mcp/auth_callback

7. Clicca su Create Client. OneCal genererà le tue credenziali del client, inclusi l'MCP Server URL, il Client ID, il Client Secret e altri dettagli di connessione.

8. Copia e conserva questi valori in modo sicuro. Tratta il Client Secret come una password. Viene mostrato una sola volta e non dovrebbe mai essere condiviso pubblicamente.

Passaggio 2: aggiungi il connettore in Claude

Su Claude, le integrazioni MCP vengono chiamate connectors.

1. Apri Claude e vai sulla scheda Customize, quindi apri Connectors.

2. In Connectors, clicca su + e poi seleziona Add custom connector.

3. Compila i dettagli del connettore:

• Name: un nome riconoscibile, ad esempio: "OneCal MCP Server".
• MCP Server URL: l'URL del server MCP di OneCal: https://mcp-server.onecal.io/mcp

Poi espandi Advanced settings e inserisci:

• Client ID: il Client ID di OneCal.
• Client Secret: il Client Secret di OneCal.

4. Clicca su Add per salvare il connettore.

5. Trova il connettore OneCal nell'elenco e clicca su Connect per avviare il flusso di autorizzazione.

6. Verrai reindirizzato a OneCal. Accedi se richiesto, controlla l'accesso che Claude sta richiedendo e clicca su Authorize per concedere l'accesso.

7. Dopo l'autorizzazione, Claude ti reindirizza nuovamente e contrassegna il connettore come connesso.

Passaggio 3: usa OneCal in Claude

Una volta effettuata la connessione, puoi utilizzare il connettore OneCal all'interno delle tue conversazioni. Apri il menu dei connettori dal pulsante + nel campo di input della chat per abilitarlo, quindi chiedi a Claude di:

• Elencare i calendari che hai collegato.
• Verificare la tua disponibilità per un determinato giorno o intervallo di tempo.
• Creare, aggiornare o eliminare eventi del calendario.

Claude potrà eseguire solo le azioni consentite dagli scope che hai selezionato durante la creazione del client.

Risoluzione dei problemi

• L'autorizzazione fallisce o reindirizza a una pagina di errore: assicurati che il Default Redirect URI in OneCal sia esattamente https://claude.ai/api/mcp/auth_callback. Anche una differenza di una sola barra finale farà fallire il flusso.
• Il connettore può leggere ma non può creare o modificare eventi: verifica di aver concesso lo scope di scrittura del calendario durante la creazione del client. Puoi modificare gli scope del client in Settings > MCP Config.
• Errori di client non valido: ricontrolla che il Client ID e il Client Secret siano stati copiati correttamente, senza spazi aggiuntivi.