Retell AI MCP Server

重新部署AI MCP服务器

一种模型上下文协议（MCP）服务器，提供与 Retell AI API直接通过Claude或其他MCP兼容客户端构建、测试、部署和监控AI电话代理。

特性

此MCP服务器公开了45多种工具，涵盖了Retell AI API的所有主要端点：

呼叫管理

• 创建出站电话和网络通话
• 检索通话详细信息，包括记录和录音
• 使用分页功能列出和筛选调用
• 更新呼叫元数据和数据存储设置
• 删除通话和相关数据

聊天管理

• 创建聊天会话和短信对话
• 发送消息并接收回复
• 列出和管理聊天会话

电话号码管理

• 购买/注册新电话号码
• 通过SIP导入现有号码
• 按编号配置入站/出站代理
• 列出并管理电话号码

代理管理

• 创建和配置语音代理
• 创建和配置聊天代理
• 发布代理版本
• 管理代理设置（语音、语言、行为）

LLM和会话流

• 创建和管理Retell LLM配置
• 基于节点结构的设计对话流
• 配置自定义提示和函数调用

知识库

• 为代理上下文创建知识库
• 添加源（URL、文本、文档）
• 管理知识库资源

语音和批处理操作

• 列出可用声音
• 安排批量出站呼叫
• 运行自动化代理测试

账户

• 检查并发呼叫限制

安装

npm install
npm run build

配置

环境变量

将Retell AI API密钥设置为环境变量：

export RETELL_API_KEY="your-api-key-here"

从获取API密钥 Retell AI仪表板.

Claude代码配置

选项1：使用CLI（推荐）

使用添加MCP服务器 claude mcp add 命令：

claude mcp add --transport stdio retell-ai -e RETELL_API_KEY=your-api-key-here -- node /path/to/retell-ai-mcp/dist/index.js

您还可以使用环境变量扩展：

claude mcp add --transport stdio retell-ai -e RETELL_API_KEY=\${RETELL_API_KEY} -- node /path/to/retell-ai-mcp/dist/index.js

选项2：项目配置文件

创建一个 .mcp.json 项目根目录中的文件与团队共享：

{
  "mcpServers": {
    "retell-ai": {
      "command": "node",
      "args": ["/path/to/retell-ai-mcp/dist/index.js"],
      "env": {
        "RETELL_API_KEY": "${RETELL_API_KEY}"
      }
    }
  }
}

这 ${RETELL_API_KEY} 语法将在运行时扩展环境变量。

管理服务器

# List configured MCP servers
claude mcp list

# Get details about the retell-ai server
claude mcp get retell-ai

# Remove the server
claude mcp remove retell-ai

Claude桌面配置

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "retell-ai": {
      "command": "node",
      "args": ["/path/to/retell-ai-mcp/dist/index.js"],
      "env": {
        "RETELL_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

呼叫工具

聊天工具

电话号码工具

语音代理工具

聊天代理工具

LLM工具

对话流工具

知识库工具

语音工具

批处理工具

帐户工具

示例用法

配置后，您可以使用Claude与Retell AI进行交互：

列出可用声音：

“显示Retell AI的所有可用声音”

创建代理：

“使用带有友好问候的语音'11labs Adrian'创建一个名为'Support Bot'的新语音代理”

拨打电话：

“使用Support Bot代理从我的注册号码+0987654321拨打+1234567890”

查看通话记录：

“显示过去24小时的所有电话”

发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

许可证

麻省理工学院

链接

• 重新调用AI文档
• Retell AI仪表板
• 克劳德代码MCP文档
• MCP协议