Maak kennis met Retell MCP Server

Retell ondersteunt nu het Model Context Protocol (MCP), waardoor u spraakagenten rechtstreeks kunt bouwen en beheren vanuit de AI-tools die u al gebruikt. Dit omvat MCP-compatibele clients zoals Cursor, Claude Desktop, Claude Code, tools in Codex-stijl en meer.

Met één enkele MCP-verbinding kan uw assistent rechtstreeks met het Retell-platform samenwerken om:

• Agenten aanmaken en bijwerken
• lanceringsoproepen
• telefoonnummers beheren
• koppel kennisbanken
• QA uitvoeren

Als u Retell al gebruikt via onze API of SDK's, is MCP hetzelfde platform, maar dan met een eenvoudigere en gebruiksvriendelijkere interface voor agents.

Wat Retell MCP Server kan doen

Met Retell MCP Server krijgt u direct toegang tot het Retell-platform. Kort gezegd transformeert Retell MCP Server uw AI-agent in een werkende interface voor uw spraakstack, zodat u acties kunt uitvoeren binnen uw spraakworkflow, zoals het aanmaken van agenten, het starten van gesprekken, het bijwerken van telefoonnummers, het beheren van kennisbanken en het uitvoeren van kwaliteitscontroles, allemaal vanuit één verbinding. En meer specifiek, dit is hoe het u kan helpen:

Agenten

• Agenten aanmaken
• Update agents
• Publiceer versies
• Makelaars aanmelden
• Versies ophalen

Oproepen

• Start telefoon- en webgesprekken
• Details van het gesprek ophalen
• Lijstoproepen
• Update de gespreksmetadata
• Oproepen verwijderen
• QA en beoordelingen uitvoeren

Telefoonnummers

• Importcijfers
• Voorzieningsnummers
• Lijstnummers
• Nummergegevens ophalen

Kennisbank

• Kennisbanken creëren
• Voeg bronnen toe
• Bronnen verwijderen
• Lijst met kennisbanken

Stemmen

• Lijst met stemmen
• Kloonstemmen
• Zoek naar stemmen uit de gemeenschap

Chats

• Chats aanmaken
• Chatagents maken
• Chats beëindigen
• Chatmetadata bijwerken

Testen en kwaliteitscontrole

• Testcases maken
• Tests uitvoeren
• Lijst met QA-runs
• QA opnieuw uitvoeren
• Dien scores in

Waarschuwingen en webhooks

• Stel waarschuwingsregels in
• Lijst met waarschuwingsregels
• Lijst met incidenten
• Test webhooks

Waarom dit belangrijk is

Het bouwen van spraakgestuurde AI in een productieomgeving vereist nog steeds te veel contextwisselingen. In plaats van te schakelen tussen je agent, het Retell-dashboard, je documentatie, scripts en QA-tools, brengt Retell MCP Server al deze workflows samen in één interface. Zo kun je spraakagents sneller en gemakkelijker bouwen, testen en beheren.

Hoe het werkt

De installatie is eenvoudig. Uw MCP-client maakt via HTTP verbinding met het door Retell gehoste MCP-eindpunt, authenticeert zich met uw Retell API-sleutel en roept tools aan. Het kan ook automatisch beschikbare tools ontdekken via tools/list , waaronder:

• gereedschapsnaam
• beschrijving
• JSON-invoerschema

In plaats van elke actie hard te coderen, weet uw agent al welke Retell-tools er zijn en hoe deze correct te gebruiken.

Wat je nodig hebt om te beginnen

Zorg ervoor dat je het volgende hebt:

• een Retell API-sleutel
• een MCP-compatibele client zoals Cursor, Claude Desktop, Claude Code of Codex
• De URL van de Retell MCP-server: https://mcp.retellai.com

Auth-formaat:

 Autorisatie: Drager <RETELL_API_KEY>

Eenvoudige installatie

De meeste MCP-clients ondersteunen externe MCP-servers via HTTP.

Gebruik:

• URL: https://mcp.retellai.com
• Koptekst: Autorisatie: Drager

Voorbeeld van een configuratie

Cursor

Openen: Opdrachtenpalet → Cursorinstellingen → MCP → Nieuwe globale MCP-server toevoegen

