Dokumentácia k serveru Audio MCP

Pripojte sadu nástrojov VocalRemover k svojmu AI asistentovi a začnite upravovať zvuk pomocou prirodzeného jazyka.

Prehľad

Server komunikuje prostredníctvom protokolu Model Context Protocol cez Streamable HTTP. Nasmerujte akéhokoľvek klienta MCP na nižšie uvedený koncový bod a overte sa pomocou tokenu API VocalRemover. Súbory sa odosielajú ako verejné URL adresy http(s) (do 100 MB) a výsledky sa vracajú ako URL adresy na stiahnutie.

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

Rýchly štart

  1. Získajte bezplatný token API na stránke Stránka API.
  2. Pridajte server do svojho klienta pomocou nižšie uvedeného úryvku kódu.
  3. Zadajte: „Odstráň vokály z .“

Overovanie

  1. Vytvorte si bezplatný účet a otvorte Stránka API.
  2. Vygenerujte token API.
  3. Pridajte ho ako token Bearer do konfigurácie vášho klienta MCP (pozri nižšie).

Tento token používajú ako bezplatné audio nástroje, tak aj platené nástroje s umelou inteligenciou; rozdiel spočíva len v tom, či sa účtujú kredity za minúty konverzie.

Nastavenie klienta

Pridajte server do svojho AI klienta. Claude Desktop používa most mcp-remote; Cursor, Windsurf, Cline, Zed a Claude Code podporujú vzdialené MCP natívne pomocou tokenu Bearer; ChatGPT a webová aplikácia Claude.ai ho pridávajú ako vlastný konektor a prihlasujú sa cez OAuth (pozri nižšie).

Claude Desktop

Pridajte do súboru claude_desktop_config.json a potom reštartujte Claude.

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

Natívny vzdialený MCP — pridajte do súboru mcp.json klienta.

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

Claude Code (CLI)

Jeden príkaz — natívne vzdialené MCP, bez mostíka.

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

API Anthropic Messages (vytvorte si vlastného agenta)

