MCP服务
通过模型上下文协议的功能调用启用与Vapi API的集成,使AI模型能够访问Vapi的功能。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"vapi-mcp-server": {
"args": [
"-y",
"@vapi-ai/mcp-server"
],
"command": "npx",
"env": {
"VAPI_TOKEN": "\u003cyour_vapi_token\u003e"
}
}
}
}
该服务需要配置环境变量:VAPI_TOKEN
服务介绍
Vapi MCP 服务器
Vapi 模型上下文协议 服务器允许您通过函数调用来集成 Vapi API。
Claude 桌面设置
- 打开
Claude Desktop并按CMD + ,进入设置。 - 点击
开发者标签。 - 点击
编辑配置按钮。 - 这将打开文件浏览器中的
claude_desktop_config.json文件。 - 从 Vapi 仪表板获取您的 Vapi API 密钥 (https://dashboard.vapi.ai/org/api-keys)。
- 将以下内容添加到您的
claude_desktop_config.json文件中。更多详情请参阅 这里。 - 编辑配置文件后重启 Claude Desktop。
{
"mcpServers": {
"vapi-mcp-server": {
"command": "npx",
"args": [
"-y",
"@vapi-ai/mcp-server"
],
"env": {
"VAPI_TOKEN": "<your_vapi_token>"
}
}
}
}
使用 Claude 桌面的示例
- 使用 Vapi 仪表板创建或导入电话号码 (https://dashboard.vapi.ai/phone-numbers)。
- 在 Vapi 仪表板中使用现有的“预约调度器”模板创建一个新的助手 (https://dashboard.vapi.ai/assistants)。
- 确保配置 Claude Desktop 以使用 Vapi MCP 服务器,并重启 Claude Desktop 应用程序。
- 让 Claude 发起或安排一个呼叫。请参见以下示例:
示例 1: 请求立即呼叫
I'd like to speak with my ShopHelper assistant to talk about my recent order. Can you have it call me at +1234567890?
示例 2: 安排未来的呼叫
I need to schedule a call with Mary assistant for next Tuesday at 3:00 PM. My phone number is +1555123456.
远程 SSE 连接
要通过 Server-Sent Events (SSE) 传输连接到 Vapi 的 MCP 服务器:
- 从任何支持 SSE 传输的 MCP 客户端连接到
https://mcp.vapi.ai/sse - 在请求头中包含您的 Vapi API 密钥作为承载令牌
- 示例头部:
Authorization: Bearer your_vapi_api_key_here
此连接允许您远程访问 Vapi 的功能,而无需运行本地服务器。
开发
# Install dependencies
npm install
# Build the server
npm run build
更新您的 claude_desktop_config.json 以使用本地服务器。
{
"mcpServers": {
"vapi-local": {
"command": "node",
"args": [
"<path_to_vapi_mcp_server>/dist/index.js"
],
"env": {
"VAPI_TOKEN": "<your_vapi_token>"
}
},
}
}
测试
项目有两种类型的测试:
单元测试
单元测试使用模拟来测试 MCP 服务器,而不实际调用 Vapi API。
# Run unit tests
npm run test:unit
端到端测试
E2E 测试运行完整的 MCP 服务器,并实际调用 Vapi API。
# Set your Vapi API token
export VAPI_TOKEN=your_token_here
# Run E2E tests
npm run test:e2e
注意:E2E 测试需要在环境中设置有效的 Vapi API 令牌。
运行所有测试
要一次运行所有测试:
npm test
参考资料
支持的操作
Vapi MCP 服务器提供了以下工具用于集成:
助手工具
list_assistants: 列出所有 Vapi 助手create_assistant: 创建新的 Vapi 助手get_assistant: 通过 ID 获取 Vapi 助手
呼叫工具
list_calls: 列出所有 Vapi 呼叫create_call: 创建一个外呼呼叫get_call: 获取特定呼叫的详细信息
注意:
create_call操作支持立即执行或安排在未来某个时间执行呼叫。
电话号码工具
list_phone_numbers: 列出所有 Vapi 电话号码get_phone_number: 获取特定电话号码的详细信息