Come collegare Dialpad a Gemini via MCP

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

Dialpad + Gemini

Fai lavorare la tua AI con Dialpad: consulta utenti, sedi e call center, rivedi chiamate, registrazioni e trascrizioni di Dialpad Ai, controlla le code in tempo reale, avvia chiamate, invia SMS, gestisci i contatti ed esporta le statistiche delle chiamate.

Prerequisiti

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

DIALPAD_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a Dialpad come company admin e apri Admin Settings. Le chiavi API richiedono un piano Dialpad Pro o Enterprise.
2. In My Company apri Authentication → API Keys e fai clic su Add key. Dagli un nome, scegli la scadenza e spunta lo scope aggiuntivo calls:list, necessario per lo storico chiamate. Se più avanti i link alle registrazioni restano vuoti, aggiungi anche recordings_export.
3. Salva e copia la chiave: Dialpad la mostra una sola volta. Incollala in DIALPAD_API_KEY così com'è, senza il prefisso Bearer, e installa il connettore.
4. Verifica la configurazione con dialpad_list_offices e dialpad_get_company.

Chi vede cosa: una chiave di un company admin raggiunge tutti gli utenti, le chiamate e i contatti dell'azienda. Condividi il server MCP solo con persone autorizzate a vederli. Con chiavi di utenti non admin dialpad_get_company, dialpad_list_numbers e dialpad_list_calls rispondono 403. La sandbox di Dialpad non è supportata. Chiamate, registrazioni, messaggi vocali, trascrizioni ed esportazioni statistiche sono dati personali di chi chiama e del personale, quindi l'AI legge solo ciò che chiedi.

Raggiunge persone reali e può costare, quindi l'AI chiede prima: dialpad_initiate_call fa squillare tutti i dispositivi di un utente e compone il numero quando l'utente risponde; dialpad_send_sms invia un SMS a nome di un utente a un massimo di 10 numeri. Le destinazioni internazionali e premium si pagano in aggiunta al piano, e i destinatari negli Stati Uniti devono aver acconsentito a ricevere SMS. Prima di entrambe, l'AI ti mostra chi chiama o scrive a chi, da quale numero e con quale testo, e aspetta il tuo sì. Anche dialpad_create_contact aspetta il tuo sì, così come dialpad_create_recording_share_link: chiunque abbia un link pubblico può ascoltare la registrazione, quindi l'AI ti chiede quale visibilità vuoi (owner, company, admin o public).

Chiamate e Dialpad Ai: dialpad_list_calls elenca le chiamate concluse, dalla più recente, filtrate per orario (millisecondi Unix) e per un utente, una sede, un reparto o un call center. dialpad_get_call aggiunge i dettagli della registrazione, i link di condivisione e il testo della trascrizione, ma Dialpad lo consente solo 10 volte al minuto. dialpad_get_call_transcript legge la trascrizione di Dialpad Ai con i suoi Ai moments, come azioni da fare e domande; dialpad_get_call_transcript_url fornisce il link alla pagina di revisione della chiamata in Dialpad. Le chiamate su linee senza Dialpad Ai non hanno trascrizione (404). I recap di Dialpad Ai (riepiloghi delle chiamate) arrivano solo tramite webhook, quindi questo connettore non può leggerli.

Code e statistiche: dialpad_get_call_center_status mostra una coda in tempo reale, con operatori in servizio, chiamate in attesa e l'attesa attuale più lunga. dialpad_start_stats_export avvia un'esportazione CSV di chiamate, SMS, messaggi vocali, registrazioni, tempo in servizio, CSAT o esiti per l'azienda, una sede o un singolo target; l'AI controlla dialpad_get_stats_export finché è pronta e ti dà il link di download. Il file può contenere numeri di telefono.

Limiti di richieste per azienda e per endpoint: la maggior parte delle letture 1200 al minuto, dialpad_get_call 10 al minuto, dialpad_initiate_call 5 al minuto, dialpad_send_sms 100 al minuto (800 nei piani superiori), creazione di contatti 100 al minuto ed esportazioni statistiche 200 all'ora. Un 429 significa attendere e riprovare.

Errori comuni: 401: la chiave è errata, eliminata o è stata incollata con il prefisso Bearer. 403: la chiave non è stata creata da un company admin, non raggiunge questa sede oppure le manca lo scope calls:list per l'elenco chiamate. 404: l'id non esiste, oppure la chiamata non ha trascrizione. 400 su un SMS: un numero non è in formato E.164 (+390212345678) oppure l'utente non può inviare da quel numero.

Il connettore non copre la chiusura o il trasferimento di chiamate in corso, le modifiche a utenti, sedi, numeri o instradamento, webhook e sottoscrizioni a eventi, riunioni e fax.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Dialpad.

Tool disponibili

Esempi di prompt

• "Quante chiamate sono in attesa adesso nel call center Assistenza, quanti operatori sono in servizio e qual è l'attesa più lunga?"
• "Elenca le chiamate in entrata di ieri per il reparto Vendite con numero del chiamante, ora e durata, e segna quelle a cui nessuno ha risposto."
• "Leggi la trascrizione Dialpad Ai della mia ultima chiamata con il +390212345678 ed elenca le azioni da fare e le domande aperte."
• "Invia un SMS dal numero Dialpad di Chiara al +393471234567 per dire che il tecnico arriva domani alle 9. Mostrami prima mittente, destinatario e testo."
• "Esporta in CSV le statistiche delle chiamate della settimana scorsa per la sede di Milano e dammi il link di download."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

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