Dokumentacja serwera Audio MCP

Przegląd

Serwer obsługuje protokół Model Context Protocol (MCP) za pośrednictwem protokołu Streamable HTTP. Należy skierować dowolnego klienta MCP na poniższy punkt końcowy i uwierzytelnić się za pomocą tokenu API VocalRemover. Pliki są przekazywane jako publiczne adresy URL protokołu HTTP(S) (do 100 MB), a wyniki są zwracane w postaci adresów URL umożliwiających pobranie plików.

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

Szybki start

1. Pobierz bezpłatny token API na stronie Strona API.
2. Dodaj serwer do swojego klienta, korzystając z poniższego fragmentu kodu.
3. Zadaj polecenie: „Usuń wokal z ”.

Uwierzytelnianie

1. Załóż bezpłatne konto i otwórz Strona API.
2. Wygeneruj token API.
3. Dodaj go jako token Bearer w konfiguracji klienta MCP (patrz poniżej).

Zarówno bezpłatne narzędzia audio, jak i płatne narzędzia AI korzystają z tego tokenu; różnica polega jedynie na tym, czy naliczane są punkty za minutę konwersji.

Konfiguracja klienta

Dodaj serwer do swojego klienta AI. Claude Desktop korzysta z mostka mcp-remote; Cursor, Windsurf, Cline, Zed i Claude Code obsługują zdalne MCP natywnie za pomocą tokenu Bearer; ChatGPT i aplikacja internetowa Claude.ai dodają go jako niestandardowy łącznik i logują się za pomocą OAuth (patrz poniżej).

{
  "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 (stwórz własnego agenta)

Podłącz serwer do wywołania interfejsu API Claude'a za pomocą nagłówka beta łącznika MCP:

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 (niestandardowy łącznik)

W ustawieniach ChatGPT włącz tryb programisty, otwórz sekcję Aplikacje i łączniki → Utwórz, a następnie dodaj niestandardowy łącznik wskazujący na poniższy adres URL serwera. ChatGPT uruchamia proces OAuth — zaloguj się do serwisu VocalRemover i zatwierdź dostęp; nie trzeba wklejać żadnego tokenu. (Wymagany jest plan z niestandardowymi łącznikami, np. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Twój plan nie obejmuje dostępu do niestandardowych łączników? Utwórz zamiast tego niestandardowy GPT i dodaj akcję, która importuje nasz schemat OpenAPI z uwierzytelnianiem za pomocą klucza API (Bearer).

Claude (aplikacja internetowa, Cowork i Claude Code)

Dodaj serwer jednorazowo jako niestandardowy łącznik, a następnie zezwól na dostęp do sieci, aby Claude mógł przesyłać i pobierać pliki audio.

1. Otwórz menu „Dostosuj” → „Złącza”.
2. Kliknij przycisk „Dodaj łącznik” (przycisk „+”), a następnie wybierz opcję „Dodaj łącznik niestandardowy”.
3. Ustaw nazwę na „VocalRemover”, wklej poniższy adres URL serwera MCP i kliknij Dodaj.
4. Zaloguj się do serwisu VocalRemover i zatwierdź dostęp po wyświetleniu monitu — nie trzeba wklejać tokenu.

https://vocalremover.com/mcp/audio

1. Otwórz Ustawienia → Możliwości.
2. Włącz opcję „Zezwól na ruch wychodzący z sieci”.
3. Dodaj te dwie domeny: vocalremover.com oraz s3.vocalremover.com

To wszystko. Rozpocznij nową sesję w czacie, Cowork lub Claude Code, załącz plik audio i powiedz „usuń wokal” — Claude prześle go i zwróci wynik.

Niestandardowe złącza są dostępne w wersjach Claude Pro, Max, Team i Enterprise.

Narzędzia

Przesyłanie plików lokalnych

Narzędzia wymagają podania publicznego adresu URL. Jeśli plik znajduje się na komputerze użytkownika, należy wywołać bezpłatne narzędzie create_upload w celu uzyskania jednorazowego adresu URL do przesłania, wysłać plik metodą POST na ten adres (nie jest wymagany token), a następnie przekazać zwrócony adres file_url do dowolnego narzędzia audio. Link do przesłania oraz plik tracą ważność po upływie 1 godziny. Nigdy nie koduj prawdziwego pliku audio w formacie base64 — jest on zdecydowanie zbyt duży, by zmieścić się w argumencie narzędzia.

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" }

Nie ma możliwości wysyłania żądań sieciowych (np. w przypadku asystenta działającego w środowisku sandbox)? Wyślij użytkownikowi link do strony upload_page, aby mógł przeciągnąć plik do przeglądarki, a następnie kontynuuj, korzystając z adresu file_url.

W Claude przesyłanie plików wymaga dostępu do sieci w kierunku serwerów vocalremover.com i s3.vocalremover.com — włącz tę opcję w sekcji Ustawienia → Możliwości (zobacz konfigurację Claude powyżej).

Przykład: usunięcie wokalu

Wystarczy poprosić asystenta prostym językiem:

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://..." }
                ] }

Darmowe narzędzia działają w ten sam sposób — na przykład polecenie „konwertuj ten plik do formatu wav” wywołuje funkcję convert_audio i natychmiast zwraca adres URL do pobrania, bez zużywania kredytów.

Warto wypróbować

• ›Usuń wokal z utworu „https://example.com/song.mp3” i przygotuj dla mnie wersję karaoke.
• ›Podziel tę ścieżkę na poszczególne ścieżki — wokal, perkusja, bas, gitara i fortepian.
• ›Konwertuj plik „https://example.com/interview.m4a” do formatu MP3 z przepływnością 128 kbps.
• ›Wyodrębnij tylko ścieżkę dźwiękową z tego filmu: https://example.com/clip.mp4
• ›Oczyść ten podcast z szumów i usuń echo pomieszczenia: https://example.com/episode.wav
• ›Zmień głos wokalisty w tym utworze na głos o identyfikatorze „tenor-male” z wysokością dźwięku podwyższoną o +2 półtony: https://example.com/song.mp3
• ›Przygotuj wersję 8D i skróć ją do 30 sekund.
• ›Jaki jest czas trwania i szybkość transmisji pliku „https://example.com/track.flac”?
• ›Sprawdź stan mojego konta.

Ograniczenia i uwagi

• Pliki wejściowe muszą być publicznymi adresami URL w protokole http(s), a każdy z nich może mieć maksymalnie 100 MB.
• Separacja AI przebiega asynchronicznie — wynik należy zawsze sprawdzać za pomocą funkcji check_audio_job.
• Punkty są naliczane za każdą minutę nagrania audio, wyłącznie w przypadku separacji za pomocą sztucznej inteligencji.
• Bezpłatne narzędzia audio nigdy nie wykorzystują kredytów.

Prywatność i bezpieczeństwo

• Twoje pliki audio są pobierane z podanego przez Ciebie adresu URL, przetwarzane, a następnie usuwane — nie przechowujemy Twoich plików.
• Twój token API jest przypisany do Twojego konta; możesz go w dowolnym momencie cofnąć na stronie API.
• Punkt końcowy obsługuje wyłącznie protokół HTTPS; blokujemy adresy URL, które prowadzą do adresów prywatnych lub wewnętrznych.

Rozwiązywanie problemów

Powrót do przeglądu serwerów MCP