Scopri Retell MCP Server

Retell ora supporta il Model Context Protocol, o MCP, così puoi costruire e gestire agenti vocali direttamente dagli strumenti IA che già utilizzi. Sono inclusi i client compatibili con MCP come Cursor, Claude Desktop, Claude Code, strumenti in stile Codex e altro ancora.

Con un'unica connessione MCP, il tuo assistente può lavorare direttamente con la piattaforma Retell per:

• creare e aggiornare agenti
• avviare chiamate
• gestire numeri di telefono
• collegare knowledge base
• eseguire la QA

Se usi già Retell tramite la nostra API o gli SDK, MCP è la stessa piattaforma attraverso un'interfaccia più semplice e più adatta agli agenti.

Cosa può fare Retell MCP Server

Retell MCP Server ti dà accesso diretto alla piattaforma Retell. In breve, Retell MCP Server trasforma il tuo agente IA in un'interfaccia operativa per il tuo stack vocale, così puoi davvero agire su tutto il tuo flusso di lavoro vocale, come creare agenti, avviare chiamate, aggiornare numeri di telefono, gestire knowledge base ed eseguire la QA, il tutto da un'unica connessione. E più nello specifico, ecco come può aiutarti:

Agenti

• Creare agenti
• Aggiornare agenti
• Pubblicare versioni
• Elencare agenti
• Recuperare versioni

Chiamate

• Avviare chiamate telefoniche e web
• Recuperare i dettagli delle chiamate
• Elencare chiamate
• Aggiornare i metadati delle chiamate
• Eliminare chiamate
• Eseguire QA e revisioni

Numeri di telefono

• Importare numeri
• Fornire numeri
• Elencare numeri
• Recuperare i dettagli dei numeri

Knowledge base

• Creare knowledge base
• Collegare fonti
• Rimuovere fonti
• Elencare knowledge base

Voci

• Elencare voci
• Clonare voci
• Cercare voci della community

Chat

• Creare chat
• Creare agenti chat
• Terminare chat
• Aggiornare i metadati delle chat

Test e QA

• Creare test case
• Eseguire test
• Elencare le esecuzioni di QA
• Rieseguire la QA
• Inviare punteggi

Alert e webhook

• Creare regole di alert
• Elencare regole di alert
• Elencare incidenti
• Testare i webhook

Perché è importante

Costruire IA vocale in produzione richiede ancora troppi cambi di contesto. Invece di rimbalzare tra il tuo agente, la dashboard di Retell, la documentazione, gli script e gli strumenti di QA, Retell MCP Server porta questi flussi di lavoro in un'unica interfaccia, così puoi costruire, testare e gestire gli agenti vocali in modo più rapido e semplice.

Come funziona

La configurazione è semplice. Il tuo client MCP si connette all'endpoint MCP ospitato di Retell tramite HTTP, si autentica con la tua chiave API Retell e chiama gli strumenti. Può anche scoprire automaticamente gli strumenti disponibili tramite tools/list, tra cui:

• nome dello strumento
• descrizione
• schema di input JSON

Così, invece di codificare in modo statico ogni azione, il tuo agente sa già quali strumenti Retell esistono e sa come usarli correttamente.

Cosa ti serve per iniziare

Assicurati di avere:

• una chiave API Retell
• un client compatibile con MCP come Cursor, Claude Desktop, Claude Code o Codex
• l'URL del server MCP di Retell: https://mcp.retellai.com

Formato di auth:

Authorization: Bearer <RETELL_API_KEY>

Configurazione semplice

La maggior parte dei client MCP supporta server MCP remoti tramite HTTP.

Usa:

• URL: https://mcp.retellai.com
• Header: Authorization: Bearer

Esempio di configurazione

Cursor

Apri: Command Palette → Cursor Settings → MCP → Add new global MCP server

Aggiungi:

