Come collegare Aircall a Cursor via MCP

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

Aircall + Cursor

Fai lavorare la tua AI con Aircall: consulta chiamate, registrazioni e messaggi vocali, leggi trascrizioni, riepiloghi e sentiment generati dall'AI, vedi chi è disponibile, aggiungi note e tag alle chiamate, gestisci i contatti condivisi e avvia chiamate dall'Aircall Workspace di un operatore.

Prerequisiti

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

AIRCALL_API_ID, AIRCALL_API_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi come admin all'Aircall Dashboard su https://dashboard.aircall.io.
2. Apri Integrations & API → API Keys e fai clic su Generate an API key (nelle dashboard meno recenti: Company settings → API Keys). Dai un nome alla chiave.
3. Copia l'API ID in AIRCALL_API_ID e l'API token in AIRCALL_API_TOKEN, poi installa il connettore. Aircall mostra il token una sola volta; se lo perdi, crea una nuova chiave.
4. Verifica la configurazione con aircall_ping e poi con aircall_get_company: mostra il nome della tua azienda e quanti utenti e numeri ha.

Chi vede cosa: la chiave agisce per l'intera azienda su Aircall, con tutte le chiamate, le registrazioni e i contatti condivisi. Condividi il server MCP solo con persone autorizzate a vedere tutto questo. Chiamate, contatti, registrazioni, messaggi vocali, trascrizioni e riepiloghi AI sono dati personali di chi chiama e degli operatori, quindi l'AI legge solo ciò che chiedi. I link a registrazioni e messaggi vocali si possono ascoltare da chiunque li abbia (link diretti per 1 ora, link brevi per 3 ore).

Fa squillare un telefono vero, quindi l'AI chiede prima: aircall_start_outbound_call avvia subito una chiamata dall'Aircall Workspace (l'app desktop) di un operatore, e i minuti in uscita possono costare. L'AI ti mostra chi chiama chi e da quale linea e aspetta il tuo sì. L'operatore deve essere online, disponibile, non impegnato in un'altra chiamata e assegnato al numero. aircall_dial_number inserisce solo il numero nel tastierino dell'operatore, che poi avvia la chiamata.

Modifiche che i tuoi operatori vedono, anche queste dopo il tuo sì: aircall_comment_call aggiunge una nota a una chiamata (al massimo cinque per chiamata; le note non si possono modificare né eliminare), aircall_tag_call aggiunge tag esistenti presi da aircall_list_tags, aircall_archive_call segna una chiamata come archiviata, e aircall_create_contact e aircall_update_contact creano o modificano contatti condivisi. Prima di creare un contatto l'AI controlla con aircall_search_contacts, perché gli stessi dati inviati due volte creano un duplicato.

Disattivato all'installazione: aircall_delete_contact, che elimina un contatto condiviso per tutta l'azienda e non si può annullare. Un amministratore lo attiva consapevolmente; l'AI ti mostra poi il contatto e lo elimina solo dopo la tua conferma.

Trascrizioni e riepiloghi AI richiedono l'add-on Aircall AI (AI Assist o AI Assist Pro): aircall_get_call_transcription, aircall_get_call_summary, aircall_get_call_sentiments, aircall_get_call_topics e aircall_get_call_action_items funzionano sulle chiamate concluse. Senza l'add-on rispondono 403 o 404, e un 404 può anche voler dire che la chiamata non ha una trascrizione.

Come lavorare: aircall_list_calls elenca le chiamate di un intervallo di tempo, aircall_search_calls filtra per direzione, utente, numero di telefono o tag, e aircall_get_call legge una singola chiamata con i link a registrazione e messaggio vocale. Gli orari sono timestamp UNIX in secondi; sono disponibili solo gli ultimi sei mesi, al massimo 10.000 chiamate per richiesta, quindi l'AI restringe l'intervallo. Chi è libero adesso: aircall_list_user_availabilities. Linee e team: aircall_list_numbers e aircall_list_teams. I contatti sono solo quelli condivisi di Aircall, non quelli sincronizzati da un CRM.

Limite di richieste: Aircall consente 120 richieste al minuto per tutta l'azienda, condivise con ogni integrazione che usa le sue chiavi. Un 429 significa attendere che finisca il minuto.

Errori comuni: 403 su ogni strumento: API ID o token sono errati, scambiati, oppure la chiave è stata eliminata. 404: la chiamata non esiste o ha più di sei mesi, oppure non c'è un'analisi AI per quella chiamata. 405 quando avvii o componi una chiamata: l'operatore non è disponibile, è già al telefono o non è assegnato al numero. 400 su una nota: la chiamata ha già cinque note.

Il connettore non copre SMS e messaggi WhatsApp, il trasferimento di chiamate in corso, la pausa o l'eliminazione delle registrazioni, le campagne in uscita, né la gestione di utenti, team, numeri, tag e webhook (aircall_list_webhooks li legge soltanto).

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Aircall.

Tool disponibili

Esempi di prompt

• "Quali chiamate abbiamo perso ieri pomeriggio sulla linea di assistenza? Raggruppale per numero del chiamante e dimmi chi abbiamo già richiamato."
• "Trova la mia ultima chiamata con il +390212345678 e dammi il riepilogo AI, il sentiment del cliente e le azioni da fare."
• "Chi del team vendite è disponibile in questo momento, e chi è al telefono?"
• "Aggiungi il tag Reclamo alle chiamate di ieri dal +390212345678 e una nota che il rimborso è stato approvato. Mostrami le chiamate e la nota prima di modificare qualcosa."
• "Avvia una chiamata al +390212345678 dal Workspace di Giulia sulla nostra linea di Milano. Chiedimi conferma prima che il telefono squilli."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT