Möt Retell MCP-server

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.