Blogs
/
Zo bouw je een AI-stemagent met Claude Code en Claude Fable 5.2

Zo bouw je een AI-stemagent met Claude Code en Claude Fable 5.2

Retell
AI Voice Agent Platform
Published 
November 17, 2026
9
 min read
Zo bouw je een AI-stemagent met Claude Code en Claude Fable 5.2
About this article
Koppel Claude Code met één commando aan de MCP-server van Retell AI en laat Claude Fable 5.2 vanuit je terminal een telefoonagent bouwen, testen en beoordelen.
BACK TO BLOGS
See Retell AI in action
Start free
Back to top

Claude Code kan vanuit je terminal een werkende telefoonagent bouwen. Je koppelt het met één commando aan de MCP-server van Retell AI en beschrijft de agent in gewone taal. Claude Code maakt hem vervolgens aan, schrijft er testcases voor en beoordeelt zijn gesprekken via de Retell-API. Deze gids loopt die cyclus door met Claude Fable 5.2, het model dat Anthropic op 9 november 2026 uitbracht, en laat zien wat je onderweg handmatig moet goedkeuren.

Deze gids is gepubliceerd door Retell AI, en de MCP-server die erin wordt gebruikt is van Retell zelf.

Hoe de opzet eruitziet

Er zijn drie onderdelen betrokken. Claude Code draait in je terminal en plant het werk. De MCP-server van Retell, op mcp.retellai.com, geeft het toegang tot de Retell-API. Je Retell-workspace bevat de agents, telefoonnummers, tests en gespreksgeschiedenis waarop de API werkt.

De MCP-server biedt drie tools in plaats van één tool per API-endpoint. Daardoor blijft de toollijst klein genoeg voor het contextvenster van het model. Claude Code gebruikt de tools op volgorde: het toont de beschikbare endpoints, leest het invoerschema van het endpoint dat het nodig heeft en roept dat vervolgens aan. Bevat een aanroep een argument dat niet in het schema staat, dan geeft de server een foutmelding met de naam van dat argument en wordt de API niet aangeroepen.

Diagram van hoe Claude Code een Retell-workspace bereikt. Links: Claude Code in je terminal, met het model Claude Fable 5.2, leest je verzoek in gewone taal, plant welke Retell-endpoints het nodig heeft en vraagt je elke aanroep goed te keuren. Het maakt verbinding via MCP over HTTP, met de API-sleutel in de Authorization-header, met de MCP-server van Retell op mcp.retellai.com. Die server heeft drie tools die op volgorde worden gebruikt: list_api_endpoints vindt het endpoint voor de taak, get_api_endpoint_schema leest het invoerschema van dat endpoint, en invoke_api_endpoint controleert de argumenten aan de hand van het schema en roept daarna de Retell-API aan. De Retell-API werkt op je Retell-workspace: agents, telefoonnummers, kennisbanken, stemmen, tests en gesprekken. De agent beantwoordt gesprekken met een model uit de lijst van Retell, niet met Fable 5.2.
Claude Code plant het werk en de MCP-server van Retell voert elke API-aanroep uit nadat jij die hebt goedgekeurd. Diagram door Retell AI, november 2026, op basis van de MCP-serverdocumentatie van Retell.

Eén ding om vooraf duidelijk te hebben: Claude Fable 5.2 is het model dat bouwt, niet het model aan de telefoon. De agent die je maakt, beantwoordt gesprekken met een model uit de eigen lijst van Retell, en Fable 5.2 staat per 10 november 2026 niet in die lijst. (De lijst bevat wel het eigen model van Retell, Tell-1.) Die verdeling bespreken we in Claude Fable 5.2 voor AI-stemagents: waar het past en waar niet.

Drie manieren om een Retell-agent te bouwen met Claude

Claude Code met de MCP-server is een van drie routes. Elke route past bij een ander type gebruiker.

Claude Code + MCP-server van RetellRetell AI-connector in ClaudeRetell-dashboard
Waar je werktJe terminal of IDEEen chat in Claude op het web of in Claude DesktopEen browser
InloggenEen Retell-API-sleutel in een request-headerJe Retell-login, via OAuthJe Retell-login
Wat het bereiktDe Retell-API-endpoints die je sleutel toestaat, behalve verouderde endpoints52 speciaal gebouwde tools met widgets in de chat (per oktober 2026)Elke instelling
AgenttypenAlles wat de API ondersteuntAlleen single-prompt-agentsAlle
Het meest geschikt voorDevelopers, bulkwijzigingen, alles wat je wilt scripten of herhalenEén agent bouwen en bewerken door hem te beschrijvenConversation flows, integraties, visuele controle

Bronnen: de MCP-serverdocumentatie en de documentatie van de Claude-connector van Retell, geraadpleegd op 10 november 2026.

Claude Code koppelen aan de MCP-server van Retell

Je hebt een Retell-account, een Retell-API-sleutel en een geïnstalleerde versie van Claude Code nodig. Maak de sleutel aan in het Retell-dashboard en geef hem alleen de rechten die dit werk vereist.

Voer dit uit in je terminal, met je sleutel in plaats van de placeholder:

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

Start Claude Code en voer /mcp uit om te controleren of de retell-server verbonden is. Voer daarna /model uit en kies Claude Fable 5.2 als je abonnement dat model bevat. Volgens de documentatie van Claude Code vereist Fable 5.2 Claude Code v2.1.321 of hoger, en volgens de lanceringspost van Anthropic kunnen developers het model op het Claude Platform aanroepen als claude-fable-5-2.

Houd de sleutel buiten het gesprek. Hij hoort in het commando hierboven of in de instellingen van je client, en wordt nooit in een prompt geplakt.

Beschrijf de agent en laat Claude Code hem aanmaken

Begin met een leesactie, zodat je ziet dat de verbinding werkt voordat er iets verandert:

Toon mijn Retell-agents en vat samen wat elk ervan doet.

Beschrijf daarna de agent die je wilt. Wees specifiek over de taak, de toon, wat hij nooit mag doen en wanneer hij het gesprek overdraagt aan een mens:

Maak een single-prompt-stemagent voor een tandartspraktijk genaamd
Northside Dental. Hij beantwoordt vragen over openingstijden en verzekeringen,
plant gebitsreinigingen in en verbindt factuurvragen door naar de receptie
op +14155550123. Hij moet aan het begin van elk gesprek zeggen dat hij een
AI-assistent is. Gebruik Claude 5.5 Sonnet als model van de agent. Laat me
de prompt zien voordat je iets aanmaakt.

Claude Code schrijft een concept van de prompt, zoekt het schema op van de endpoints die het nodig heeft en vraagt je elke API-aanroep goed te keuren. Lees de prompt die het heeft geschreven voordat je goedkeurt. Hier bewijst een sterker model zijn waarde: de prompt ís de agent, en een vage prompt levert een vaag gesprek op.

Schrijf de testcases voordat je een gesprek voert

Met de simulatietests van Retell voert je agent een tekstgesprek met een door AI gesimuleerde beller, en wordt elke run als geslaagd of mislukt beoordeeld op basis van succescriteria die jij instelt. Dit werkt met single-prompt-, multi-prompt- en conversation flow-agents, en er wordt geen echt gesprek gevoerd. Vraag Claude Code de suite te schrijven:

Schrijf acht simulatietestcases voor de Northside Dental-agent.
Dek een nieuwe patiënt die een reiniging boekt, een beller die onderbreekt en
twee keer van dag wisselt, een factuurvraag die moet worden doorverbonden,
een beller die vraagt of hij met een echt mens praat, en iemand die
om medisch advies vraagt dat de agent moet weigeren te geven. Geef elke
case duidelijke succescriteria. Voer ze daarna uit en toon me de mislukte cases.

De opgeslagen cases worden een regressiesuite. Voer ze bij elke wijziging van de prompt opnieuw uit voordat die wijziging een beller bereikt.

Zet de agent op een nummer en bel je eigen telefoon

Simulatie test de logica. Een echt gesprek test de stem, het tempo en de onderbrekingen. Vraag Claude Code je telefoonnummers te tonen, de agent aan een van die nummers te koppelen en jou te bellen:

Toon mijn Retell-telefoonnummers en welke agent op elk nummer staat. Zet de
Northside Dental-agent op het nummer zonder agent en laat hem
mij bellen op +14155550199.

