Dokumentation zum Audio-MCP-Server

Verbinde die VocalRemover-Audio-Toolbox mit deinem KI-Assistenten und beginne, Audiodateien mit natürlicher Sprache zu bearbeiten.

Übersicht

Der Server nutzt das Model Context Protocol über Streamable HTTP. Richte einen beliebigen MCP-Client auf den unten angegebenen Endpunkt aus und authentifiziere dich mit einem VocalRemover-API-Token. Dateien werden als öffentliche HTTP(S)-URLs (bis zu 100 MB) übermittelt, und die Ergebnisse werden als herunterladbare URLs zurückgegeben.

Endpoint:  https://vocalremover.com/mcp/audio
Transport: Streamable HTTP (POST)
Auth:      Authorization: Bearer YOUR_API_TOKEN

Schnellstart

Hol dir einen kostenlosen API-Token auf der API-Seite.
Füge den Server mithilfe des folgenden Code-Schnipsels zu deinem Client hinzu.
Frage: „Entferne den Gesang aus .“

Authentifizierung

Erstelle ein kostenloses Konto und öffne die API-Seite.
API-Token generieren.
Füge es als Bearer-Token in deine MCP-Client-Konfiguration ein (siehe unten).

Sowohl die kostenlosen Audio-Tools als auch die kostenpflichtigen KI-Tools verwenden dieses Token; der einzige Unterschied besteht darin, ob Credits für die Konvertierungsminuten abgerechnet werden.

Client-Einrichtung

Füge den Server zu deinem AI-Client hinzu. Claude Desktop verwendet die mcp-remote-Bridge; Cursor, Windsurf, Cline, Zed und Claude Code unterstützen Remote-MCP nativ mit einem Bearer-Token; ChatGPT und die Claude.ai-Web-App fügen es als benutzerdefinierten Konnektor hinzu und melden sich über OAuth an (siehe unten).

Claude Desktop

Füge dies zur Datei „claude_desktop_config.json“ hinzu und starte Claude anschließend neu.

{
  "mcpServers": {
    "vocalremover": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vocalremover.com/mcp/audio",
        "--header", "Authorization:${AUTH}"
      ],
      "env": { "AUTH": "Bearer YOUR_API_TOKEN" }
    }
  }
}

Cursor · Windsurf · Cline · Zed

Native Remote-MCP – zur Datei „mcp.json“ des Clients hinzufügen.

{
  "mcpServers": {
    "vocalremover": {
      "url": "https://vocalremover.com/mcp/audio",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Claude-Code (CLI)

Ein Befehl – natives Remote-MCP, keine Bridge.

claude mcp add --transport http \
  vocalremover https://vocalremover.com/mcp/audio \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Anthropic Messages API (baue deinen eigenen Agenten)

Verbinde den Server mit einem Claude-API-Aufruf mithilfe des MCP-Connector-Beta-Headers:

client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Remove vocals from https://example.com/song.mp3"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://vocalremover.com/mcp/audio",
        "name": "vocalremover",
        "authorization_token": "YOUR_API_TOKEN",
    }],
    betas=["mcp-client-2025-11-20"],
)

ChatGPT (benutzerdefinierter Konnektor)

