Claude Code 对接 Suno MCP
内容提要
本文介绍如何将Claude Code与Suno MCP Server对接，实现在终端直接创作歌曲。需先获取Ace Data Cloud API Token，再通过`claude mcp add`命令配置HTTP服务器，支持local、user、project三种作用域。配置完成后可用自然语言生成音乐、自定义歌词、翻唱、续写等，并列出相关工具功能。
延伸解读
作用域选择与安全提示
配置时需注意三种作用域的区别：local 仅对当前项目生效，适合试用；user 对所有项目生效，适合个人常用；project 写入项目根目录的 .mcp.json，可共享给团队，但公开仓库切勿提交真实 Token，建议使用环境变量占位符。项目级配置首次读取时会显示 Pending approval，需在会话中确认信任，这是正常的安全机制。
Token 管理与免费额度
使用前需从 Ace Data Cloud 控制台获取 API Token，一个 Token 可复用其全部 MCP Server，无需为 Suno 单独申请。首次申请有免费额度，可先体验。务必对 Token 脱敏处理，避免在公开仓库、截图或聊天中泄露完整值。若使用 claude.ai 网页版或 Claude Desktop，则支持 OAuth 一键授权，无需手动填 Token。
验证连接与常见问题
配置完成后，可通过 `claude mcp list` 命令检查连接状态，看到 `suno: ... - ✓ Connected` 即表示成功。注意 `-H` 必须大写，小写 `-h` 是帮助命令。若遇到 Pending approval，需在 Claude Code 会话中确认信任项目配置。文中实测基于 Claude Code 2.1.158，不同版本可能略有差异。
Q&A
如何将Claude Code与Suno MCP对接？
首先需要获取Ace Data Cloud API Token，然后使用`claude mcp add`命令添加Suno MCP服务器，指定HTTP传输和服务器URL，并设置作用域（local、user或project）。
在哪里获取Ace Data Cloud API Token？
在Ace Data Cloud控制台的应用列表中获取。首次申请会有免费额度，一个Token可用于所有MCP服务。
Claude Code中配置Suno MCP时，local、user和project三种作用域有什么区别？
local只对当前项目生效，user对所有项目生效，project配置在项目根目录的.mcp.json中，可共享给团队。
如何验证Suno MCP是否配置成功？
运行`claude mcp list`命令，如果看到`suno: https://suno.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected`，则表示配置成功。
配置Suno MCP后，可以用自然语言做哪些事情？
可以快速生成歌曲、自定义歌词创作、翻唱已有歌曲、从副歌续写等。
Suno MCP Server提供哪些工具？
提供suno_generate_music、suno_generate_custom_music、suno_extend_music、suno_cover_music、suno_mashup_music、suno_stems_music、suno_generate_lyrics、suno_create_persona等工具。
在配置Suno MCP时，为什么-H必须大写？
因为小写-h是--help，而-H用于指定请求头，所以必须大写。
项目级配置（project）在首次使用时为什么会出现Pending approval？
这是Claude Code的安全提示，需要用户在会话中确认信任该项目的配置。