Toevoegen:

 {
  "mcpServers": {
    "hervertellen": {
      "url": "https://mcp.retellai.com",
      "headers": {
        "Autorisatie": "Draager <RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop

Openen: Instellingen → Ontwikkelaar → Configuratie bewerken

Toevoegen:

 {
  "mcpServers": {
    "hervertellen": {
      "commando": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.retellai.com",
        "--header",
        "Autorisatie: Drager <RETELL_API_KEY>"
      ]
    }
  }
}

Claude Code

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

Codex

Voeg dit toe aan ~/.codex/config.toml :

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

Stel vervolgens in:

 export RETELL_API_KEY="<RETELL_API_KEY>"

Andere MCP-klanten

Als uw client externe MCP-URL's en -headers ondersteunt, gebruik dan:

• URL: https://mcp.retellai.com
• Koptekst: Autorisatie: Drager

Voorbeelden van prompts

Zodra de verbinding tot stand is gebracht, kan uw assistent direct met Retell aan de slag.

Probeer prompts zoals:

• "Geef een lijst van mijn agenten en beschrijf kort wat elk van hen doet."
• "Maak een nieuwe agent aan voor de kwalificatie van inkomende verkoopgesprekken en publiceer deze."
• "Laat me de laatste 20 gesprekken zien en markeer alle gesprekken met een lage QA-score."
• "Maak een kennisbank aan, voeg deze bronnen toe en werk mijn agent bij om deze te gebruiken."
• "Importeer dit telefoonnummer en wijs het toe aan mijn agent."
• "Voer de kwaliteitscontrole voor dit gesprek opnieuw uit en vat de oorzaken van de fout samen."

Nu komt het leuke gedeelte, waar MCP echt zijn kracht kan laten zien. Je chat niet langer alleen met een assistent. Je geeft het apparaat daadwerkelijke toegang tot het platform, zodat het je kan helpen bij het bouwen, testen, analyseren en verbeteren van spraakgestuurde systemen.

Waarom teams er dol op zullen zijn

Retell MCP Server helpt teams:

• Sneller bouwen zonder hun AI-client te verlaten
• Verminder de overhead van dashboards en API's
• Van prototype naar productie sneller
• Voer kwaliteitscontroles en operationele processen uit met minder handmatig werk.
• Zorg ervoor dat de spraakinfrastructuur dichter bij de tools blijft die ontwikkelaars al gebruiken.

Voor ontwikkelaars vermindert het de handmatige integratiewerkzaamheden. Voor productteams versnelt het het testen en de iteratie. Voor operationele teams maakt het het eenvoudiger om gesprekken, kwaliteitscontroles en de dagelijkse workflows van agenten te beheren.

Beveiliging en veilig gebruik

Het koppelen van LLM's aan operationele tools is een enorme stap, maar brengt ook risico's met zich mee. Het grootste risico is ongewenste injectie. Dat betekent dat onbetrouwbare content, zoals transcripten, gebruikersberichten of documenten uit de kennisbank, verborgen instructies kan bevatten die het model iets laten doen waar je niet om hebt gevraagd. De meeste MCP-clients ondersteunen "bevestigen voordat tools worden uitgevoerd".

Laat dat aan staan.

Beste praktijken

Beschouw MCP alsof je je assistent daadwerkelijke toegang tot de operator geeft.

Wij raden aan:

• Gebruik het principe van minimale bevoegdheden : maak API-sleutels aan met alleen de machtigingen die u nodig hebt.
• Gebruik geen API-sleutels in prompts — Bewaar API-sleutels in clientinstellingen of geheimen. Plak ze nooit in de chat.
• Geef de voorkeur aan workflows waarbij eerst gelezen wordt — Haal de huidige status op voordat er iets wordt bijgewerkt of verwijderd.
• Beoordeel destructieve acties — Acties zoals verwijderen en publiceren moeten een duidelijke intentie van de gebruiker vereisen.
• Wees voorzichtig met gevoelige gegevens — gesprekslogboeken en transcripten kunnen persoonsgegevens bevatten. Deel alleen de gegevens die nodig zijn.
• Gebruik waar mogelijk niet-productieomgevingen — begin in de ontwikkelomgeving voordat u de productiesystemen koppelt.

Probleemoplossing

Als iets niet werkt, zijn dit de eerste dingen die je moet controleren.

De tools worden niet weergegeven.

• Zorg ervoor dat de MCP-server-URL correct is.
• Controleer of de autorisatieheader correct is ingesteld.
• Controleer of uw klant het Retell MCP-eindpunt kan bereiken.

401 Ongeautoriseerd

• Controleer of uw header de volgende status heeft Authorization: Bearer <RETELL_API_KEY>
• Zorg ervoor dat uw API-sleutel actief en geldig is.

Fouten bij het aanroepen van de tool

• Probeer het opnieuw met een kleinere of eenvoudigere invoer.
• Raadpleeg het geretourneerde foutbericht voor meer informatie.
• Veel MCP-klanten tonen direct gestructureerde toolfouten, wat kan helpen om het probleem te lokaliseren.

Begin met bouwen met Retell MCP

Met Retell MCP Server kunt u Retell eenvoudig gebruiken vanuit de AI-tools waarmee uw team al werkt. Dit betekent minder schakelen tussen tools, snellere iteraties en een directere manier om spraakgestuurde agenten voor productieomgevingen te bouwen en te beheren.

Als je Retell al gebruikt, biedt MCP je een snellere workflow. Ben je nieuw bij Retell? Dan is dit een van de eenvoudigste manieren om aan de slag te gaan. Verbind je client. Voeg je API-sleutel toe. Begin met bouwen. Aan de slag!

Hulp nodig?

Mocht u problemen ondervinden of meer MCP-functionaliteiten willen aanvragen, neem dan contact op met support@retellai.com.