Retell AI — MCP-сервер для Claude Code: звонки и агенты
Подключает голосовых агентов Retell AI к вашему ассистенту: позвонить, проверить историю звонков, поправить промпт агента.
claude mcp add --env RETELL_API_KEY=<RETELL_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --transport stdio retell-ai -- npx -y @mindstone/mcp-server-retell-aiЧто делает Retell AI
Retell AI — локальный MCP-сервер на stdio, который даёт ассистенту доступ к телефонным операциям через API Retell AI. Внутри 32 инструмента: звонки, агенты, LLM-промпты, голоса, базы знаний и история чатов. Ассистент сначала смотрит агента и его промпт, выбирает номер, а потом уже звонит.
Исходящий звонок — действие в реальном мире. Хост обязан показать вам from_number и to_number и дождаться подтверждения перед каждым вызовом create_phone_call. Автоподтверждение по прошлым согласиям не годится: каждый звонок подтверждается отдельно. Номера проверяются локально по E.164, кривой номер вернёт ошибку INVALID_PHONE_NUMBER и никуда не уйдёт. Тарифы Retell AI считают исходящие звонки поминутно, так что случайный вызов стоит денег.
Пакетный обход create_batch_call делает по одному платному звонку на задачу, и правила подтверждения те же — покажите весь список получателей. Перед кампанией стоит глянуть get_concurrency, иначе она съест входящую ёмкость. Загрузка файлов в базу знаний ограничена каталогом MCP_WORKSPACE_PATH, а без него — системным временным каталогом; обход через .. и симлинки наружу отклоняются до чтения с диска. Нужны Node.js 20+, npm и ключ RETELL_API_KEY.
Какие задачи решает
- позвонить клиенту голосовым агентом и получить запись разговора
- посмотреть расшифровку и статус прошлого звонка
- поправить промпт агента перед запуском кампании
- проверить свободную ёмкость перед пакетным обзвоном
- загрузить документы в базу знаний агента
Примеры запросов агенту
- Позвони Джейн через агента поддержки и подтверди завтрашнюю встречу
- Покажи статус и расшифровку последнего звонка
- Проверь промпт агента поддержки и его динамические переменные
Как установить Retell AI
Командой платформы
claude mcp add --env RETELL_API_KEY=<RETELL_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --transport stdio retell-ai -- npx -y @mindstone/mcp-server-retell-aiВместо <…> подставьте свои значения
Командой платформы
codex mcp add retell-ai --env RETELL_API_KEY=<RETELL_API_KEY> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -- npx -y @mindstone/mcp-server-retell-aiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"retell-ai": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-retell-ai"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"retell-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-retell-ai"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e RETELL_API_KEY=<RETELL_API_KEY> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> retell-ai npx -y @mindstone/mcp-server-retell-aiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Retell AI
Как установить Retell AI в Claude Code?
Выполните claude mcp add mcp-server-retell-ai -e RETELL_API_KEY=<RETELL_API_KEY> -- npx -y @mindstone/mcp-server-retell-ai. Ключ подставьте свой, из панели Retell AI.
Что делает Retell AI?
Даёт ассистенту инструменты Retell AI: звонки, пакетные кампании, настройку агентов, промпты LLM, голоса, базы знаний и историю чатов.
Что нужно для работы сервера?
Node.js 20+, npm и ключ RETELL_API_KEY. Для загрузки файлов в базу знаний задайте MCP_WORKSPACE_PATH, иначе чтение ограничено системным временным каталогом.