Drie waarschuwingen. Een gesprek bereikt een echte telefoon en wordt gefactureerd zoals elk ander gesprek, dus controleer het bestemmingsnummer in de goedkeuringsprompt. Voor uitgaande gesprekken is bovendien KYC op je Retell-account vereist. En als er al een agent op een nummer staat, verandert het vervangen van die agent wie dat nummer beantwoordt. Controleer dus eerst wat er al staat.

Beoordeel de gesprekken en herzie de prompt

Laat Claude Code na een handvol gesprekken die gesprekken voor je doornemen:

Haal de laatste 20 gesprekken van de Northside Dental-agent op. Groepeer de
gesprekken die slecht eindigden op oorzaak, citeer de beurt waarop het misging
en stel promptwijzigingen voor. Verander nog niets.

Keur de promptwijzigingen goed waarmee je het eens bent, voer de simulatiesuite opnieuw uit en publiceer. Die cyclus van bouwen, testen, bellen, beoordelen en herzien is het hele werk, en het is het deel dat Claude Code het meest verkort.

Diagram van de cyclus van vier fasen die Claude Code doorloopt voor een Retell-agent, met per fase een voorbeeldverzoek, wat Claude Code doet en wat je moet controleren. Eén, de agent bouwen: Claude Code schrijft de prompt en maakt de agent aan; lees de prompt voordat je goedkeurt. Twee, testen zonder gesprek: het maakt beoordeelde simulatietestcases aan en voert ze uit als tekstgesprekken; controleer of de succescriteria overeenkomen met wat voor jou belangrijk is. Drie, je eigen telefoon bellen: het koppelt de agent aan een nummer en voert een gesprek; controleer het bestemmingsnummer en welke agent wordt vervangen. Vier, de gesprekken beoordelen: het leest gesprekken en de analyse na het gesprek en stelt wijzigingen op; keur alleen de wijzigingen goed waarmee je het eens bent. Een gestippelde pijl loopt van fase vier terug naar fase één, met het label: herzie de prompt, voer de testcases opnieuw uit, publiceer.
De cyclus van bouwen, testen, bellen en beoordelen, met de controle die je in elke fase uitvoert. Diagram door Retell AI, november 2026, op basis van de documentatie van Retell over de MCP-server en simulatietests.
Wat je vraagtWat Claude Code via de MCP-server doetVereist jouw goedkeuring
"Toon mijn agents"Leest agents en hun versiesLaag risico, alleen lezen
"Maak een agent die..."Schrijft een prompt, maakt de agent aanJa. Lees eerst de prompt
"Schrijf testcases en voer ze uit"Maakt simulatietestcases aan, voert ze uit, rapporteert mislukkingenJa
"Zet hem op mijn nummer"Toont nummers, koppelt de agentJa. Controleer welke agent hij vervangt
"Bel mijn telefoon"Maakt een telefoongesprek aanJa. Controleer het bestemmingsnummer
"Beoordeel recente gesprekken"Toont gesprekken en leest per gesprek het transcript, de latency en de analyse na het gesprekLaag risico, maar transcripten kunnen persoonsgegevens bevatten
"Verwijder de oude agent"Roept een delete-endpoint aanJa. Beschouw verwijderen als definitief

Welke goedkeuringen je aan moet laten staan

Elke API-aanroep van Claude Code loopt via één tool: invoke_api_endpoint. Als je die tool altijd toestaat, sta je elk endpoint toe dat je sleutel kan bereiken, inclusief verwijderen en publiceren. De documentatie van Retell raadt aan elke aanroep afzonderlijk goed te keuren en het endpoint en de argumenten te controleren, en wij zouden die stap niet overslaan.

  • Gebruik een sleutel met de minste rechten die nodig zijn voor de taak. Een alleen-lezen-sleutel is genoeg om gesprekken te beoordelen.
  • Lees voordat je schrijft. Laat Claude Code de huidige agent ophalen voordat het die bijwerkt of verwijdert.
  • Behandel transcripten als onbetrouwbare tekst. Een beller kan alles zeggen, ook instructies die op het model gericht zijn. Geef een sessie waarin gesprekken worden beoordeeld niet tegelijk toestemming om agents te wijzigen zonder dat jij meekijkt.
  • Houd persoonsgegevens buiten beeld waar het kan. Vraag om samenvattingen van mislukkingen in plaats van volledige transcripten, tenzij je die echt nodig hebt.

Moet het Claude Fable 5.2 zijn?

