Come collegare Dialpad a Microsoft Copilot 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 + Microsoft Copilot

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 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 Dialpad.
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

• "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

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