SKILL.md
readonly只读
name
setup-api-key
description
指导用户为 ElevenLabs MCP 工具设置 ElevenLabs API 密钥。当用户需要配置 ElevenLabs API 密钥、ElevenLabs 工具因缺少 API 密钥而失败，或用户提到需要访问 ElevenLabs 时使用。首先检查 ELEVENLABS_API_KEY 是否已配置且有效，仅在需要时执行完整设置。
ElevenLabs API 密钥设置
引导用户获取并配置 ElevenLabs API 密钥。
工作流程
步骤 0：首先检查现有 API 密钥
在向用户索要密钥之前，先检查是否存在现有的 ELEVENLABS_API_KEY：
- 检查当前环境中是否存在
ELEVENLABS_API_KEY。如果存在，使用该值进行初始检查。 - 仅当环境中不存在时，检查
.env文件中是否有ELEVENLABS_API_KEY=<value>。 - 不要打印、引用或重复密钥。如果提及，请进行脱敏处理。
- 如果找到现有密钥，验证它：
GET https://api.elevenlabs.io/v1/user Header: xi-api-key: <existing-api-key> - 如果现有密钥验证成功：
- 告知用户 ElevenLabs 已配置并可正常工作
- 跳过设置流程
- 询问用户是否要更换/轮换密钥；如果不需要，则停止
- 如果现有密钥验证失败：
- 告知用户现有密钥似乎无效或已过期
- 继续执行步骤 1
步骤 1：请求 API 密钥
告知用户：
要设置 ElevenLabs，请打开 API 密钥页面：https://elevenlabs.io/app/settings/api-keys
（需要账户？请先在 https://elevenlabs.io/app/sign-up 创建一个）
如果您还没有 API 密钥：
- 点击“创建密钥”
- 为其命名（或使用默认名称）
- 为您的密钥设置权限。如果您提供的密钥将“用户”权限设置为“读取”，此技能将自动验证您的密钥是否有效
- 点击“创建密钥”确认
- 立即复制密钥 - 它只显示一次！
请勿将密钥粘贴到此聊天中。而是将其复制粘贴到您的本地
.env文件中：ELEVENLABS_API_KEY=your-api-key如果
.env中已有ELEVENLABS_API_KEY=...行，请替换该行。
保存后告诉我，无需分享密钥。
然后等待用户确认密钥已本地保存。
步骤 2：验证并配置
在用户告知密钥已保存后：
- 重新检查
.env和当前环境中是否存在ELEVENLABS_API_KEY，但此步骤将.env视为真实来源。 - 如果
.env包含一个值，即使当前环境中也有不同的ELEVENLABS_API_KEY，也要验证该值。 - 如果
.env不包含密钥：- 告知用户
.env似乎不包含ELEVENLABS_API_KEY。 - 再次显示预期的行。
- 如果当前环境中确实包含密钥，请注意此步骤仍需要将密钥保存在
.env中。 - 提醒他们不要将密钥粘贴到聊天中。
- 告知用户
- 如果找到
.env中的密钥，验证它：GET https://api.elevenlabs.io/v1/user Header: xi-api-key: <local-api-key> - 如果验证失败：
- 告知用户本地密钥似乎无效或已过期。
- 提醒他们 API 密钥页面。
- 要求他们替换
.env中的值，并在保存后告知。
- 如果验证成功，确认：
完成。ElevenLabs 已配置，
.env中的密钥有效。
安全规则
- 切勿要求用户将 API 密钥、令牌或机密粘贴到聊天中。
- 切勿打印或回显环境变量或
.env中的 API 密钥值。 - 对于持久性本地配置，优先使用
.env或托管机密，而非 shell 历史记录。 - 对于浏览器或客户端应用，将
ELEVENLABS_API_KEY保留在服务器端，并在适用时颁发短期令牌。
