Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Aircall con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
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.
Prova a chiedere
Prompt di esempio per Aircall
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 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 + Meta Muse
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
- Accedi come admin all'Aircall Dashboard su
https://dashboard.aircall.io. - 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.
- Copia l'API ID in
AIRCALL_API_IDe l'API token inAIRCALL_API_TOKEN, poi installa il connettore. Aircall mostra il token una sola volta; se lo perdi, crea una nuova chiave. - Verifica la configurazione con
aircall_pinge poi conaircall_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 Muse
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 mostraYOUR_SERVER_ID.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Aircall.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
aircall_ping | Check that the Aircall API ID and token work |
aircall_get_company | Read the Aircall company this key belongs to: its name, the number of users and the number of phone numbers |
aircall_list_users | List the users (agents and admins) of the Aircall company with id, name, email, extension, time zone, language and availability (available… |
aircall_get_user | Read one Aircall user by id or by email address: name, email, extension, time zone, language, wrap-up time and availability |
aircall_list_user_numbers | List the Aircall phone numbers a user is assigned to, with id, name and digits |
aircall_get_user_availability | Read the live availability of one user: available, offline, do_not_disturb, in_call or after_call_work (wrapping up the last call) |
aircall_list_user_availabilities | List the live availability of every user at once (available, offline, do_not_disturb, in_call, after_call_work), as shown in the Activity… |
aircall_list_teams | List the teams of the Aircall company with their members (id, name, email, availability and default number) |
aircall_get_team | Read one team by id with its name, creation date and the users in it |
aircall_list_numbers | List the phone numbers (lines) of the Aircall company: id, name, digits, country, time zone, whether the line is open now, IVR and live… |
aircall_get_number | Read one Aircall phone number by id: name, digits, country, time zone, opening state, IVR and live recording settings |
aircall_list_calls | List the company's calls (oldest first unless order is desc; only the last six months, at most 10,000 per query) with direction, status… |
aircall_search_calls | Search calls by direction, user, phone number, tags and time range (last six months only) |
aircall_get_call | Read one call by id: direction, status, missed_call_reason, start, answer and end times (UNIX seconds), duration, user, line, contact… |
aircall_get_call_transcription | Read the transcript of an ended call: language and every utterance with start and end second, text, and whether an agent (internal, with… |
aircall_get_call_summary | Read the AI summary of an ended call (a short text) |
aircall_get_call_sentiments | Read the AI sentiment of each participant of an ended call (POSITIVE, NEUTRAL or NEGATIVE, by phone number and type) |
aircall_get_call_topics | Read the key topics the AI found in an ended call, as a list of short words (e.g. payment, billing) |
aircall_get_call_action_items | Read the action items of an ended call, written by the AI or by an agent (ai_generated tells which), each with its text and dates |
aircall_comment_call | Add a note (comment) to a call |
aircall_tag_call | Add one or more existing tags to a call (tag ids from aircall_list_tags) |
aircall_archive_call | Mark a call as archived (archived: true) |
aircall_list_contacts | List the company's shared Aircall contacts with names, company, notes, phone numbers and email addresses |
aircall_search_contacts | Find shared contacts by phone number or email address (exact match), e.g. to see who called |
aircall_get_contact | Read one shared contact by id with names, company, notes (information), phone numbers and email addresses |
aircall_create_contact | Create a contact shared with the whole company |
aircall_update_contact | Change the name, company or information of a shared contact; only the fields you pass change (phone numbers and emails are not changed by… |
aircall_delete_contact | Delete a shared contact for the whole company |
aircall_list_tags | List the call tags of the company with id, name, color and description |
aircall_start_outbound_call | Start a real phone call from a user's Aircall Workspace (desktop app) to a phone number, using one of the user's Aircall numbers |
aircall_dial_number | Put a phone number into a user's Aircall Workspace dialer (desktop app) without calling: the user then starts the call and picks the line |
aircall_list_webhooks | List the webhooks of the company: id, target URL, whether it is active and the events it receives |
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
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
Questa guida ti è stata utile?