Pripojte server k volaniu rozhrania API Claude pomocou 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 nastaveniach ChatGPT aktivujte režim pre vývojárov, otvorte sekciu Aplikácie a konektory → Vytvoriť a pridajte vlastný konektor smerujúci na nižšie uvedenú URL adresu servera. ChatGPT spustí proces OAuth – prihlásite sa do služby VocalRemover a schválite prístup; nie je potrebné vkladať žiadny token. (Vyžaduje si to tarifu s vlastnými konektormi, napr. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Váš plán neumožňuje prístup k vlastnému konektoru? Vytvorte si namiesto toho vlastný GPT a pridajte akciu, ktorá importuje našu schému OpenAPI s overením pomocou API kľúča (Bearer).

Claude (webová aplikácia, Cowork & Claude Code)

Najprv pridajte server ako vlastný konektor a potom povolte sieťový prístup, aby mohol Claude nahrať a stiahnuť vaše audio súbory.

1. Pridajte konektor
  1. Otvorte Prispôsobiť → Konektory.
  2. Kliknite na Pridať konektor (tlačidlo +) a potom vyberte Pridať vlastný konektor.
  3. Nastavte názov na „VocalRemover“, vložte nižšie uvedenú URL adresu servera MCP a kliknite na Pridať.
  4. Prihláste sa do aplikácie VocalRemover a po zobrazení výzvy potvrďte prístup — nie je potrebné vkladať žiadny token.
https://vocalremover.com/mcp/audio
2. Povoliť prístup k sieti (aby bolo možné nahrať súbory)
  1. Otvorte Nastavenia → Funkcie.
  2. Zapnite možnosť Povoliť odosielanie dát zo siete.
  3. Pridajte tieto dve domény: vocalremover.com a s3.vocalremover.com

To je všetko. Spustite novú reláciu v Chate, Coworku alebo Claude Code, pripojte zvukový súbor a povedzte „odstráň vokály“ — Claude ho nahraje a vráti vám výsledok.

Vlastné konektory sú k dispozícii v verziách Claude Pro, Max, Team a Enterprise.

Nástroje

Nástroj Úroveň Parametre Čo robí
probe_audio Bezplatné url Vráti dĺžku súboru, prenosovú rýchlosť, formát a odhadované náklady na licenčné poplatky.
convert_audio Bezplatné url, format Prekóduje zvuk do formátov mp3, wav, flac, ogg, m4a, aac alebo opus a vráti URL na stiahnutie.
trim_audio Bezplatné url, start_seconds, duration_seconds Vystrihne časť zo zvukového súboru a vráti URL na stiahnutie.
extract_audio Bezplatné url Extrahuje zvukovú stopu z video súboru vo formáte MP3.
separate_audio Kredity url, task Spustí AI separáciu (spev, inštrumentál, hlavný spev, stopy, odstránenie šumu, odstránenie dozvuku). Vráti identifikátor úlohy (job_id).
clone_voice Kredity url, voice, pitch? Premení hlas v zvukovom súbore na cieľové ID hlasu. Voliteľná zmena výšky tónu v poltónoch. Vráti job_id — pre konvertovaný zvuk použite poll check_audio_job.
check_audio_job Bezplatné job_id Požiadajte o úlohu separácie alebo konverzie hlasu a po dokončení získajte URL adresy na stiahnutie výstupu.
check_balance Bezplatné Zobraziť, koľko kreditov na minúty konverzie má účet ešte k dispozícii.

Nahrávanie lokálnych súborov

Nástroje vyžadujú verejnú URL adresu. Ak sa súbor nachádza na počítači používateľa, zavolajte bezplatný nástroj create_upload, aby ste získali jednorazovú URL adresu na nahratie, odošlite súbor na ňu metódou POST (nie je potrebný žiadny token) a potom odovzdajte vrátenú adresu file_url akémukoľvek audio nástroju. Odkaz na nahratie a súbor vypršia po 1 hodine. Nikdy neprevádzajte skutočný zvukový súbor do formátu base64 — je príliš veľký na to, aby sa zmestil do argumentu nástroja.

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 je možné odoslať webové požiadavky (napr. pomocník v sandboxe)? Pošlite používateľovi odkaz upload_page, aby súbor nahral v prehliadači, a potom pokračujte s file_url.

V Claude vyžaduje nahrávanie súborov sieťový výstup na vocalremover.com a s3.vocalremover.com — zapnite ho v Nastaveniach → Funkcie (pozrite si nastavenie Claude vyššie).

Príklad: odstránenie vokálov

Stačí sa spýtať svojho asistenta jednoduchým jazykom:

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ú rovnakým spôsobom – napríklad príkaz „previesť tento súbor do formátu wav“ volá funkciu convert_audio a okamžite vráti URL na stiahnutie, pričom sa nespotrebujú žiadne kredity.

Čo vyskúšať

  • Odstráňte vokály zo skladby „https://example.com/song.mp3“ a poskytnite mi karaoke verziu.
  • Rozdeľte túto stopu na jednotlivé stopy – spev, bicie, basgitara, gitara a klavír.
  • Prekonvertujte súbor „https://example.com/interview.m4a“ do formátu MP3 s rýchlosťou prenosu 128 kbps.
  • Extrahujte iba zvuk z tohto videa: https://example.com/clip.mp4
  • Odstráňte šum z tohto podcastu a odstráňte ozvenu v miestnosti: https://example.com/episode.wav
  • Preveďte hlas speváka v tejto skladbe na hlasový identifikátor „tenor-male“ s výškou tónu +2 poltóny: https://example.com/song.mp3
  • Vytvorte verziu 8D a skráťte ju na 30 sekúnd.
  • Aká je dĺžka a prenosová rýchlosť súboru „https://example.com/track.flac“?
  • Skontrolujte môj kreditný zostatok.

Obmedzenia a poznámky

  • Vstupné súbory musia byť verejné URL adresy typu http(s), pričom veľkosť každého súboru nesmie presiahnuť 100 MB.
  • Oddelenie AI prebieha asynchrónne — výsledok vždy skontrolujte pomocou check_audio_job.
  • Kredity sa účtujú za minútu zvukového záznamu, a to iba v prípade separácie pomocou umelej inteligencie.
  • Bezplatné audio nástroje nikdy nespotrebúvajú kredity.

Ochrana súkromia a bezpečnosť

  • Vaše audio sa načíta z URL adresy, ktorú zadáte, spracuje sa a následne sa vymaže — vaše súbory neukladáme.
  • Váš token API je viazaný na váš účet; môžete ho kedykoľvek zrušiť na stránke API.
  • Koncový bod je dostupný iba cez HTTPS; blokujeme URL adresy, ktoré smerujú na súkromné/interné adresy.

Riešenie problémov

„Vyžaduje sa overenie“: Chýba token alebo je nesprávna hlavička — musí mať presne tento tvar: Authorization: Bearer YOUR_API_TOKEN.

„Súbor sa nepodarilo stiahnuť“: URL adresa musí byť verejná – nesmie vyžadovať prihlásenie a nesmie presmerovávať na súkromnú adresu.

Úloha oddelenia sa zdá byť zaseknutá: Úlohy AI sú asynchrónne — kontrolujte check_audio_job po 10–30 sekundách, kým sa hodnota done nezmení na true.

Claude Desktop sa nepripojí: Uistite sa, že máte nainštalovaný Node/npx a že je pridaný do premennej PATH, použite mcp-remote@latest a po úprave konfigurácie úplne reštartujte Claude.

Späť na prehľad serverov MCP