Claude Code 对接 Suno MCP

📘 Overview：Claude Code MCP Overview →

Claude Code 是 Anthropic 官方的命令行 AI 助手。接上 Suno MCP Server 后，你可以在终端里直接创作歌曲——写歌词、选风格、生成音乐、翻唱混搭，全程不离开命令行。

获取 API Token

使用 Suno MCP Server 之前，需要先准备一个 Ace Data Cloud API Token。获取方式和 Claude Code VS Code 配置教程保持一致：

打开 Ace Data Cloud 控制台 - 应用列表，获取您的 API Token，留作备用。
如果你尚未登录或注册，会自动跳转到登录页面；登录注册之后会自动返回当前页面。
首次申请时会有免费额度赠送，可以先免费体验 Claude Code MCP 服务。

一个 Token 可以使用 AceData Cloud 提供的全部 MCP Server，无需为 Suno 单独申请。文档和截图里建议只展示脱敏形式，例如 3b78cc40dd3b43db806a4300....，不要把完整 Token 贴到公开仓库、Issue、截图或聊天记录里。

用 claude.ai 网页版或 Claude Desktop？它们支持 OAuth 一键授权，无需手动填 Token，详见 Suno MCP 的 Claude.ai / Desktop 教程。

配置 Claude Code

下面三组选一种即可。-H 必须大写，小写 -h 是 --help；Authorization 后面的 Token 请替换成你在控制台复制到的真实值。

只给当前项目用：local

适合先试用，配置只绑定你运行命令时所在的项目目录。Claude Code 会把记录写进本机 ~/.claude.json，并带上当前项目路径。

1
2
3

claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 3b78cc40dd3b43db806a4300...." \
  -s local

所有项目都能用：user

适合你经常在多个项目里使用 Suno MCP。配置写进本机 ~/.claude.json 的用户级配置，之后任何项目打开 Claude Code 都能看到。

1
2
3

claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 3b78cc40dd3b43db806a4300...." \
  -s user

随项目共享：project

适合团队项目。配置写进当前项目根目录的 .mcp.json，可以提交到私有仓库让队友复用；公开仓库不要提交真实 Token，建议改成环境变量占位符或让每个人本地自行添加。

1
2
3

claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 3b78cc40dd3b43db806a4300...." \
  -s project

项目级配置第一次被 Claude Code 读取时，可能会显示 Pending approval，需要在 Claude Code 会话里确认信任这个项目配置，这是正常的安全提示。

真实运行结果

下面是在 Claude Code 2.1.158 中用隔离临时目录实际执行后的脱敏输出。命令使用真实 AceData Cloud Token，输出中的 Token 已替换成 3b78cc40dd3b43db806a4300....，临时配置已删除。

1 2	Added HTTP MCP server suno with URL: https://suno.mcp.acedata.cloud/mcp to local config suno: https://suno.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected

三种 scope 的行为也做过实测：

1
2
3

luma-local: https://luma.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected
luma-user: https://luma.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected
luma-project: https://luma.mcp.acedata.cloud/mcp (HTTP) - ⏸ Pending approval (run `claude` to approve)

确认本机配置时可以运行：

1	claude mcp list

看到 suno: https://suno.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected 就说明 Suno MCP 已经接入成功。

使用示例

配置完成后，回到 Claude Code 会话直接用自然语言即可调用 Suno：

快速生成一首歌

1	Generate a folk song about a programmer working late at night

自定义歌词创作

1	Write lyrics about spring rain, then generate a soft pop song with those lyrics

翻唱已有歌曲

1	Cover the previously generated song in a jazz style

从副歌续写

1	The chorus sounds great, extend the song from the chorus section

工具列表

工具	说明
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	保存声音风格

静觅崔庆才的个人站点 - Python爬虫教程