Aktiviere in den ChatGPT-Einstellungen den Entwicklermodus, öffne „Apps & Connectors“ → „Erstellen“ und füge einen benutzerdefinierten Connector hinzu, der auf die unten angegebene Server-URL verweist. ChatGPT führt den OAuth-Ablauf durch – du meldest dich bei VocalRemover an und genehmigst den Zugriff; es muss kein Token eingefügt werden. (Erfordert einen Tarif mit benutzerdefinierten Konnektoren, z. B. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Kein Zugriff auf benutzerdefinierte Konnektoren in deinem Tarif? Erstelle stattdessen ein benutzerdefiniertes GPT und füge eine Aktion hinzu, die unser OpenAPI-Schema mit API-Schlüssel-Authentifizierung (Bearer) importiert.

Claude (Web-App, Cowork & Claude Code)

Füge den Server einmal als benutzerdefinierten Konnektor hinzu und gewähre anschließend Netzwerkzugriff, damit Claude deine Audiodateien hochladen und abrufen kann.

1. Den Anschluss hinzufügen

Öffne „Anpassen“ → „Anschlüsse“.
Klicke auf „Anschluss hinzufügen“ (die Schaltfläche „+“) und wähle dann „Benutzerdefinierten Anschluss hinzufügen“.
Gib als Namen „VocalRemover“ ein, füge die MCP-Server-URL unten ein und klicke auf „Hinzufügen“.
Melde dich bei VocalRemover an und genehmige den Zugriff, wenn du dazu aufgefordert wirst – es muss kein Token eingefügt werden.

https://vocalremover.com/mcp/audio

2. Netzwerkzugriff zulassen (damit Dateien hochgeladen werden können)

Öffne „Einstellungen“ → „Funktionen“.
Aktiviere „Netzwerkausgang zulassen“.
Füge diese beiden Domänen hinzu: vocalremover.com und s3.vocalremover.com

Das war’s schon. Starte eine neue Chat-, Cowork- oder Claude-Code-Sitzung, füge eine Audiodatei hinzu und sage „Gesang entfernen“ – Claude lädt die Datei hoch und liefert das Ergebnis zurück.

Benutzerdefinierte Konnektoren sind in den Versionen Claude Pro, Max, Team und Enterprise verfügbar.

Tools

Werkzeug	Stufe	Parameter	Funktionsbeschreibung
probe_audio	Kostenlos	url	Gibt die Dauer, die Bitrate, das Format und die geschätzten Lizenzkosten einer Datei zurück.
convert_audio	Kostenlos	url, format	Audio in die Formate MP3, WAV, FLAC, OGG, M4A, AAC oder Opus neu kodieren und eine Download-URL zurückgeben.
trim_audio	Kostenlos	url, start_seconds, duration_seconds	Schneidet einen Abschnitt aus einer Audiodatei heraus und gibt eine Download-URL zurück.
extract_audio	Kostenlos	url	Extrahiert die Audiospur aus einer Videodatei als MP3.
list_voices	Kostenlos	—	Listet die Zielstimmen auf, die clone_voice akzeptiert – id, name, category und ob ein Vorschaubeispiel existiert.
separate_audio	Credits	url, task	Startet die KI-Trennung (vocals, instrumental, lead_vocals, stems, denoise, dereverb). Gibt eine job_id zurück.
clone_voice	Credits	url, voice \| voice_file_url, mode?, pitch?	Wandelt die Stimme in einer Audiodatei in eine Stimmen-ID aus list_voices um – oder in einen eigenen Referenzclip, den du als voice_file_url übergibst. Optionaler mode (singing oder speech) und Tonhöhenverschiebung in Halbtönen. Gibt eine job_id zurück – rufe check_audio_job auf, um die konvertierte Audiodatei abzurufen.
check_audio_job	Kostenlos	job_id	Frage den Status eines Trennungs- oder Sprachkonvertierungsauftrags ab und rufe nach Abschluss die URLs zum Herunterladen der Ergebnisse ab.
check_balance	Kostenlos	—	Zeigt an, wie viele Konversionsminuten-Guthaben dem Konto noch zur Verfügung stehen.

Lokale Dateien hochladen

Die Tools erwarten eine öffentliche URL. Befindet sich die Datei auf dem Rechner des Benutzers, rufe das kostenlose Tool „create_upload“ auf, um eine einmalige Upload-URL zu erhalten, sende die Datei per POST an diese URL (kein Token erforderlich) und übergib anschließend die zurückgegebene „file_url“ an ein beliebiges Audio-Tool. Der Upload-Link und die Datei verfallen nach einer Stunde. Konvertiere eine echte Audiodatei niemals in Base64 – sie ist viel zu groß für ein Tool-Argument.

Assistant calls:  create_upload { "filename": "song.mp3" }
            ->  { "upload_url": "https://vocalremover.com/api/uploads/01h...",
                  "file_url":   "https://vocalremover.com/storage/mcp-uploads/01h....mp3",
                  "upload_page":"https://vocalremover.com/upload/01h..." }

# Upload the bytes (model's sandbox, a terminal, or the user's browser):
curl -F "file=@song.mp3" "https://vocalremover.com/api/uploads/01h..."
            ->  { "file_url": "https://vocalremover.com/storage/mcp-uploads/01h....mp3" }

Assistant calls:  separate_audio { "url": "", "task": "vocals" }

Es gibt keine Möglichkeit, Webanfragen zu stellen (z. B. über einen Sandbox-Assistenten)? Sende dem Benutzer den Link „upload_page“, damit er die Datei in einem Browser ablegen kann, und fahre dann mit der „file_url“ fort.

In Claude erfordert der Datei-Upload einen ausgehenden Netzwerkzugriff auf vocalremover.com und s3.vocalremover.com – aktiviere diesen unter „Einstellungen“ → „Funktionen“ (siehe die obige Claude-Konfiguration).

Beispiel: Gesang entfernen

Frag deinen Assistenten einfach in natürlicher Sprache:

You: Remove the vocals from https://example.com/song.mp3

Assistant calls:  separate_audio { "url": "...", "task": "vocals" }
            ->  { "job_id": "01H...", "status": "in_process_queue" }

Assistant calls:  check_audio_job { "job_id": "01H..." }
            ->  { "done": true, "outputs": [
                    { "track": "vocals",        "download_url": "https://..." },
                    { "track": "instrumentals", "download_url": "https://..." }
                ] }

Die kostenlosen Tools funktionieren auf dieselbe Weise – beispielsweise ruft der Befehl „Diese Datei in WAV konvertieren“ die Funktion `convert_audio` auf und gibt sofort eine Download-URL zurück, ohne dass Credits verbraucht werden.

Tipps zum Ausprobieren

›Entferne den Gesang aus „https://example.com/song.mp3“ und gib mir die Karaoke-Version.
›Teile diese Spur in einzelne Spuren auf – Gesang, Schlagzeug, Bass, Gitarre und Klavier.
›https://example.com/interview.m4a in MP3 mit 128 kbps konvertieren.
›Extrahiere nur den Ton aus diesem Video: https://example.com/clip.mp4
›Entrausche diesen Podcast und entferne den Raumhall: https://example.com/episode.wav
›In welche Stimmen kannst du klonen?
›Konvertiere die Stimme des Sängers in diesem Titel in die Stimmart „Tenor-männlich“ mit einer Tonhöhe von +2 Halbtönen: https://example.com/song.mp3
›Lass https://example.com/song.mp3 wie die Stimme in https://example.com/my-voice.m4a klingen
›Erstelle eine 8D-Version und kürze sie auf 30 Sekunden.
›Wie lang ist „https://example.com/track.flac“ und wie hoch ist die Bitrate?
›Mein Guthaben prüfen.

Einschränkungen und Hinweise

Eingabedateien müssen öffentliche HTTP(S)-URLs sein und dürfen jeweils maximal 100 MB groß sein.
Die KI-Trennung läuft asynchron – frage das Ergebnis immer über `check_audio_job` ab.
Credits werden pro Audio-Minute berechnet, ausschließlich für die KI-Trennung.
Die kostenlosen Audio-Tools verbrauchen niemals Credits.

Datenschutz und Sicherheit

Deine Audiodateien werden von der von dir angegebenen URL abgerufen, verarbeitet und anschließend gelöscht – wir speichern deine Dateien nicht.
Dein API-Token ist auf dein Konto beschränkt; du kannst es jederzeit auf der API-Seite widerrufen.
Der Endpunkt ist ausschließlich über HTTPS erreichbar; wir blockieren URLs, die auf private/interne Adressen verweisen.

Fehlerbehebung

„Authentifizierung erforderlich“: Das Token fehlt oder der Header ist falsch – er muss genau wie folgt lauten: Authorization: Bearer YOUR_API_TOKEN.

„Die Datei konnte nicht heruntergeladen werden“: Die URL muss öffentlich sein – es darf keine Anmeldebarriere geben und sie darf nicht auf eine private Adresse weiterleiten.

Ein Separationsauftrag scheint hängen geblieben zu sein: AI-Jobs sind asynchron – frage „check_audio_job“ nach 10–30 Sekunden ab, bis „done“ den Wert „true“ annimmt.

Claude Desktop lässt sich nicht verbinden: Stelle sicher, dass Node/npx installiert ist und in deinem PATH steht, verwende „mcp-remote@latest“ und starte Claude nach der Bearbeitung der Konfiguration vollständig neu.

Zurück zur MCP-Server-Übersicht