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

# Suno MCP Integrationsanleitung

> suno MCP server integration

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) ist ein von Anthropic eingeführtes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Werkzeuge über standardisierte Schnittstellen aufzurufen. Über den von AceData Cloud bereitgestellten Suno MCP Server kannst du direkt in AI-Clients wie Claude Desktop, VS Code, Cursor Musik, Texte und Audio-Projekte verwalten.

## Funktionsübersicht

Der Suno MCP Server bietet folgende Kernfunktionen:

* **Musikgenerierung** — KI-Musik durch Texteingaben generieren
* **Benutzerdefinierte Kreation** — Vollständige Kontrolle über Texte, Titel und Musikstil
* **Songfortsetzung** — Fortsetzung eines bestehenden Songs ab einem beliebigen Zeitpunkt
* **Cover/Mixing** — Erstellen von Coverversionen in verschiedenen Stilen
* **Textgenerierung** — Strukturierte Texte basierend auf Beschreibungen generieren
* **Stimmenrollen** — Stimmenstile speichern und wiederverwenden
* **Medienkonvertierung** — Erhalten von MP4, WAV, MIDI, Stimmtrennung usw.
* **Stiloptimierung** — Optimierung von Musikstil-Tags
* **Aufgabenabfrage** — Überwachung des Generierungsfortschritts und Abruf von Ergebnissen

## Vorbereitungen

Vor der Nutzung musst du ein AceData Cloud API Token erhalten:

1. Registriere dich oder melde dich bei der [AceData Cloud Plattform](https://platform.acedata.cloud) an
2. Gehe zur Seite [Suno Audios API](https://platform.acedata.cloud/documents/suno-audios)
3. Klicke auf „Acquire“, um ein API Token zu erhalten (bei der ersten Anfrage gibt es ein kostenloses Kontingent)

## Installation und Konfiguration

### Methode 1: pip Installation (empfohlen)

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

### Methode 2: Quellcode-Installation

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

Nach der Installation kannst du den Dienst mit dem Befehl `mcp-suno` starten.

## Verwendung in Claude Desktop

Bearbeite die Konfigurationsdatei von Claude Desktop:

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

Füge die folgende Konfiguration hinzu:

```json theme={null}
{
  "mcpServers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

Wenn du `uvx` verwendest (keine vorherige Installation erforderlich):

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

Speichere die Konfiguration und starte Claude Desktop neu, um die Suno-Tools im Dialog zu verwenden.

## Verwendung in VS Code / Cursor

Erstelle im Stammverzeichnis des Projekts die Datei `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "suno": {
      "command": "mcp-suno",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "dein API Token"
      }
    }
  }
}
```

Oder verwende `uvx`:

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

## Verfügbare Werkzeugliste

| Werkzeugname | Beschreibung |
| - | - |
| `suno_generate_music` | Musik durch Texteingaben generieren |
| `suno_generate_custom_music` | Musik mit benutzerdefinierten Texten und Stilen generieren |
| `suno_extend_music` | Fortsetzung eines Songs ab einem bestimmten Zeitpunkt |
| `suno_cover_music` | Erstellen von Coverversionen |
| `suno_concat_music` | Zusammenfügen von Musikstücken |
| `suno_generate_with_persona` | Musik mit einer bestimmten Stimmenrolle generieren |
| `suno_remaster_music` | Neu abmischen |
| `suno_stems_music` | Trennen von Spuren (Gesang/Instrumental) |
| `suno_replace_section` | Ersetzen eines bestimmten Abschnitts im Song |
| `suno_upload_extend` | Audio hochladen und fortsetzen |
| `suno_upload_cover` | Audio hochladen und covern |
| `suno_mashup_music` | Mischen mehrerer Songs |
| `suno_generate_lyrics` | Texte basierend auf Beschreibungen generieren |
| `suno_create_persona` | Stimmenrolle erstellen |
| `suno_get_mp4` | MP4-Video des Songs erhalten |
| `suno_get_timing` | Zeitachse der Texte erhalten |
| `suno_extract_vocals` | Gesang extrahieren |
| `suno_get_wav` | Hochwertige WAV erhalten |
| `suno_get_midi` | MIDI-Datei erhalten |
| `suno_optimize_style` | Musikstil-Tags optimieren |
| `suno_mashup_lyrics` | Texte mischen |
| `suno_upload_audio` | Benutzerdefiniertes Audio hochladen |
| `suno_get_task` | Status einer einzelnen Aufgabe abfragen |
| `suno_get_tasks_batch` | Status mehrerer Aufgaben abfragen |

## Anwendungsbeispiele

Nach der Konfiguration kannst du diese Funktionen direkt in den AI-Clients mit natürlicher Sprache aufrufen, zum Beispiel:

* „Hilf mir, einen Popsong über den Sommer zu generieren“
* „Mach ein Jazz-Cover von diesem Lied“
* „Setze diesen Song ab der 30. Sekunde fort“
* „Generiere einen Songtext auf Chinesisch mit dem Thema Reisen“
* „Trenne den Gesang von diesem Lied“
* „Hilf mir, dieses Lied in das MIDI-Format zu konvertieren“

## Weitere Informationen

* GitHub-Repository: [AceDataCloud/SunoMCP](https://github.com/AceDataCloud/SunoMCP)
* PyPI-Paket: [mcp-suno](https://pypi.org/project/mcp-suno/)
* API-Dokumentation: [Suno Musikgenerierungs-API](https://platform.acedata.cloud/documents/suno)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.