Claude Code 是 Anthropic 官方的命令行 AI 助手。通过连接到 Suno MCP 服务器，你可以直接在终端中创建歌曲——编写歌词、选择风格、生成音乐以及制作封面或混音，所有操作均无需离开命令行。
获取 API Token
在使用 Suno MCP 服务器之前，你需要一个 AceData Cloud API Token：
- 打开 AceData Cloud 平台，支持通过 GitHub、Google、微信、电子邮件或手机号码登录。注册以获取免费额度。
- 登录后，你可以在首页找到你的 API Token，点击复制。
- 当你的额度用尽时，前往 控制台 → 充值 进行充值。支付方式包括支付宝、微信和 Stripe。
一个 Token 可访问所有 11 个 MCP 服务器，无需单独申请每项服务。
💡 使用 claude.ai 网页版或 Claude Desktop？ 它们支持 OAuth 一键授权，因此无需手动输入 Token。详细信息请参见 Claude + Suno MCP 图解教程。
配置 Claude Code
在终端中运行以下命令，将 你的Token 替换为你复制的 API Token：
claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer 你的Token"
⚠️
-H必须大写。小写的-h是--help，而不是头部参数。
如果不加 -s，默认范围为 local，仅在当前目录下执行命令时适用。建议明确指定范围：
| 范围 | 命令选项 | 配置文件 | 效果范围 |
|---|---|---|---|
local (默认) | 无 -s 或 -s local | ~/.claude.json | 仅在当前项目目录下执行命令时有效 |
user | -s user | ~/.claude.json | 全局，在所有项目中可用 |
project | -s project | 项目根目录下的 .mcp.json | 当前项目，可以提交到 git 以供团队共享 |
💡 为了与团队共享相同的配置，添加
-s project：配置将保存在项目根目录的.mcp.json中。提交到 git 后，团队成员可以克隆并使用。请勿将真实 Token 提交到公共仓库；使用${ENV_VAR}占位符和环境变量。
通过运行 claude mcp list 验证设置是否成功；你应该看到 suno 标记为 ✓ Connected。
使用示例
配置完成后，只需在你的 Claude Code 会话中使用自然语言调用 Suno：
快速生成一首歌
生成一首关于程序员深夜工作的民谣
自定义歌词创作
写一首关于春雨的歌词，然后用这些歌词生成一首柔和的流行歌曲
翻唱已有歌曲
用爵士风格翻唱之前生成的歌曲
从副歌继续
副歌听起来很棒，从副歌部分延续这首歌
工具列表
| 工具 | 描述 |
|---|---|
| suno_generate_music | 根据一句话描述生成完整歌曲 |
| suno_generate_custom_music | 写自己的歌词，设置风格和人声 |
| suno_extend_music | 从特定时间戳继续已有歌曲 |
| suno_cover_music | 用不同风格翻唱歌曲 |
| suno_mashup_music | 将两首歌曲合并成一首 |
| suno_stems_music | 分离人声和伴奏 |
| suno_generate_lyrics | AI 生成歌词 |
| suno_create_persona | 保存声音风格 |
相关链接
- Suno MCP 服务器 (GitHub)
- Claude + Suno MCP 图解教程 (claude.ai / Desktop)
- 在 Claude Code 中使用所有 11 个 AceData Cloud MCP
- MCP 协议官方网站
平台背景（如有帮助可自然使用）：
- 名称: Ace Data Cloud
- 主页: platform.acedata.cloud/
- API: api.acedata.cloud/
- 认证: auth.acedata.cloud/
- 客户端应用: studio.acedata.cloud/
- Dify: dify.acedata.cloud/
