Retell stöder nu Model Context Protocol, eller MCP, så att du kan bygga och hantera röstagenter direkt från de AI-verktyg du redan använder. Det inkluderar MCP-kompatibla klienter som Cursor, Claude Desktop, Claude Code, Codex-liknande verktyg med mera.
Med en enda MCP-anslutning kan din assistent arbeta direkt med Retell-plattformen för att:
- skapa och uppdatera agenter
- starta samtal
- hantera telefonnummer
- bifoga kunskapsbaser
- kör QA
Om du redan använder Retell via vårt API eller SDK:er är MCP samma plattform genom ett enklare, mer agentvänligt gränssnitt.
Vad Retell MCP-servern kan göra
Retell MCP Server ger dig direktåtkomst till Retell-plattformen. Kort sagt, Retell MCP Server förvandlar din AI-agent till ett fungerande gränssnitt för din röststack så att du faktiskt kan vidta åtgärder i hela ditt röstarbetsflöde, som att skapa agenter, ringa samtal, uppdatera telefonnummer, hantera kunskapsbaser och köra QA, allt från en anslutning. Och mer specifikt, så här kan det hjälpa:
Agenter
- Skapa agenter
- Uppdateringsagenter
- Publicera versioner
- Lista agenter
- Hämta versioner
Samtal
- Starta telefon- och webbsamtal
- Hämta samtalsinformation
- Lista samtal
- Uppdatera samtalsmetadata
- Radera samtal
- Kör QA och granskningar
Telefonnummer
- Importera nummer
- Bestämmelsenummer
- Listnummer
- Hämta nummeruppgifter
Kunskapsbas
- Skapa kunskapsbaser
- Bifoga källor
- Ta bort källor
- Lista kunskapsbaser
Röster
- Lista röster
- Klonade röster
- Sök röster från samhället
Chattar
- Skapa chattar
- Skapa chattagenter
- Avsluta chattar
- Uppdatera chattmetadata
Testning och kvalitetssäkring
- Skapa testfall
- Kör tester
- Lista QA-körningar
- Kör QA igen
- Skicka in poäng
Aviseringar och Webhooks
- Skapa aviseringsregler
- Lista aviseringsregler
- Lista incidenter
- Testa webhooks
Varför detta är viktigt
Att bygga röst-AI i produktion kräver fortfarande för många kontextväxlar. Istället för att hoppa mellan din agent, Retell-instrumentpanelen, dina dokument, skript och QA-verktyg, samlar Retell MCP Server dessa arbetsflöden i ett enda gränssnitt så att du kan bygga, testa och hantera röstagenter snabbare och enklare.
Hur det fungerar
Installationen är enkel. Din MCP-klient ansluter till Retells värdbaserade MCP-slutpunkt via HTTP, autentiserar med din Retell API-nyckel och anropar verktyg. Den kan också automatiskt upptäcka tillgängliga verktyg via tools/list , inklusive:
- verktygsnamn
- beskrivning
- JSON-inmatningsschema
Så istället för att hårdkoda varje åtgärd, vet din agent redan vilka Retell-verktyg som finns och hur man använder dem korrekt.
Vad du behöver för att komma igång
Se till att du har:
- en Retell API-nyckel
- en MCP-kompatibel klient som Cursor, Claude Desktop, Claude Code eller Codex
- Retell MCP-serverns URL: https://mcp.retellai.com
Aut.format:
Auktorisering: Bärare <RETELL_API_KEY>
Enkel installation
De flesta MCP-klienter stöder fjärr-MCP-servrar över HTTP.
Använda:
- URL: https://mcp.retellai.com
- Rubrik: Auktorisering: Innehavare
Exempel på installation
Markör
Öppna: Kommandopaletten → Markörinställningar → MCP → Lägg till ny global MCP-server
Tillägga:
{
"mcp-servrar": {
"återberätta": {
"url": "https://mcp.retellai.com",
"rubriker": {
"Auktorisering": "Bärare <RETELL_API_KEY>"
}
}
}
}
Claude Desktop
Öppna: Inställningar → Utvecklare → Redigera konfiguration
Tillägga:
{
"mcp-servrar": {
"återberätta": {
"kommando": "npx",
"argument": [
"mcp-fjärrkontroll@senaste",
"https://mcp.retellai.com",
"--rubrik",
"Auktorisering: Bärare <RETELL_API_KEY>"
]
}
}
}
Claude-kod
claude mcp add --transport http retell https://mcp.retellai.com --header "Auktorisering: Bärare <RETELL_API_KEY>"
Kodex
Lägg till detta i ~/.codex/config.toml :
[mcp_servers.återberätta]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"
Ställ sedan in:
exportera RETELL_API_KEY="<RETELL_API_KEY>"
Andra MCP-klienter
Om din klient stöder fjärr-MCP-URL:er och rubriker, använd:
- URL: https://mcp.retellai.com
- Rubrik: Auktorisering: Innehavare
Exempel på uppmaningar
När den är ansluten kan din assistent börja arbeta med Retell direkt.
Prova uppmaningar som:
- "Lista mina agenter och sammanfatta vad var och en gör."
- "Skapa en ny agent för kvalificering av inkommande försäljning och publicera den."
- "Visa mig de senaste 20 samtalen och flagga alla med låga QA-poäng."
- "Skapa en kunskapsbas, bifoga dessa källor och uppdatera min agent så att den kan använda den."
- "Importera det här telefonnumret och tilldela det till min agent."
- "Kör QA igen på det här samtalet och sammanfatta orsakerna till felet."
Nu kommer den roliga delen där MCP verkligen kan visa upp sin kraft. Du chattar inte bara med en assistent längre. Du ger den verklig plattformsåtkomst så att den kan hjälpa dig att bygga, testa, analysera och förbättra röstagenter på plats.
Varför lag kommer att älska det
Retell MCP Server hjälper team:
- bygga snabbare utan att lämna sin AI-klient
- minska dashboard- och API-omkostnader
- gå snabbare från prototyp till produktion
- kör QA och drift med mindre manuellt arbete
- hålla röstinfrastrukturen närmare de verktyg som utvecklare redan använder
För utvecklare minskar det manuellt integrationsarbete. För produktteam snabbar det upp testning och iteration. För driftsteam gör det det enklare att hantera samtal, kvalitetssäkring och dagliga arbetsflöden för agenter.
Säkerhet och säker användning
Att koppla LLM:er till operativa verktyg är enormt, men det medför också risker. Den största risken är snabb injektion. Det innebär att otillförlitligt innehåll som transkript, användarmeddelanden eller kunskapsbasdokument kan innehålla dolda instruktioner som försöker få modellen att göra något du inte bett om. De flesta MCP-klienter stöder "bekräfta innan verktyg körs".
Fortsätt med det.
Bästa praxis
Behandla MCP som att ge din assistent riktig operatörsåtkomst.
Vi rekommenderar:
- Använd lägsta behörighet — Skapa API-nycklar med endast de behörigheter du behöver.
- Håll nycklar borta från prompter — Lagra API-nycklar i klientinställningar eller hemligheter. Klistra aldrig in dem i chatten.
- Föredra läs-först-arbetsflöden — Hämta aktuellt tillstånd innan du uppdaterar eller tar bort något.
- Granska destruktiva åtgärder — Åtgärder som borttagning och publicering bör kräva tydlig användaravsikt.
- Var försiktig med känsliga uppgifter – Samtalsloggar och transkriptioner kan innehålla personligt identifierbar information. Exponera bara det du behöver.
- Använd icke-produktionsmiljöer när det är möjligt — Börja i utvecklingen innan du ansluter produktionssystem.
Felsökning
Om något inte fungerar är här de första sakerna att kontrollera.
Verktygen visas inte
- Kontrollera att MCP-serverns URL är korrekt
- Bekräfta att auktoriseringsrubriken är korrekt inställd
- Kontrollera att din klient kan nå Retell MCP-slutpunkten
401 Obehörig
- Verifiera att din header är
Authorization: Bearer <RETELL_API_KEY> - Se till att din API-nyckel är aktiv och giltig
Fel på verktygsanrop
- Försök igen med en mindre eller enklare inmatning
- Kontrollera det returnerade felmeddelandet för mer information
- Många MCP-klienter visar direkt strukturerade verktygsfel, vilket kan hjälpa till att identifiera problemet
Börja bygga med Retell MCP
Retell MCP Server gör det enkelt att använda Retell från de AI-verktyg som ditt team redan arbetar i. Det innebär mindre växling mellan verktyg, snabbare iteration och ett mer direkt sätt att bygga och hantera röstagenter i produktionen.
Om du redan använder Retell ger MCP dig ett snabbare arbetsflöde. Om du är nybörjare på Retell är det ett av de enklaste sätten att komma igång. Anslut din klient. Lägg till din API-nyckel. Börja bygga. Nu kör vi!
Behöver du hjälp?
Om du stöter på problem eller vill begära fler MCP-funktioner, kontakta support@retellai.com.
