Come collegare Cal.com a Microsoft Copilot via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Cal.com, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Cal.com + Microsoft Copilot

Leggi un account di pianificazione Cal.com da Claude, ChatGPT o Copilot: tipi di evento, prenotazioni con partecipanti, registrazioni e trascrizioni di Cal Video, slot liberi, piani di disponibilità e calendari collegati. Prenotare, spostare e annullare sono inclusi ma disattivati all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

CALCOM_API_HOST, CALCOM_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Cal.com (qualsiasi piano) per creare una chiave API personale. La chiave agisce come l'utente che l'ha creata.

1. Accedi a Cal.com e apri Settings → Developer → API Keys (su app.cal.com, oppure su app.cal.eu se il tuo account è nella regione UE di Cal.com).
2. Clicca su New, dai alla chiave un nome (per esempio AnythingMCP) e una scadenza, e copiala. Inizia con cal_live_ (o cal_test_ in modalità test) e viene mostrata una sola volta.
3. Incolla solo la chiave, senza la parola Bearer, in CALCOM_API_KEY.
4. Imposta CALCOM_API_HOST su https://api.cal.com se accedi da app.cal.com, oppure su https://api.cal.eu se accedi da app.cal.eu. Inseriscilo senza /v2, percorsi o barra finale: il connettore aggiunge /v2 da solo. Una chiave funziona solo nella sua regione.
5. Installa il connettore ed esegui calcom_get_me: mostra l'utente a cui appartiene la chiave, con fuso orario e piano predefinito, e conferma che chiave e host vanno insieme.

Di chi sono i dati: tipi di evento, prenotazioni e piani di disponibilità del proprietario della chiave, più le prenotazioni di team in cui quell'utente è host o admin. Chi usa il connettore lavora con quell'unico account, quindi usa la chiave della persona (o dell'admin del team) di cui l'AI deve vedere gli appuntamenti.

Cosa legge: i tuoi tipi di evento (i modelli di appuntamento prenotabili) con durata, luoghi, campi di prenotazione, tempi cuscinetto, preavviso minimo e link di prenotazione; le prenotazioni con stato, orari, link della riunione, host, partecipanti con email e fuso orario, ospiti e risposte alle domande di prenotazione; le registrazioni e trascrizioni Cal Video di una prenotazione; gli slot liberi di un tipo di evento; i tuoi piani di disponibilità con orari settimanali ed eccezioni per singole date; e i calendari collegati (Google, Outlook, Apple, CalDAV), compresi quelli controllati per i conflitti e quello in cui vengono scritte le nuove prenotazioni.

La uid della prenotazione, non l'id: gli strumenti sulle prenotazioni vogliono la uid, una stringa che l'AI prende da calcom_list_bookings, non l'id numerico. La uid di una prenotazione ricorrente restituisce tutte le occorrenze. Le prenotazioni si filtrano per stato (upcoming, past, cancelled, unconfirmed), partecipante, tipo di evento, team o date, e arrivano a pagine.

Fusi orari: gli slot liberi tornano nel fuso orario in cui ragioni tu, che l'AI passa a calcom_get_available_slots, mentre gli orari di inizio delle prenotazioni vanno a Cal.com in UTC. Gli slot tengono già conto di calendari, tempi cuscinetto, preavviso minimo e limiti.

Registrazioni e trascrizioni: esistono solo per le riunioni Cal Video, e solo l'organizzatore, un admin del team o un admin dell'organizzazione può leggerle. Le riunioni su Zoom, Google Meet o Teams qui non ne hanno. Una trascrizione esiste se qualcuno ha cliccato Transcribe durante la call, e il suo link di download vale un'ora: se serve, l'AI ne chiede uno nuovo.

Disattivati all'installazione: calcom_create_booking, calcom_reschedule_booking e calcom_cancel_booking. Mandano email a partecipanti reali e modificano calendari reali: una nuova prenotazione invia conferme e inviti (i tipi di evento a pagamento possono chiedere al partecipante di pagare), lo spostamento annulla la vecchia prenotazione e ne crea una nuova con una nuova uid, e un annullamento non si può revocare (su una prenotazione ricorrente annulla tutte le occorrenze). Un amministratore può attivarli uno per uno.

Chiede prima di ogni modifica: quando uno strumento di scrittura è attivo, l'AI controlla prima l'orario con calcom_get_available_slots, poi ti mostra tipo di evento, orario nel tuo fuso, partecipante e ospiti o il motivo, e aspetta il tuo sì.

Limiti: Cal.com consente circa 120 richieste al minuto per chiave API. Dopo un 429 l'AI aspetta un minuto prima di riprovare.

Errori comuni: 401 Invalid API Key significa che la chiave è sbagliata, scaduta o eliminata, oppure appartiene all'altra regione. 403 indica che la chiave funziona ma questo utente non vede quella prenotazione, quel tipo di evento o quel team: usa la chiave dell'organizzatore o di un admin del team. 404 di solito significa che è stato usato un id numerico al posto della uid della prenotazione. Con 400 Cal.com indica il campo che non ha accettato, spesso un orario di inizio che non è uno slot libero.

Il connettore non modifica tipi di evento, piani di disponibilità o calendari collegati, e non incassa né rimborsa pagamenti.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Cal.com.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Che appuntamenti ho domani, e chi partecipa a ciascuno?"
• "Trovami tre slot liberi la prossima settimana per il mio tipo di evento Call conoscitiva, in ora italiana, da proporre a un cliente."
• "Prendi la trascrizione della call di ieri con Rossi Srl ed elenca le azioni che abbiamo concordato."
• "Quali prenotazioni sono state annullate o spostate questo mese, e con quali motivazioni?"
• "Quali sono i miei orari di lavoro nel piano predefinito, e quali calendari controlla Cal.com per i conflitti?"

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse