Dokumentace k serveru Audio MCP

Propojte sadu nástrojů VocalRemover se svým AI asistentem a začněte upravovat zvuk pomocí přirozeného jazyka.

Přehled

Server komunikuje pomocí protokolu Model Context Protocol přes Streamable HTTP. Nasměrujte libovolného klienta MCP na níže uvedený koncový bod a proveďte ověření pomocí tokenu API VocalRemover. Soubory se předávají jako veřejné adresy URL typu http(s) (maximálně 100 MB) a výsledky se vrací jako adresy URL ke stažení.

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

Rychlý start

  1. Získejte bezplatný token API na stránce Stránka API.
  2. Přidejte server do svého klienta pomocí níže uvedeného úryvku kódu.
  3. Zadejte: „Odstraňte vokály z .“

Ověřování

  1. Vytvořte si bezplatný účet a otevřete Stránka API.
  2. Vygenerujte token API.
  3. Přidejte jej jako token Bearer do konfigurace svého klienta MCP (viz níže).

Tento token používají jak bezplatné audio nástroje, tak placené nástroje s umělou inteligencí; rozdíl spočívá pouze v tom, zda se účtují kredity za minutu převodu.

Nastavení klienta

Přidejte server do svého AI klienta. Claude Desktop používá most mcp-remote; Cursor, Windsurf, Cline, Zed a Claude Code nativně podporují vzdálené MCP pomocí tokenu Bearer; ChatGPT a webová aplikace Claude.ai jej přidávají jako vlastní konektor a přihlašují se přes OAuth (viz níže).

Claude Desktop

Přidejte do souboru claude_desktop_config.json a poté restartujte Clauda.

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

Nativní vzdálené MCP — přidejte do souboru mcp.json klienta.

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

Claude Code (CLI)

Jeden příkaz — nativní vzdálené MCP, bez mostu.

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

API Anthropic Messages (vytvořte si vlastního agenta)

Připojte server k volání API Claude pomocí hlavičky MCP Connector beta:

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 (vlastní konektor)

V nastavení ChatGPT povolte režim pro vývojáře, otevřete sekci Aplikace a konektory → Vytvořit a přidejte vlastní konektor směřující na níže uvedenou URL adresu serveru. ChatGPT spustí proces OAuth – přihlásíte se do VocalRemover a schválíte přístup; není třeba vkládat žádný token. (Vyžaduje tarif s vlastními konektory, např. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Nemáte ve svém tarifu přístup k vlastním konektorům? Vytvořte si místo toho vlastní GPT a přidejte akci, která importuje naše schéma OpenAPI s autentizací pomocí API klíče (Bearer).

Claude (webová aplikace, Cowork & Claude Code)

Přidejte server jednou jako vlastní konektor a poté povolte síťový přístup, aby mohl Claude nahrávat a stahovat vaše zvukové soubory.

1. Přidejte konektor
  1. Otevřete nabídku Přizpůsobit → Konektory.
  2. Klikněte na tlačítko Přidat konektor (tlačítko +) a poté vyberte možnost Přidat vlastní konektor.
  3. Nastavte název na „VocalRemover“, vložte níže uvedenou URL adresu serveru MCP a klikněte na Přidat.
  4. Přihlaste se do VocalRemover a po zobrazení výzvy povolte přístup — není třeba vkládat žádný token.
https://vocalremover.com/mcp/audio
2. Povolit přístup k síti (aby bylo možné nahrávat soubory)
  1. Otevřete Nastavení → Funkce.
  2. Zapněte možnost Povolit odchozí síťový provoz.
  3. Přidejte tyto dvě domény: vocalremover.com a s3.vocalremover.com

A je to. Spusťte novou relaci Chat, Cowork nebo Claude Code, přiložte zvukový soubor a řekněte „odstranit vokály“ — Claude soubor nahraje a vrátí vám výsledek.

Vlastní konektory jsou k dispozici ve verzích Claude Pro, Max, Team a Enterprise.

Nástroje

Nástroj Úroveň Parametry Co dělá
probe_audio Zdarma url Vrací délku souboru, datový tok, formát a odhadované náklady na kredity.
convert_audio Zdarma url, format Přeenkóduje zvuk do formátů mp3, wav, flac, ogg, m4a, aac nebo opus a vrátí odkaz ke stažení.
trim_audio Zdarma url, start_seconds, duration_seconds Vystřihne část zvukového souboru a vrátí URL adresu ke stažení.
extract_audio Zdarma url Extrahuje zvukovou stopu z video souboru ve formátu MP3.
separate_audio Kredity url, task Spustí AI separaci (vokály, instrumentální stopy, hlavní vokály, stopy, odstranění šumu, odstranění dozvuku). Vrátí ID úlohy.
clone_voice Kredity url, voice, pitch? Změní hlas v zvukovém souboru na cílový hlasový identifikátor. Volitelné posunutí výšky tónu v půltónech. Vrací job_id — pro převedený zvukový soubor použijte poll check_audio_job.
check_audio_job Zdarma job_id Zkontrolujte stav úlohy separace nebo konverze hlasu a po dokončení si stáhněte výstupní soubory z uvedených odkazů.
check_balance Zdarma Zobrazuje, kolik kreditů na konverzní minuty má účet ještě k dispozici.

Nahrávání lokálních souborů

Nástroje vyžadují veřejnou URL adresu. Pokud se soubor nachází na počítači uživatele, vyvolejte bezplatný nástroj create_upload, abyste získali jednorázovou URL adresu pro nahrání, odešlete soubor metodou POST na tuto adresu (není potřeba žádný token) a poté předávejte vrácenou adresu file_url libovolnému nástroji pro práci se zvukem. Odkaz pro nahrání a soubor vyprší po 1 hodině. Nikdy nekódujte skutečný zvukový soubor do formátu base64 – je příliš velký na to, aby se vešel do argumentu nástroje.

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

Není možné odesílat webové požadavky (např. v případě asistenta v sandboxu)? Pošlete uživateli odkaz na stránku upload_page, aby soubor nahrál v prohlížeči, a poté pokračujte pomocí file_url.

V Claudovi vyžaduje nahrávání souborů odchozí síťový provoz na vocalremover.com a s3.vocalremover.com — zapněte jej v Nastavení → Funkce (viz nastavení Clauda výše).

Příklad: odstranění vokálů

Stačí se svého asistenta zeptat srozumitelným jazykem:

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

Bezplatné nástroje fungují stejným způsobem — například příkaz „převést tento soubor do formátu wav“ vyvolá funkci convert_audio a okamžitě vrátí odkaz ke stažení, aniž by došlo k odečtení kreditů.

Co vyzkoušet

  • Odstraňte vokály ze skladby „https://example.com/song.mp3“ a poskytněte mi karaoke stopu.
  • Rozdělte tuto stopu na jednotlivé stopy – zpěv, bicí, basu, kytaru a klavír.
  • Převést soubor „https://example.com/interview.m4a“ do formátu MP3 s datovým tokem 128 kbps.
  • Extrahujte pouze zvuk z tohoto videa: https://example.com/clip.mp4
  • Odstraňte šum z tohoto podcastu a potlačte ozvěnu v místnosti: https://example.com/episode.wav
  • Převedete hlas zpěváka v této skladbě na hlasový identifikátor „tenor-male“ s výškou tónu o +2 půltóny: https://example.com/song.mp3
  • Vytvořte verzi 8D a zkraťte ji na 30 sekund.
  • Jaká je délka a datový tok souboru „https://example.com/track.flac“?
  • Zkontrolujte můj zůstatek na účtu.

Omezení a poznámky

  • Vstupní soubory musí být veřejné adresy URL typu http(s) o velikosti maximálně 100 MB každý.
  • Oddělování AI probíhá asynchronně — výsledek vždy zjišťujte pomocí funkce check_audio_job.
  • Kredity se účtují za minutu zvukového záznamu, a to pouze za AI separaci.
  • Bezplatné audio nástroje nikdy nevyužívají kredity.

Ochrana osobních údajů a bezpečnost

  • Váš zvukový soubor je načten z URL adresy, kterou zadáte, zpracován a následně smazán — vaše soubory neukládáme.
  • Váš token API je vázán na váš účet; můžete jej kdykoli zrušit na stránce API.
  • Koncový bod je dostupný pouze přes HTTPS; blokujeme URL adresy, které směřují na soukromé/interní adresy.

Řešení problémů

„Vyžadováno ověření“: Chybí token nebo je nesprávná hlavička — musí být přesně Authorization: Bearer YOUR_API_TOKEN.

„Nelze stáhnout soubor“: URL adresa musí být veřejná – nesmí vyžadovat přihlášení a nesmí přesměrovávat na soukromou adresu.

Úloha separace se zdá být zaseknutá: Úlohy AI jsou asynchronní — zkontrolujte stav check_audio_job po 10–30 sekundách, dokud hodnota done nebude true.

Claude Desktop se nepřipojí: Ujistěte se, že máte nainstalovaný Node/npx a že je v proměnné PATH, použijte mcp-remote@latest a po úpravě konfigurace restartujte Clauda.

Zpět k přehledu serverů MCP