关于 setup-api-key
此技能引导用户创建并验证本地保存的 Vapi API 密钥,重点是避免在聊天中暴露密钥并保护本地环境文件。
主要功能
- 01引导创建 API 密钥
- 02设置本地环境变量
- 03不显示密钥地验证
- 04检查 .gitignore 保护
适用场景
- 01为其他技能配置 Vapi 访问
- 02检查本地保存的 API 密钥
- 03避免将环境文件提交到版本控制
MCP 相关
README 提及 Vapi 文档 MCP 服务,可供兼容的 AI Agent 查询文档。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ vapiai/ skills --skill setup-api-key安装后在 Claude Code 中输入/setup-api-key确认已加载。
详细介绍
Vapi API 密钥设置
指导用户获取并配置语音 AI 平台 Vapi 的 API 密钥。
工作流
第 1 步:请求 API 密钥
告诉用户:
要设置 Vapi,请打开 Vapi Dashboard 中的 API 密钥页面:https://dashboard.vapi.ai/org/api-keys
(还没有账户?请先前往 https://dashboard.vapi.ai/signup 创建一个)
如果你还没有 API 密钥:
- 点击 "Create Key"
- 为密钥命名(例如,"development")
- 立即复制密钥——它只会显示一次
请勿将私有 API 密钥粘贴到此聊天中。请按照以下步骤在本地保存,然后告诉我文件已准备就绪。
然后等待用户确认本地环境文件已准备就绪。不要要求用户发送或显示密钥。
第 2 步:验证并配置
用户确认密钥已保存在本地后:
-
在不打印密钥的情况下确认密钥可用。 优先使用现有环境变量。否则,请用户使用编辑器将其保存为本地
.env.local文件中的VAPI_API_KEY。切勿显示文件内容。 -
验证密钥:从加载了密钥的环境发起请求:
curl -s -o /dev/null -w "%{http_code}" https://api.vapi.ai/assistant \ -H "Authorization: Bearer $VAPI_API_KEY" -
如果验证失败(非 200 响应):
- 告诉用户 API 密钥似乎无效
- 请用户仔细检查并重试
- 提醒用户访问此 URL:https://dashboard.vapi.ai/org/api-keys
-
如果验证成功,确认本地环境文件包含此变量,但不要显示其值:
VAPI_API_KEY=<the-api-key> -
确认成功:
你的 Vapi API 密钥已在本地配置为
VAPI_API_KEY。现在可以使用 Vapi 的 API 创建助手、拨打电话和构建语音 AI Agent。
请妥善保管此密钥——不要将其提交到版本控制中。
第 3 步:检查 .gitignore
检查 .gitignore 是否保护了本地环境文件。如果没有,请添加:
.env*
!.env.example
环境变量
所有 Vapi 技能都要求在 VAPI_API_KEY 环境变量中提供 API 密钥。所有 API 请求的基础 URL 为:
https://api.vapi.ai
身份验证使用 Bearer 令牌:
Authorization: Bearer $VAPI_API_KEY
其他资源
Vapi 提供了一个文档 MCP 服务,可让兼容的 AI Agent 访问 Vapi 知识库。对于高级配置、故障排除、SDK 详情,以及本技能未涵盖的内容,请使用其文档搜索功能。
手动设置: 如果你的 Agent 未自动检测到配置,请运行:
claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server
请参阅 Vapi MCP 集成指南,了解在受支持的 Agent 中进行设置的说明。