{
  "mcpServers": {
    "retell": {
      "url": "https://mcp.retellai.com",
      "headers": {
        "Authorization": "Bearer <RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop

Apri: Settings → Developer → Edit Config

Aggiungi:

{
  "mcpServers": {
    "retell": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.retellai.com",
        "--header",
        "Authorization:Bearer <RETELL_API_KEY>"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http retell https://mcp.retellai.com --header "Authorization: Bearer <RETELL_API_KEY>"

Codex

Aggiungi questo a ~/.codex/config.toml:

[mcp_servers.retell]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"

Poi imposta:

export RETELL_API_KEY="<RETELL_API_KEY>"

Altri client MCP

Se il tuo client supporta URL e header MCP remoti, usa:

• URL: https://mcp.retellai.com
• Header: Authorization: Bearer

Esempi di prompt

Una volta connesso, il tuo assistente può iniziare subito a lavorare con Retell.

Prova prompt come:

• "Elenca i miei agenti e riassumi cosa fa ciascuno."
• "Crea un nuovo agente per la qualificazione delle vendite inbound e pubblicalo."
• "Mostrami le ultime 20 chiamate e segnala quelle con punteggi QA bassi."
• "Crea una knowledge base, collega queste fonti e aggiorna il mio agente perché la usi."
• "Importa questo numero di telefono e assegnalo al mio agente."
• "Riesegui la QA su questa chiamata e riassumi i motivi del fallimento."

Ora arriva la parte divertente, in cui MCP può davvero sfoggiare la sua potenza. Non stai più solo chattando con un assistente. Gli stai dando accesso reale alla piattaforma, così può aiutarti a costruire, testare, analizzare e migliorare gli agenti vocali direttamente sul posto.

Perché i team lo adoreranno

Retell MCP Server aiuta i team a:

• costruire più velocemente senza lasciare il proprio client IA
• ridurre il lavoro con dashboard e API
• passare dal prototipo alla produzione più velocemente
• eseguire QA e operazioni con meno lavoro manuale
• tenere l'infrastruttura vocale più vicina agli strumenti che gli sviluppatori già usano

Per gli sviluppatori, riduce il lavoro manuale di integrazione. Per i team di prodotto, accelera i test e l'iterazione. Per i team operativi, rende più facile gestire chiamate, QA e i flussi di lavoro quotidiani degli agenti.

Sicurezza e uso sicuro

Collegare gli LLM a strumenti operativi è enorme, ma comporta anche dei rischi. Il rischio maggiore è la prompt injection. Significa che contenuti non affidabili come trascrizioni, messaggi degli utenti o documenti della knowledge base possono includere istruzioni nascoste che cercano di far fare al modello qualcosa che non hai chiesto. La maggior parte dei client MCP supporta il "conferma prima di eseguire gli strumenti".

Tienilo attivo.

Best practice

Tratta MCP come se dessi al tuo assistente un accesso reale da operatore.

Ti consigliamo di:

• Usare il privilegio minimo — Crea chiavi API con solo i permessi di cui hai bisogno.
• Tenere le chiavi fuori dai prompt — Conserva le chiavi API nelle impostazioni del client o nei secret. Non incollarle mai in chat.
• Preferire flussi di lavoro read-first — Recupera lo stato corrente prima di aggiornare o eliminare qualsiasi cosa.
• Rivedere le azioni distruttive — Azioni come delete e publish dovrebbero richiedere un chiaro intento dell'utente.
• Fare attenzione ai dati sensibili — I log delle chiamate e le trascrizioni possono contenere PII. Esponi solo ciò che ti serve.
• Usare ambienti non di produzione quando possibile — Inizia in sviluppo prima di connettere i sistemi di produzione.

Risoluzione dei problemi

Se qualcosa non funziona, ecco le prime cose da controllare.

Gli strumenti non compaiono

• Assicurati che l'URL del server MCP sia corretto
• Conferma che l'header Authorization sia impostato correttamente
• Verifica che il tuo client possa raggiungere l'endpoint MCP di Retell

401 Unauthorized

• Verifica che il tuo header sia Authorization: Bearer <RETELL_API_KEY>
• Assicurati che la tua chiave API sia attiva e valida

Errori nelle chiamate agli strumenti

• Riprova con un input più piccolo o più semplice
• Controlla il messaggio di errore restituito per i dettagli
• Molti client MCP mostrano direttamente errori strutturati degli strumenti, il che può aiutare a individuare il problema

Inizia a costruire con Retell MCP

Retell MCP Server rende facile usare Retell dagli strumenti IA in cui il tuo team già lavora. Questo significa meno passaggi tra gli strumenti, iterazione più rapida e un modo più diretto per costruire e gestire agenti vocali di produzione.

Se usi già Retell, MCP ti offre un flusso di lavoro più veloce. Se sei nuovo su Retell, è uno dei modi più semplici per iniziare. Connetti il tuo client. Aggiungi la tua chiave API. Inizia a costruire. Andiamo!

Ti serve aiuto?

Se incontri problemi o vuoi richiedere altre funzionalità MCP, contatta support@retellai.com.