> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guida all'integrazione di Suno MCP

> suno MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto del modello lanciato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite interfacce standardizzate. Attraverso il Suno MCP Server fornito da XHuoAPI, puoi generare direttamente musica, testi e gestire progetti audio in client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Il Suno MCP Server offre le seguenti funzionalità principali:

* **Generazione musicale** — Genera musica AI tramite suggerimenti testuali
* **Creazione personalizzata** — Controllo completo su testi, titoli e stili musicali
* **Continuazione di canzoni** — Estendi una canzone esistente da qualsiasi punto temporale
* **Cover/Mixing** — Crea versioni cover in stili diversi
* **Generazione di testi** — Genera testi strutturati in base a descrizioni
* **Ruoli vocali** — Salva e riutilizza stili vocali
* **Conversione media** — Ottieni MP4, WAV, MIDI, separazione delle voci, ecc.
* **Ottimizzazione dello stile** — Ottimizza le etichette di stile musicale
* **Query di attività** — Monitora il progresso della generazione e ottieni risultati

## Preparazione preliminare

Prima di utilizzare, devi ottenere il Token API di XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [Suno Audios API](https://api.xhuoapi.ai/documents/suno-audios)
3. Clicca su "Acquire" per ottenere il Token API (il primo acquisto include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione pip (consigliato)

```bash theme={null}
pip install mcp-suno
```

### Metodo 2: installazione da sorgente

```bash theme={null}
git clone https://github.com/XHuoAPI/SunoMCP.git
cd SunoMCP
pip install -e .
```

Dopo l'installazione, puoi avviare il servizio utilizzando il comando `mcp-suno`.

## Utilizzo in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Aggiungi la seguente configurazione:

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Se utilizzi `uvx` (non è necessario installare pacchetti in anticipo):

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Dopo aver salvato la configurazione, riavvia Claude Desktop per utilizzare gli strumenti correlati a Suno nella conversazione.

## Utilizzo in VS Code / Cursor

Crea un file `.vscode/mcp.json` nella directory principale del progetto:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

Oppure utilizza `uvx`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "il tuo Token API"
      }
    }
  }
}
```

## Elenco degli strumenti disponibili

| Nome dello strumento         | Descrizione                                           |
| ---------------------------- | ----------------------------------------------------- |
| `suno_generate_music`        | Genera musica tramite suggerimenti testuali           |
| `suno_generate_custom_music` | Genera musica con testi e stili personalizzati        |
| `suno_extend_music`          | Estendi una canzone da un punto temporale specificato |
| `suno_cover_music`           | Crea versioni cover                                   |
| `suno_concat_music`          | Unisci frammenti di canzoni                           |
| `suno_generate_with_persona` | Genera musica utilizzando un ruolo vocale specificato |
| `suno_remaster_music`        | Rielabora il master                                   |
| `suno_stems_music`           | Separa le tracce (voce/strumenti)                     |
| `suno_replace_section`       | Sostituisci un segmento specifico di una canzone      |
| `suno_upload_extend`         | Carica audio e continua la scrittura                  |
| `suno_upload_cover`          | Carica audio e crea una cover                         |
| `suno_mashup_music`          | Combina più canzoni                                   |
| `suno_generate_lyrics`       | Genera testi in base a descrizioni                    |
| `suno_create_persona`        | Crea un ruolo vocale                                  |
| `suno_get_mp4`               | Ottieni video MP4 della canzone                       |
| `suno_get_timing`            | Ottieni la timeline dei testi                         |
| `suno_extract_vocals`        | Estrai la voce                                        |
| `suno_get_wav`               | Ottieni WAV di alta qualità                           |
| `suno_get_midi`              | Ottieni file MIDI                                     |
| `suno_optimize_style`        | Ottimizza le etichette di stile musicale              |
| `suno_mashup_lyrics`         | Combina testi                                         |
| `suno_upload_audio`          | Carica audio personalizzato                           |
| `suno_get_task`              | Controlla lo stato di un singolo compito              |
| `suno_get_tasks_batch`       | Controlla lo stato di più compiti                     |

## Esempi di utilizzo

Dopo aver completato la configurazione, puoi chiamare queste funzionalità direttamente in linguaggio naturale nei client AI, ad esempio:

* "Aiutami a generare una canzone pop sull'estate"
* "Fai una cover di questa canzone in stile jazz"
* "Continua questa canzone, partendo dal 30° secondo"
* "Genera un testo in cinese, il tema è il viaggio"
* "Separa la voce da questa canzone"
* "Aiutami a convertire questa canzone in formato MIDI"

## Maggiori informazioni

* Repository GitHub: [XHuoAPI/SunoMCP](https://github.com/XHuoAPI/SunoMCP)
* Pacchetto PyPI: [mcp-suno](https://pypi.org/project/mcp-suno/)
* Documentazione API: [API di generazione musicale Suno](https://api.xhuoapi.ai/documents/suno)