AI 工具集成

Skill / MCP

在支持 MCP 的 AI 工具（如 Cursor、Claude Code、Codex）里连接 VoiceMagic，在对话中查音色、合成语音、看任务进度。

去创建 MCP 令牌

MCP 是什么？

一种标准连接方式，无需在本机安装额外程序。

配置访问令牌后，AI 助手即可代你调用本站接口，不必每次打开网页点按钮。

Skill 是什么？

可选说明文档，只配 MCP 也能正常使用。

放到 .cursor/skills/voicemagic/，或在弹窗中查看并复制全文到自定义 Skill。

快速开始

按顺序完成以下四步即可连上。

  1. 1

    创建访问令牌

    登录后打开 我的 → MCP 令牌，创建并立即保存（仅显示一次）。

  2. 2

    配置 MCP

    在你使用的 AI 工具里打开 MCP 设置（如 Cursor、Claude Code、Codex），粘贴下方 JSON，将令牌字段换成你的 vmpat_ 令牌。

  3. 3

    （可选）安装 Skill

    在本页「」按你所用工具安装 Skill（路径因客户端而异）。

  4. 4

    试一句对话

    例如：「列出我的音色」或「查今天合成用量」。

新克隆音色请先在 声音克隆 页上传；MCP 不能创建新音色。

MCP 配置示例

标准 Streamable HTTP 格式；复制 JSON 后按下方各客户端说明写入对应配置。

mcp-config.json
{
  "mcpServers": {
    "voicemagic": {
      "url": "https://voicemagic.demo2easy.com/mcp",
      "headers": {
        "x-voicemagic-mcp-token": "vmpat_你的令牌"
      },
      "type": "streamable-http"
    }
  }
}

各客户端怎么配？

分别说明 MCP 与 Skill；JSON 内容以上一节配置示例为准。

Cursor

打开官方 MCP 文档

配置 MCP

  1. 在网站「我的 → MCP 令牌」创建 vmpat_ 令牌。

  2. 方式 A：Cursor Settings → MCP → 新增服务器，粘贴本页「MCP 配置示例」JSON，并把令牌换成你的。

  3. 方式 B：编辑 ~/.cursor/mcp.json（全局）或项目内 .cursor/mcp.json，在 mcpServers 中加入 voicemagic 配置；保存后重启 Cursor。

配置 Skill可选

  1. 在本页下载 Skill 包（zip）或查看全文后自行保存。

  2. 解压到项目目录 .cursor/skills/voicemagic/SKILL.md（团队共享），或 ~/.cursor/skills/voicemagic/（仅本机）。

  3. 也可在 Settings → Rules / Skills 中手动添加 Skill；只配置 MCP 不装 Skill 也能用。

客户端版本更新可能导致菜单或路径变化，以官方文档为准。JSON 字段与端点见上方「MCP 配置示例」。

连接后可以做什么？

与网页能力一致，在对话里由 AI 代为调用。

  • 查看用量

    今日次数与会员额度

    01

  • 管理音色

    列出、查看已有音色

    02

  • 生成语音

    指定音色合成，可用自然语言描述语气

    03

  • 查任务

    合成进度与结果

    04