Dokumentation zum Audio-MCP-Server

Übersicht

Der Server nutzt das Model Context Protocol über Streamable HTTP. Richten Sie einen beliebigen MCP-Client auf den unten angegebenen Endpunkt aus und authentifizieren Sie sich 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

1. Holen Sie sich einen kostenlosen API-Token auf der API-Seite.
2. Fügen Sie den Server mithilfe des folgenden Code-Schnipsels zu Ihrem Client hinzu.
3. Frage: „Entferne den Gesang aus .“

Authentifizierung

1. Erstellen Sie ein kostenloses Konto und öffnen Sie die API-Seite.
2. API-Token generieren.
3. Fügen Sie es als Bearer-Token in Ihre 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ügen Sie den Server zu Ihrem 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).

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

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

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

Anthropic Messages API (Erstellen Sie Ihren eigenen Agenten)

Verbinden Sie 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)

Aktivieren Sie in den ChatGPT-Einstellungen den Entwicklermodus, öffnen Sie „Apps & Connectors“ → „Erstellen“ und fügen Sie einen benutzerdefinierten Connector hinzu, der auf die unten angegebene Server-URL verweist. ChatGPT führt den OAuth-Ablauf durch – Sie melden sich bei VocalRemover an und genehmigen 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 Ihrem Tarif? Erstellen Sie stattdessen ein benutzerdefiniertes GPT und fügen Sie eine Aktion hinzu, die unser OpenAPI-Schema mit API-Schlüssel-Authentifizierung (Bearer) importiert.

Claude (Web-App, Cowork & Claude Code)

Fügen Sie den Server einmal als benutzerdefinierten Konnektor hinzu und gewähren Sie anschließend Netzwerkzugriff, damit Claude Ihre Audiodateien hochladen und abrufen kann.

1. Öffnen Sie „Anpassen“ → „Anschlüsse“.
2. Klicken Sie auf „Anschluss hinzufügen“ (die Schaltfläche „+“) und wählen Sie dann „Benutzerdefinierten Anschluss hinzufügen“.
3. Geben Sie als Namen „VocalRemover“ ein, fügen Sie die MCP-Server-URL unten ein und klicken Sie auf „Hinzufügen“.
4. Melden Sie sich bei VocalRemover an und genehmigen Sie den Zugriff, wenn Sie dazu aufgefordert werden – es muss kein Token eingefügt werden.

https://vocalremover.com/mcp/audio

1. Öffnen Sie „Einstellungen“ → „Funktionen“.
2. Aktivieren Sie „Netzwerkausgang zulassen“.
3. Fügen Sie 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

Lokale Dateien hochladen

Die Tools erwarten eine öffentliche URL. Befindet sich die Datei auf dem Rechner des Benutzers, rufen Sie das kostenlose Tool „create_upload“ auf, um eine einmalige Upload-URL zu erhalten, senden Sie die Datei per POST an diese URL (kein Token erforderlich) und übergeben Sie anschließend die zurückgegebene „file_url“ an ein beliebiges Audio-Tool. Der Upload-Link und die Datei verfallen nach einer Stunde. Konvertieren Sie 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)? Senden Sie dem Benutzer den Link „upload_page“, damit er die Datei in einem Browser ablegen kann, und fahren Sie dann mit der „file_url“ fort.

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

Beispiel: Gesang entfernen

Fragen Sie Ihren Assistenten einfach in einfacher 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.
• ›Extrahieren Sie nur den Ton aus diesem Video: https://example.com/clip.mp4
• ›Entstören Sie diesen Podcast und entfernen Sie den Raumecho: https://example.com/episode.wav
• ›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
• ›Erstellen Sie eine 8D-Version und kürzen Sie diese 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 – fragen Sie immer bei `check_audio_job` nach dem Ergebnis.
• Credits werden pro Audio-Minute berechnet, ausschließlich für die KI-Trennung.
• Die kostenlosen Audio-Tools verbrauchen niemals Credits.

Datenschutz und Sicherheit

• Ihre Audiodateien werden von der von Ihnen angegebenen URL abgerufen, verarbeitet und anschließend gelöscht – wir speichern Ihre Dateien nicht.
• Ihr API-Token ist auf Ihr Konto beschränkt; Sie können 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

Zurück zur MCP-Server-Übersicht