Conheça o Servidor MCP da Retell

Conheça o Servidor MCP da Retell

A Retell agora suporta o Model Context Protocol, ou MCP, para que você possa construir e gerenciar agentes de voz diretamente das ferramentas de IA que você já usa. Isso inclui clientes compatíveis com MCP como Cursor, Claude Desktop, Claude Code, ferramentas no estilo Codex e mais.

Com uma única conexão MCP, seu assistente pode trabalhar diretamente com a plataforma Retell para:

  • criar e atualizar agentes
  • iniciar chamadas
  • gerenciar números de telefone
  • anexar bases de conhecimento
  • executar QA

Se você já usa a Retell pela nossa API ou SDKs, o MCP é a mesma plataforma por meio de uma interface mais simples e mais amigável para agentes.

O Que o Servidor MCP da Retell Pode Fazer

O Servidor MCP da Retell dá a você acesso direto à plataforma Retell. Em resumo, o Servidor MCP da Retell transforma o seu agente de IA em uma interface funcional para a sua pilha de voz, para que você possa de fato agir em todo o seu fluxo de trabalho de voz, como criar agentes, iniciar chamadas, atualizar números de telefone, gerenciar bases de conhecimento e executar QA, tudo a partir de uma conexão. E, mais especificamente, veja como ele pode ajudar:

Agentes

  • Criar agentes
  • Atualizar agentes
  • Publicar versões
  • Listar agentes
  • Buscar versões

Chamadas

  • Iniciar chamadas telefônicas e web
  • Buscar detalhes da chamada
  • Listar chamadas
  • Atualizar metadados da chamada
  • Excluir chamadas
  • Executar QA e revisões

Números de Telefone

  • Importar números
  • Provisionar números
  • Listar números
  • Buscar detalhes do número

Base de Conhecimento

  • Criar bases de conhecimento
  • Anexar fontes
  • Remover fontes
  • Listar bases de conhecimento

Vozes

  • Listar vozes
  • Clonar vozes
  • Pesquisar vozes da comunidade

Chats

  • Criar chats
  • Criar agentes de chat
  • Encerrar chats
  • Atualizar metadados do chat

Testes e QA

  • Criar casos de teste
  • Executar testes
  • Listar execuções de QA
  • Reexecutar QA
  • Enviar pontuações

Alertas e Webhooks

  • Criar regras de alerta
  • Listar regras de alerta
  • Listar incidentes
  • Testar webhooks

Por Que Isso Importa

Construir IA de voz em produção ainda exige trocas de contexto demais. Em vez de ficar pulando entre o seu agente, o painel da Retell, a sua documentação, os scripts e as ferramentas de QA, o Servidor MCP da Retell traz esses fluxos de trabalho para uma única interface, para que você construa, teste e gerencie agentes de voz de forma mais rápida e fácil.

Como Funciona

A configuração é simples. Seu cliente MCP se conecta ao endpoint MCP hospedado da Retell por HTTP, autentica com a sua chave de API da Retell e chama as ferramentas. Ele também pode descobrir as ferramentas disponíveis automaticamente por meio de tools/list, incluindo:

  • nome da ferramenta
  • descrição
  • esquema de entrada JSON

Então, em vez de programar cada ação de forma fixa, seu agente já sabe quais ferramentas da Retell existem e sabe como usá-las corretamente.

O Que Você Precisa para Começar

Certifique-se de ter:

  • uma chave de API da Retell
  • um cliente compatível com MCP como Cursor, Claude Desktop, Claude Code ou Codex
  • a URL do servidor MCP da Retell: https://retell.stlmcp.com

Formato de autenticação:

Authorization: Bearer <RETELL_API_KEY>

Configuração Simples

A maioria dos clientes MCP suporta servidores MCP remotos por HTTP.

Use:

  • URL: https://retell.stlmcp.com
  • Header: Authorization: Bearer

Exemplo de Configuração

Cursor

Abra: Command Palette → Cursor Settings → MCP → Add new global MCP server

Adicione:

{
  "mcpServers": {
    "retell": {
      "url": "https://retell.stlmcp.com",
      "headers": {
        "Authorization": "Bearer <RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop

Abra: Settings → Developer → Edit Config

Adicione:

{
  "mcpServers": {
    "retell": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://retell.stlmcp.com",
        "--header",
        "Authorization:Bearer <RETELL_API_KEY>"
      ]
    }
  }
}

Claude Code

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

Codex

Adicione isto a ~/.codex/config.toml:

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

Então defina:

export RETELL_API_KEY="<RETELL_API_KEY>"

Outros Clientes MCP

Se o seu cliente suporta URLs e headers de MCP remoto, use:

  • URL: https://retell.stlmcp.com
  • Header: Authorization: Bearer

Exemplos de Prompts

Uma vez conectado, seu assistente pode começar a trabalhar com a Retell na hora.

Experimente prompts como:

  • "Liste meus agentes e resuma o que cada um faz."
  • "Crie um novo agente para qualificação de vendas recebidas e o publique."
  • "Mostre-me as últimas 20 chamadas e sinalize as que tiverem notas baixas de QA."
  • "Crie uma base de conhecimento, anexe estas fontes e atualize meu agente para usá-la."
  • "Importe este número de telefone e atribua-o ao meu agente."
  • "Reexecute o QA nesta chamada e resuma os motivos da falha."

Agora, esta é a parte divertida em que o MCP pode realmente mostrar seu poder. Você não está mais apenas conversando com um assistente. Você está dando a ele acesso real à plataforma para que possa ajudá-lo a construir, testar, analisar e melhorar agentes de voz no próprio lugar.

Por Que as Equipes Vão Adorar

O Servidor MCP da Retell ajuda as equipes a:

  • construir mais rápido sem sair do seu cliente de IA
  • reduzir a sobrecarga de painel e API
  • ir do protótipo à produção mais rápido
  • executar QA e operações com menos trabalho manual
  • manter a infraestrutura de voz mais perto das ferramentas que os desenvolvedores já usam

Para os desenvolvedores, reduz o trabalho manual de integração. Para as equipes de produto, acelera os testes e a iteração. Para as equipes de operações, facilita o gerenciamento de chamadas, QA e os fluxos de trabalho diários dos agentes.

Segurança e Uso Seguro

Conectar LLMs a ferramentas operacionais é enorme, mas também traz riscos. O maior risco é a injeção de prompt. Isso significa que conteúdo não confiável, como transcrições, mensagens de usuários ou documentos da base de conhecimento, pode incluir instruções ocultas que tentam fazer o modelo fazer algo que você não pediu. A maioria dos clientes MCP suporta "confirmar antes de executar ferramentas".

Mantenha isso ativado.

Melhores Práticas

Trate o MCP como dar ao seu assistente acesso real de operador.

Recomendamos:

  • Use o menor privilégio — Crie chaves de API apenas com as permissões de que você precisa.
  • Mantenha as chaves fora dos prompts — Armazene as chaves de API nas configurações do cliente ou em segredos. Nunca as cole no chat.
  • Prefira fluxos de trabalho que leem primeiro — Busque o estado atual antes de atualizar ou excluir qualquer coisa.
  • Revise ações destrutivas — Ações como excluir e publicar devem exigir uma intenção clara do usuário.
  • Tenha cuidado com dados sensíveis — Registros de chamadas e transcrições podem conter PII. Exponha apenas o que você precisa.
  • Use ambientes que não sejam de produção quando possível — Comece no desenvolvimento antes de conectar sistemas de produção.

Resolução de Problemas

Se algo não estiver funcionando, aqui estão as primeiras coisas a verificar.

As ferramentas não estão aparecendo

  • Certifique-se de que a URL do servidor MCP está correta
  • Confirme que o header Authorization está definido corretamente
  • Verifique se o seu cliente consegue alcançar o endpoint MCP da Retell

401 Unauthorized

  • Verifique se o seu header é Authorization: Bearer <RETELL_API_KEY>
  • Certifique-se de que a sua chave de API está ativa e válida

Erros de chamada de ferramenta

  • Tente novamente com uma entrada menor ou mais simples
  • Verifique a mensagem de erro retornada para obter detalhes
  • Muitos clientes MCP mostram erros de ferramenta estruturados diretamente, o que pode ajudar a identificar o problema

Comece a Construir com o MCP da Retell

O Servidor MCP da Retell facilita usar a Retell a partir das ferramentas de IA em que a sua equipe já trabalha. Isso significa menos troca entre ferramentas, iteração mais rápida e uma forma mais direta de construir e gerenciar agentes de voz em produção.

Se você já usa a Retell, o MCP dá a você um fluxo de trabalho mais rápido. Se você é novo na Retell, é uma das formas mais simples de começar. Conecte seu cliente. Adicione sua chave de API. Comece a construir. Vamos lá!

Precisa de Ajuda?

Se você tiver problemas ou quiser solicitar mais capacidades de MCP, entre em contato com support@retellai.com.

Calculadora de ROI
Estime Seu ROI ao Automatizar as Chamadas

Veja quanto seu negócio poderia economizar ao migrar para agentes de voz com IA.

All done! 
Your submission has been sent to your email
Ops! Algo deu errado ao enviar o formulário.
   1
   8
20
Ops! Algo deu errado ao enviar o formulário.

Resultado do ROI

2,000

Total Human Agent Cost

$5,000
/month

AI Agent Cost

$3,000
/month

Estimated Savings

$2,000
/month
Demo ao Vivo
Experimente Nossa Demo ao Vivo

Um número de telefone de demonstração do consultório da Retell Clinic

Obrigado! Recebemos o seu envio!
Ops! Algo deu errado ao enviar o formulário.

Read Other Blogs

Revolutionize your call operation with Retell