Claude Code Integration with Suno MCP
📘 Overview：Claude Code MCP Overview →
Claude Code is Anthropic's official command-line AI assistant. After connecting to the Suno MCP Server, you can directly create songs in the terminal—write lyrics, choose styles, generate music, and remix, all without leaving the command line.
¶ Obtain API Token
Before using the Suno MCP Server, you need to prepare an Ace Data Cloud API Token. The method to obtain it is consistent with the Claude Code VS Code configuration tutorial:
- Open the Ace Data Cloud Console - Application List to get your API Token for backup.
- If you are not logged in or registered, you will be automatically redirected to the login page; after logging in or registering, you will be automatically returned to the current page.
- The first application will grant a free quota, allowing you to experience the Claude Code MCP service for free.
One Token can be used for all MCP Servers provided by Ace Data Cloud, without needing to apply separately for Suno. The documentation and screenshots suggest displaying only a masked version, such as YOUR_ACEDATACLOUD_API_KEY, and not posting the full Token in public repositories, Issues, screenshots, or chat records.
Using the claude.ai web version or Claude Desktop? They support OAuth one-click authorization, eliminating the need to manually fill in the Token. For details, see the Suno MCP's Claude.ai / Desktop tutorial.
¶ Configure Claude Code
Choose one from the following three options. -H must be uppercase; lowercase -h is --help; replace the Token after Authorization with the actual value you copied from the console.
¶ For Current Project Only: local
Suitable for trial use, the configuration is bound only to the project directory where you run the command. Claude Code will write the records into the local ~/.claude.json, including the current project path.
claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s local
¶ Usable for All Projects: user
Suitable for frequent use of Suno MCP across multiple projects. The configuration is written into the local ~/.claude.json user-level configuration, allowing Claude Code to be visible in any project thereafter.
claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s user
¶ Shared with Project: project
Suitable for team projects. The configuration is written into the .mcp.json in the current project root directory, which can be submitted to a private repository for teammates to reuse; do not submit the real Token to public repositories, and it is recommended to change it to an environment variable placeholder or have each person add it locally.
claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
-H "Authorization: Bearer YOUR_ACEDATACLOUD_API_KEY" \
-s project
When the project-level configuration is first read by Claude Code, it may display Pending approval, requiring confirmation of trust in this project configuration within the Claude Code session; this is a normal security prompt.
¶ Verify Connection
After configuration, run:
claude mcp list
Seeing suno display ✓ Connected indicates a successful handshake. If it fails, check the Token, service URL, and configuration scope; do not judge the current status based on historical client versions or fixed tool counts.
¶ Usage Examples
After configuration, return to the Claude Code session and use natural language to call Suno directly:
Quickly Generate a Song
Generate a folk song about a programmer working late at night
Custom Lyrics Creation
Write lyrics about spring rain, then generate a soft pop song with those lyrics
Cover an Existing Song
Cover the previously generated song in a jazz style
Continue from the Chorus
The chorus sounds great, extend the song from the chorus section
¶ Tool List
| Tool | Description |
|---|---|
| suno_generate_music | Generate a complete song with a single sentence |
| suno_generate_custom_music | Write your own lyrics, set style and vocals |
| suno_extend_music | Continue an existing song from a certain point |
| suno_cover_music | Cover in a different style |
| suno_mashup_music | Mash up two songs into one |
| suno_stems_music | Separate vocals and accompaniment |
| suno_generate_lyrics | AI-generated lyrics |
| suno_create_persona | Save vocal styles |