Aircall MCP fornisce a un assistente AI, come Claude o ChatGPT, l'accesso in sola lettura alle chiamate e ai dati di intelligence conversazionale della tua azienda. Dopo la connessione, puoi chiedere all'assistente di cercare chiamate, recuperare trascrizioni e riepiloghi oppure controllare il Sentiment e gli elementi da eseguire, senza scrivere alcun codice di integrazione.

Questo articolo spiega cosa fa Aircall MCP, cosa non fa e come connetterlo a Claude Desktop, Claude Code o ChatGPT/Codex.

Cos'è MCP?

MCP (Model Context Protocol) è uno standard aperto per connettere gli assistenti AI a sistemi esterni. Mentre un'API è progettata per essere richiamata dagli sviluppatori, MCP è progettato per l'assistente stesso: può individuare ciò che è disponibile e utilizzarlo senza che nessuno debba scrivere codice di integrazione.

Un modo semplice per comprenderlo: è la differenza tra consegnare a qualcuno la chiave di uno schedario e affidargli una persona addetta alla ricerca che sa già dove è archiviato tutto.

Come funziona

  1. Connetti Aircall al tuo client AI una sola volta tramite OAuth, come faresti con qualsiasi altra App.
  2. Il server MCP di Aircall pubblica un catalogo di strumenti che può utilizzare, come «cerca chiamate», «recupera trascrizioni» e «recupera Sentiment», ciascuno con input e output definiti.
  3. Fai una domanda all'assistente usando un linguaggio naturale. L'assistente legge il catalogo, seleziona lo strumento corretto e lo richiama.
  4. Aircall restituisce dati strutturati. L'assistente li analizza oppure li trasmette a ciò che hai creato.

Cosa offre Aircall MCP

Aircall MCP consente al tuo assistente AI di accedere alla ricerca delle chiamate, alle trascrizioni, ai riepiloghi, al Sentiment, agli argomenti, agli elementi da eseguire, alle valutazioni e al CSAT previsto.

URL del server: 

https://mcp.aircall.io/mcp

Limitazioni attuali

  • Aircall MCP è in sola lettura. Può recuperare dati, ma non può eseguire azioni, effettuare chiamate, inviare messaggi, applicare Tag alle chiamate o modificare alcun dato nel tuo conto. Se cerchi una soluzione che attivi automaticamente un'azione, come l'invio di un messaggio dopo una chiamata persa, questa funzionalità non è supportata.

  • Inoltre, non include i dati di messaggistica: le conversazioni tramite SMS, MMS e WhatsApp non rientrano tra i dati esposti da Aircall MCP, che comprende solo le chiamate e la relativa intelligence conversazionale.

  • L'autorizzazione si applica all'intero conto: un amministratore connette Aircall MCP e la connessione si applica all'intero conto. Al momento non è possibile limitare l'accesso a utenti specifici. Se la tua organizzazione richiede controlli degli accessi per singolo utente, tienilo presente prima di effettuare la connessione.

  • Aircall MCP non sostituisce un data warehouse, ma rappresenta un modo semplice per alimentarlo.

Requisiti

  • Un utente Aircall autorizzato a creare chiavi API (Impostazioni → Integrazioni → Chiavi API). Questa è l'autorizzazione verificata al momento dell'accesso.
  • L'Add-on Aircall AI, necessario per gli strumenti di intelligence conversazionale. Senza questo Add-on, tali strumenti restituiscono un errore che indica il nome dell'Add-on.

Configurare Aircall MCP

Claude Desktop

  1. Vai a Impostazioni → Server MCP → Aggiungi → Personalizzato, Web → Aggiungi.
  2. Inserisci l'URL: https://mcp.aircall.io/mcp
  3. In Autenticazione, seleziona Usa l'identità pubblicata da Claude (scelta consigliata).

Claude Code

  1. Esegui:
   claude mcp add --transport http aircall-mcp --scope user https://mcp.aircall.io/mcp
  1. Esegui /mcp, seleziona aircall-mcp, scegli Autentica e accedi al tuo conto Aircall nel browser che si apre.
  2. Verifica che funzioni chiedendo a Claude di «cercare le mie chiamate Aircall di ieri».

ChatGPT / Codex

App Desktop

  1. Vai a Impostazioni → Server MCP → Aggiungi server.
  2. Imposta il trasporto su HTTP trasmissibile.
  3. Inserisci l'URL: https://mcp.aircall.io/mcp
  4. Fai clic su Salva, quindi su Autentica.

CLI

  1. Aggiungi quanto segue a ~/.codex/config.toml:
 
   [mcp_servers.aircall]
   url = "https://mcp.aircall.io/mcp"
  1. Esegui:
   codex mcp login aircall

Risoluzione dei problemi

Dopo l'accesso viene visualizzato un errore relativo alle autorizzazioni

Il tuo conto non dispone ancora dell'autorizzazione per creare chiavi API. Chiedi a un amministratore di concedere questa autorizzazione, quindi riconnettiti.

Viene visualizzato un errore che indica l'Add-on AI

La tua azienda non dispone dell'Add-on Aircall AI, necessario per gli strumenti di intelligence conversazionale come trascrizioni, Sentiment e riepiloghi.

Una delle mie chiamate mostra «Nessun dato di questo tipo»

È normale. Non tutte le chiamate hanno dati di intelligence conversazionale associati.