Nee. De MCP-server werkt met elk model dat Claude Code kan draaien, en het advies van Anthropic zelf in de lanceringspost is duidelijk: "Voor de meeste programmeer- en kennistaken raden we gebruikers aan te beginnen met Claude Opus 5.5, ons sterkste model voor dagelijks gebruik." Fable en Mythos worden beschreven als modellen voor het meest ambitieuze, open technische werk.

Voor één agent met een korte prompt volstaat Opus 5.5. Fable 5.2 is de moeite waard wanneer de taak groot en open is: prompts van tientallen agents herschrijven volgens een nieuwe standaard, een maand aan mislukte gesprekken omzetten in een regressiesuite, of agents tussen workspaces migreren terwijl hun gedrag gelijk blijft. Dat zijn onze eigen inschattingen, geen benchmarkresultaten. Anthropic rekent op zijn platform voor Fable 5.2 $8 per miljoen input-tokens en $40 per miljoen output-tokens.

Veelgestelde vragen

Kan Claude Code verbinding maken met Retell AI?

Ja. Retell draait een gehoste MCP-server op mcp.retellai.com, en Claude Code maakt daar verbinding mee via het commando claude mcp add en een Retell-API-sleutel in de Authorization-header. Cursor, Claude Desktop, Codex en andere MCP-clients kunnen met dezelfde server verbinden.

Heb ik Claude Fable 5.2 nodig om de MCP-server van Retell te gebruiken?

Nee. De server werkt met elk model dat je MCP-client draait. Anthropic raadt aan om voor de meeste programmeer- en kennistaken te beginnen met Claude Opus 5.5 en positioneert Fable 5.2 voor het meest ambitieuze, open technische werk.

Kan de AI-stemagent zelf op Claude Fable 5.2 draaien?

Niet via de modellenlijst van Retell, per 10 november 2026. De agent beantwoordt gesprekken met een model dat je uit die lijst kiest, waaronder Claude 5.5 Opus, Claude 5.5 Sonnet en Claude 5.5 Haiku. Fable 5.2 doet het bouwen, testen en beoordelen vanuit Claude Code.

Wat is het verschil tussen de MCP-server van Retell en de Retell AI-connector voor Claude?

De MCP-server logt in met een Retell-API-sleutel en bereikt de Retell-API vanuit clients zoals Claude Code en Cursor. De connector staat in de connectordirectory van Claude, logt in met je Retell-login via OAuth en toont de stappen voor bouwen, uitrollen en testen als widgets in de chat. De connector bouwt alleen single-prompt-agents.

Is het veilig om Claude Code mijn Retell-account te laten beheren?

Het is zo veilig als de sleutel en de goedkeuringen die je het geeft. Gebruik een sleutel met minimale rechten, laat goedkeuring per aanroep aanstaan voor invoke_api_endpoint en controleer elke aanroep naar een delete- of publish-endpoint voordat je die goedkeurt.

Kost testen via Claude Code geld?

Gebruik via de MCP-server is gebruik van de Retell-API, dus gesprekken die het voert, worden gefactureerd zoals elk ander gesprek. De pagina over testprijzen van Retell beschrijft wat tests kosten. Gebruik van Claude Code wordt door Anthropic gefactureerd, via je Claude-abonnement, gebruikstegoed of API-tarieven, afhankelijk van hoe je inlogt.

Bouw één agent en test hem op je eigen gesprekken

Volgens platformdata van Retell loopt 80% van de productieminuten via agents die klanten zelf bouwen en beheren. Claude Code maakt die cyclus korter. Volg de installatie van de MCP-server, bouw één agent in Retell en beoordeel hem op je eigen gesprekken voordat je verder iets beslist.

ROI Calculator
Estimate Your ROI from Automating Calls

See how much your business could save by switching to AI-powered voice agents.

All done! 
Your submission has been sent to your email
Oops! Something went wrong while submitting the form.
   1
   8
20
Oops! Something went wrong while submitting the form.

ROI Result

2,000

Total Human Agent Cost

$5,000
/month

AI Agent Cost

$3,000
/month

Estimated Savings

$2,000
/month

Estimate your monthly voice AI cost

$  0.11
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Estimated monthly cost
$1,408
12,800 conversation minutes

Revolutioneer je belactiviteiten met Retell