Retell unterstützt jetzt das Model Context Protocol, kurz MCP, sodass Sie Sprachagenten direkt aus den KI-Tools heraus bauen und verwalten können, die Sie bereits nutzen. Dazu zählen MCP-kompatible Clients wie Cursor, Claude Desktop, Claude Code, Codex-artige Tools und mehr.
Mit einer einzigen MCP-Verbindung kann Ihr Assistent direkt mit der Retell-Plattform arbeiten, um:
- Agenten zu erstellen und zu aktualisieren
- Anrufe zu starten
- Rufnummern zu verwalten
- Wissensdatenbanken anzubinden
- QA durchzuführen
Wenn Sie Retell bereits über unsere API oder SDKs nutzen, ist MCP dieselbe Plattform über eine einfachere, agentenfreundlichere Schnittstelle.
Was der Retell MCP Server kann
Der Retell MCP Server gibt Ihnen direkten Zugriff auf die Retell-Plattform. Kurz gesagt: Der Retell MCP Server verwandelt Ihren KI-Agenten in eine funktionierende Schnittstelle für Ihren Sprach-Stack, sodass Sie über Ihren gesamten Sprach-Workflow hinweg tatsächlich handeln können — etwa Agenten erstellen, Anrufe starten, Rufnummern aktualisieren, Wissensdatenbanken verwalten und QA durchführen, alles über eine einzige Verbindung. Und konkreter — so kann er helfen:
Agenten
- Agenten erstellen
- Agenten aktualisieren
- Versionen veröffentlichen
- Agenten auflisten
- Versionen abrufen
Anrufe
- Telefon- und Webanrufe starten
- Anrufdetails abrufen
- Anrufe auflisten
- Anruf-Metadaten aktualisieren
- Anrufe löschen
- QA und Reviews durchführen
Rufnummern
- Nummern importieren
- Nummern bereitstellen
- Nummern auflisten
- Nummerndetails abrufen
Wissensdatenbank
- Wissensdatenbanken erstellen
- Quellen anbinden
- Quellen entfernen
- Wissensdatenbanken auflisten
Stimmen
- Stimmen auflisten
- Stimmen klonen
- Community-Stimmen durchsuchen
Chats
- Chats erstellen
- Chat-Agenten erstellen
- Chats beenden
- Chat-Metadaten aktualisieren
Testing und QA
- Testfälle erstellen
- Tests durchführen
- QA-Durchläufe auflisten
- QA erneut durchführen
- Bewertungen einreichen
Alerts und Webhooks
- Alert-Regeln erstellen
- Alert-Regeln auflisten
- Incidents auflisten
- Webhooks testen
Warum das wichtig ist
Sprach-KI in Produktion zu bauen erfordert nach wie vor zu viele Kontextwechsel. Statt zwischen Ihrem Agenten, dem Retell-Dashboard, Ihren Docs, Skripten und QA-Tools hin- und herzuspringen, bringt der Retell MCP Server diese Workflows in eine einzige Schnittstelle, sodass Sie Sprachagenten schneller und einfacher bauen, testen und verwalten können.
So funktioniert es
Die Einrichtung ist einfach. Ihr MCP-Client verbindet sich über HTTP mit Retells gehostetem MCP-Endpoint, authentifiziert sich mit Ihrem Retell-API-Key und ruft Tools auf. Er kann verfügbare Tools auch automatisch über tools/list entdecken, darunter:
- Tool-Name
- Beschreibung
- JSON-Eingabeschema
Statt also jede Aktion fest zu codieren, weiß Ihr Agent bereits, welche Retell-Tools existieren, und er weiß, wie er sie korrekt verwendet.
Was Sie für den Start brauchen
Stellen Sie sicher, dass Sie Folgendes haben:
- einen Retell-API-Key
- einen MCP-kompatiblen Client wie Cursor, Claude Desktop, Claude Code oder Codex
- die URL des Retell MCP Servers: https://mcp.retellai.com
Auth-Format:
Authorization: Bearer <RETELL_API_KEY>
Einfache Einrichtung
Die meisten MCP-Clients unterstützen Remote-MCP-Server über HTTP.
Verwenden Sie:
- URL: https://mcp.retellai.com
- Header: Authorization: Bearer
Beispiel-Einrichtung
Cursor
Öffnen: Command Palette → Cursor Settings → MCP → Add new global MCP server
Hinzufügen:
{
"mcpServers": {
"retell": {
"url": "https://mcp.retellai.com",
"headers": {
"Authorization": "Bearer <RETELL_API_KEY>"
}
}
}
}
Claude Desktop
Öffnen: Settings → Developer → Edit Config
Hinzufügen:
{
"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
Fügen Sie dies zu ~/.codex/config.toml hinzu:
[mcp_servers.retell]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"
Dann setzen:
export RETELL_API_KEY="<RETELL_API_KEY>"
Andere MCP-Clients
Wenn Ihr Client Remote-MCP-URLs und Header unterstützt, verwenden Sie:
- URL: https://mcp.retellai.com
- Header: Authorization: Bearer
Beispiel-Prompts
Sobald verbunden, kann Ihr Assistent sofort mit Retell arbeiten.
Probieren Sie Prompts wie:
- „Liste meine Agenten auf und fasse zusammen, was jeder von ihnen tut.“
- „Erstelle einen neuen Agenten für die Inbound-Vertriebsqualifizierung und veröffentliche ihn.“
- „Zeige mir die letzten 20 Anrufe und markiere alle mit niedrigen QA-Scores.“
- „Erstelle eine Wissensdatenbank, binde diese Quellen an und aktualisiere meinen Agenten, damit er sie nutzt.“
- „Importiere diese Rufnummer und weise sie meinem Agenten zu.“
- „Führe die QA für diesen Anruf erneut durch und fasse die Fehlergründe zusammen.“
Jetzt kommt der spannende Teil, in dem MCP seine Stärke wirklich ausspielen kann. Sie chatten nicht mehr nur mit einem Assistenten. Sie geben ihm echten Plattformzugriff, sodass er Ihnen helfen kann, Sprachagenten direkt aufzubauen, zu testen, zu analysieren und zu verbessern.
Warum Teams es lieben werden
Der Retell MCP Server hilft Teams dabei:
- schneller zu bauen, ohne ihren KI-Client zu verlassen
- den Dashboard- und API-Aufwand zu reduzieren
- schneller vom Prototyp zur Produktion zu gelangen
- QA und Betrieb mit weniger manueller Arbeit durchzuführen
- die Sprachinfrastruktur näher an den Tools zu halten, die Entwickler bereits nutzen
Für Entwickler reduziert es manuelle Integrationsarbeit. Für Produktteams beschleunigt es Tests und Iteration. Für Ops-Teams erleichtert es die Verwaltung von Anrufen, QA und alltäglichen Agenten-Workflows.
Sicherheit und sichere Nutzung
LLMs mit operativen Tools zu verbinden ist enorm, bringt aber auch Risiken mit sich. Das größte Risiko ist Prompt Injection. Das bedeutet, dass nicht vertrauenswürdige Inhalte wie Transkripte, Nutzernachrichten oder Dokumente aus Wissensdatenbanken versteckte Anweisungen enthalten können, die versuchen, das Modell zu etwas zu bewegen, worum Sie nicht gebeten haben. Die meisten MCP-Clients unterstützen „vor dem Ausführen von Tools bestätigen“.
Lassen Sie das eingeschaltet.
Best Practices
Behandeln Sie MCP so, als würden Sie Ihrem Assistenten echten Operator-Zugriff geben.
Wir empfehlen:
- Least Privilege anwenden — Erstellen Sie API-Keys mit nur den Berechtigungen, die Sie benötigen.
- Keys aus Prompts heraushalten — Speichern Sie API-Keys in den Client-Einstellungen oder in Secrets. Fügen Sie sie niemals in den Chat ein.
- Read-First-Workflows bevorzugen — Rufen Sie den aktuellen Status ab, bevor Sie etwas aktualisieren oder löschen.
- Destruktive Aktionen prüfen — Aktionen wie delete und publish sollten eine klare Nutzerabsicht erfordern.
- Vorsicht bei sensiblen Daten — Anrufprotokolle und Transkripte können PII enthalten. Geben Sie nur das frei, was Sie benötigen.
- Wenn möglich Nicht-Produktionsumgebungen nutzen — Beginnen Sie in der Entwicklung, bevor Sie Produktionssysteme anbinden.
Fehlerbehebung
Falls etwas nicht funktioniert, hier die ersten Dinge, die Sie prüfen sollten.
Tools tauchen nicht auf
- Stellen Sie sicher, dass die URL des MCP-Servers korrekt ist
- Bestätigen Sie, dass der Authorization-Header korrekt gesetzt ist
- Prüfen Sie, ob Ihr Client den Retell-MCP-Endpoint erreichen kann
401 Unauthorized
- Überprüfen Sie, dass Ihr Header
Authorization: Bearer <RETELL_API_KEY> lautet - Stellen Sie sicher, dass Ihr API-Key aktiv und gültig ist
Fehler beim Tool-Aufruf
- Versuchen Sie es erneut mit einer kleineren oder einfacheren Eingabe
- Prüfen Sie die zurückgegebene Fehlermeldung auf Details
- Viele MCP-Clients zeigen strukturierte Tool-Fehler direkt an, was helfen kann, das Problem einzugrenzen
Mit Retell MCP loslegen
Der Retell MCP Server macht es einfach, Retell aus den KI-Tools heraus zu nutzen, in denen Ihr Team bereits arbeitet. Das bedeutet weniger Wechseln zwischen Tools, schnellere Iteration und einen direkteren Weg, um Produktions-Sprachagenten zu bauen und zu verwalten.
Wenn Sie Retell bereits nutzen, gibt Ihnen MCP einen schnelleren Workflow. Wenn Sie neu bei Retell sind, ist es eine der einfachsten Möglichkeiten, loszulegen. Verbinden Sie Ihren Client. Fügen Sie Ihren API-Key hinzu. Beginnen Sie mit dem Aufbau. Los geht's!
Brauchen Sie Hilfe?
Wenn Sie auf Probleme stoßen oder weitere MCP-Funktionen anfragen möchten, wenden Sie sich an support@retellai.com.
