Pianifica con Claude, ChatGPT e Cursor: il server MCP di WhenToMeet

Non abbiamo spedito un assistente AI dentro WhenToMeet. Ne hai già uno.

Se usi Claude, ChatGPT o Cursor, l'assistente per cui stai già pagando è più utile di qualsiasi chatbot potessimo infilare in una barra laterale. Quello che gli manca è il permesso di toccare il tuo calendario. È ciò che il server MCP gli dà.

MCP in un paragrafo

MCP — il Model Context Protocol — è una piccola spec per esporre strumenti a un client LLM. Il client si connette a un server, legge una lista di tool con input tipizzati e li chiama quando la conversazione serve. È la presa, non la lampada. WhenToMeet fa girare il server; l'assistente che scegli è il client.

L'endpoint è POST /api/mcp. Trasporto HTTP stateless. Le stesse API key di REST v1.

Installazione

Nel tuo client MCP — Claude Desktop, ChatGPT con i connector, Cursor o altri — aggiungi una voce server che punti a https://whentomeet.com/api/mcp con la tua API key come Bearer token. La forma esatta della config varia per client; docs.whentomeet.io ha gli snippet da copia-incolla per i più comuni.

Una volta connesso, l'assistente vede sette tool:

• list_polls — i tuoi scheduling poll e direct event
• get_poll — un evento con i suoi slot e i voti dei partecipanti
• create_poll — crea un nuovo scheduling event
• list_bookings — appuntamenti prenotati tramite le booking page
• list_calendar_events — un feed unificato su tutti i calendari connessi
• check_conflicts — questo intervallo collide con qualcosa?
• get_user_profile — il tuo tier, fuso, preferenze

È tutta la superficie di oggi.

Prompt che funzionano davvero

Prompt generici producono chiamate generiche. Questi funzionano:

"Cosa c'è nel mio calendario martedì prossimo tra le 10 e le 16? Usa list_calendar_events con quell'intervallo."

"Voglio un blocco di focus di 2 ore domattina. Controlla il calendario con check_conflicts e suggerisci tre orari di inizio liberi."

"Crea uno scheduling poll chiamato 'Pianificazione Q3' con sei slot da un'ora tra il 2026-05-04 e il 2026-05-06, solo orario di lavoro."

"Riassumi i miei booking degli ultimi 30 giorni — chi ha prenotato cosa, e quanti no-show."

"Prepara un'agenda per lo standup di domani a partire da cosa c'è sul mio calendario questa settimana."

Lo schema: nomina il tool se vuoi il controllo, descrivi il risultato se no. Claude e GPT sono entrambi bravi a scegliere il tool giusto dalla descrizione.

Cosa ancora non può fare

La superficie MCP non è tutto il prodotto. Al momento della scrittura l'assistente non può:

• Votare al posto tuo nel poll di un'altra persona
• Modificare o annullare un evento esistente
• Leggere o cambiare le impostazioni delle booking page
• Fare cose che richiedono OAuth in un calendario terzo per conto tuo — succede una volta nella nostra UI, e dopo il server MCP vede i dati unificati

Sono buchi che chiuderemo in base a ciò che la gente chiede davvero. Se lo strumento che vuoi non c'è, dillo.

Rate limit e chiavi

Il server MCP usa le stesse chiavi di REST v1 e gli stessi limiti per chiave. Un uso conversazionale normale — una dozzina di tool call per sessione — è lontano dal tetto. Se lanci un batch job, usa direttamente gli endpoint REST; servono a quello.

L'accesso API è gated per Pro. Genera una chiave nelle impostazioni, incollala nella config del tuo client MCP, fatto.

Perché l'abbiamo fatto così

Avremmo potuto costruire un pannello chat nell'app. Sarebbe stato demo-friendly. Ma l'assistente che già usi è migliore, è già nel tuo workflow, e ha un contesto che noi non avremo mai. Dargli una superficie pulita sul tuo calendario vale di più che darti una versione peggiore di Claude dentro WhenToMeet.

I docs completi di setup e la reference attuale dei tool vivono su docs.whentomeet.io.