Server MCP di CloudTalk: connetti Claude, Cursor e i tuoi agenti IA

Il server MCP di CloudTalk è l'implementazione proprietaria di CloudTalk, ospitata su mcp.cloudtalk.io. Offre 49 strumenti suddivisi in sei aree: chiamate e analisi, contatti, messaggistica e chiamate, agenti vocali IA, campagne e verifiche di account e connessione. Connettilo a Claude, Cursor o a un agente creato da te per consentire all'assistente di cercare nella cronologia chiamate, leggere le trascrizioni, gestire i contatti, inviare SMS e avviare agenti vocali IA usando i dati reali del tuo account.

Nulla in più rispetto al tuo piano. L'MCP è incluso a partire dal piano Essential, che parte da €29 per utente al mese con fatturazione annuale. Due aree dipendono dalle funzioni attive sul tuo account: i suggerimenti dell'IA (riepiloghi, sentiment, argomenti e trascrizioni) richiedono Conversation Intelligence, mentre gli strumenti per le campagne richiedono l'add-on Sales Dialer. Gli strumenti degli agenti vocali utilizzano i tuoi minuti gratuiti degli agenti vocali IA, senza bisogno di add-on. Consulta il listino prezzi completo per i dettagli dei piani.

Il piano Essential o superiore. L'MCP non è disponibile sul piano Starter. Se attualmente utilizzi Starter, ti basta passare a Essential per attivarlo. Se sul tuo account non è attivo l'add-on Conversation Intelligence, le chiamate non analizzate restituiranno campi IA vuoti anziché un errore (mostrando ad esempio un riepilogo vuoto, senza interrompere la connessione).

Non c'è un interruttore da attivare nel prodotto. Puoi connettere un client al server in quattro passaggi:

1. Genera una chiave API. Nella dashboard di CloudTalk, crea un ID chiave di accesso API e la relativa Secret. Sono necessari i privilegi di amministratore.
2. Codifica le credenziali. Codifica in Base64 l'ID e la Secret e inviali come intestazione Authorization: Basic.
3. Indirizza il tuo client al server. Usa mcp.cloudtalk.io per accedere a tutto, oppure un URL specifico come mcp.cloudtalk.io/analytics per un elenco di strumenti più ridotto.
4. Verifica la connessione. Esegui cloudtalk_health_check. Se la chiave viene convalidata, la connessione è attiva.

La guida rapida per sviluppatori contiene la configurazione esatta per ogni client, oltre agli errori più comuni.

Tutto ciò che rientra nei 49 strumenti disponibili, usando lo stesso linguaggio naturale che useresti con un collega. Ecco quattro attività che gestisce in modo eccellente:

• Formazione e controllo qualità: trova le chiamate in cui una trattativa si è bloccata, leggi le trascrizioni e riassumi cosa è sfuggito all'operatore.
• Assistenza alle chiamate in tempo reale: recupera la cronologia completa di un contatto prima di comporre il numero, poi registra l'esito senza mai lasciare l'assistente.
• Gestione degli agenti vocali: crea un agente vocale IA, collega una base di conoscenza e verifica l'andamento delle sue chiamate.
• Dati dei contatti: trova record duplicati o obsoleti, aggiornali e aggiungi tag in blocco.

I client configurabili autonomamente sono già pronti all'uso: Claude Code, Cursor e qualsiasi client che supporti lo Streamable HTTP con un'intestazione personalizzata. Questi client inviano la chiave API direttamente dal tuo computer, senza bisogno di attivazioni preventive.

I connettori ospitati sul cloud funzionano diversamente. Claude.ai, Claude Desktop e l'app mobile di Claude si connettono dal cloud di Anthropic e richiedono un campo di intestazione della richiesta che Anthropic attiva a livello di organizzazione. La visibilità di questa funzione dipende quindi dalla tua organizzazione Claude e non da CloudTalk. ChatGPT richiede l'accesso tramite OAuth, che al momento non è ancora supportato da CloudTalk, quindi per ora non può connettersi. Il supporto a OAuth è pianificato.

Ci sono quattro livelli di controllo principali. Ogni strumento è limitato alla tua azienda tramite la chiave API e nessuno strumento accetta un ID account, impedendo all'assistente di accedere ai dati di altre aziende. CloudTalk vede solo i parametri degli strumenti, come l'intervallo di date o l'ID chiamata, mai la tua conversazione con l'assistente. I link delle registrazioni sono firmati, scadono entro 12 ore (spesso anche prima) e ogni accesso viene registrato nel registro di controllo di CloudTalk. Revocando la chiave API dalla tua dashboard l'accesso viene interrotto nel giro di pochi minuti.

Non può eliminare contatti, chiamate o registrazioni. Può comunque modificare i dati tramite scrittura: l'aggiornamento di un contatto o la sostituzione delle sorgenti di una campagna sostituirà i tag, i numeri o le email non inclusi, mentre la rimozione dei tag delle chiamate li scollegherà. L'unica azione definitiva è l'eliminazione di una campagna (l'archiviazione è l'alternativa reversibile). Le azioni più rilevanti mostrano un'anteprima e richiedono una conferma prima di essere eseguite.

Usa l'MCP quando una persona o un agente deve decidere l'azione successiva, e l'API quando i passaggi sono già definiti. L'MCP fornisce all'assistente un catalogo di opzioni lasciando a lui la scelta, ideale per indagini, formazione, analisi spot e attività degli agenti. Per una sincronizzazione notturna programmata nel tuo database non servono decisioni, quindi l'API è la scelta più indicata. La maggior parte dei team finisce per utilizzare entrambi.

Sì, 60 richieste al minuto per azienda. Una risposta 429 indica che occorre attendere un minuto prima di riprovare. Le letture vengono memorizzate nella cache per un breve periodo (da pochi secondi a qualche minuto) per garantire risposte rapide, mentre le statistiche delle code in tempo reale non vengono mai memorizzate nella cache. Le modifiche apportate tramite l'assistente si aggiornano immediatamente, anche se un agente vocale o una base di conoscenza appena creati potrebbero richiedere un po' di tempo prima di apparire nei risultati.

Sviluppatori, amministratori tecnici e partner che utilizzano un proprio assistente IA con i dati di CloudTalk. La configurazione richiede una chiave API, un passaggio di codifica base64 e un file di configurazione: la presenza di una figura tecnica nel tuo team può fare la differenza tra venti minuti e un intero pomeriggio di lavoro. Una volta completata la connessione, chiunque utilizzi quell'assistente ne beneficerà senza dover configurare nulla.