Audio MCP szerver dokumentáció

Áttekintés

A szerver a Model Context Protocolt Streamable HTTP-n keresztül továbbítja. Bármely MCP-kliens esetében irányítsa a klienst az alábbi végponthoz, és hitelesítse magát egy VocalRemover API-token segítségével. A fájlok nyilvános http(s) URL-ként kerülnek továbbításra (legfeljebb 100 MB), az eredmények pedig letölthető URL-ként kerülnek vissza.

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

Gyors útmutató

1. Szerezzen be egy ingyenes API-tokent a API-oldal.
2. Az alábbi kódrészlet segítségével adja hozzá a szervert az ügyfélhez.
3. Kérdezd meg: „Távolítsd el az énekhangot a -ből.”

Hitelesítés

1. Hozzon létre egy ingyenes fiókot, és nyissa meg a API-oldal.
2. API-token generálása.
3. Adja hozzá Bearer tokenként az MCP kliens konfigurációjához (lásd alább).

Az ingyenes hangfeldolgozó eszközök és a fizetős AI-eszközök egyaránt használják ezt a tokent; a különbség csupán abban áll, hogy felszámítják-e a konverziós percre vonatkozó krediteket.

Ügyfélbeállítás

Adja hozzá a szervert az AI-klienséhez. A Claude Desktop az mcp-remote bridge-et használja; a Cursor, a Windsurf, a Cline, a Zed és a Claude Code natívan támogatja a távoli MCP-t Bearer token segítségével; a ChatGPT és a Claude.ai webalkalmazás egyéni csatlakozóként adja hozzá, és OAuth-on keresztül jelentkezik be (lásd alább).

{
  "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 (saját ügynök létrehozása)

Csatlakoztassa a szervert egy Claude API-híváshoz az MCP-csatlakozó béta fejlécével:

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 (egyedi csatlakozó)

A ChatGPT beállításaiban engedélyezze a Fejlesztői módot, nyissa meg az Alkalmazások és csatlakozók → Létrehozás menüpontot, majd adjon hozzá egy egyéni csatlakozót, amely az alábbi szerver URL-re mutat. A ChatGPT végrehajtja az OAuth-folyamatot – jelentkezzen be a VocalRemoverbe, és engedélyezze a hozzáférést; nincs szükség token beillesztésére. (Ehhez egy egyéni csatlakozókat támogató csomagra van szükség, pl. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Nincs hozzáférésed az egyéni csatlakozókhoz a csomagodban? Hozz létre helyette egy egyéni GPT-t, és add hozzá egy műveletet, amely importálja az OpenAPI sémánkat API-kulcsos (Bearer) hitelesítéssel.

Claude (webalkalmazás, Cowork & Claude Code)

Adja hozzá a szervert egyszer egyéni csatlakozóként, majd engedélyezze a hálózati hozzáférést, hogy a Claude feltöltse és letöltse az audiofájljait.

1. Nyissa meg a Testreszabás → Csatlakozók menüpontot.
2. Kattintson a Csatlakozó hozzáadása gombra (+ gomb), majd válassza az Egyéni csatlakozó hozzáadása lehetőséget.
3. Állítsa be a nevet „VocalRemover”-re, illessze be az alábbi MCP-kiszolgáló URL-jét, majd kattintson a Hozzáadás gombra.
4. Jelentkezzen be a VocalRemoverbe, és a rendszer kérésére engedélyezze a hozzáférést — nincs szükség token beillesztésére.

https://vocalremover.com/mcp/audio

1. Nyissa meg a Beállítások → Funkciók menüpontot.
2. Kapcsolja be a Hálózati kimenet engedélyezése opciót.
3. Adja hozzá ezt a két domaint: vocalremover.com és s3.vocalremover.com

Ennyi. Indíts el egy új Chat, Cowork vagy Claude Code munkamenetet, csatolj egy hangfájlt, és mondd, hogy „remove the vocals” — a Claude feltölti a fájlt, és visszaadja az eredményt.

Az egyedi csatlakozók a Claude Pro, Max, Team és Enterprise verziókban érhetők el.

Eszközök

Helyi fájlok feltöltése

Az eszközök nyilvános URL-t fogadnak el. Ha a fájl a felhasználó számítógépén található, hívja meg az ingyenes create_upload eszközt, hogy megkapja az egyszeri feltöltési URL-t, küldje el a fájlt POST kéréssel erre az URL-re (token nem szükséges), majd adja át a visszakapott file_url értéket bármelyik audioeszköznek. A feltöltési link és a fájl 1 óra múlva lejár. Soha ne kódolja base64-be egy valódi hangfájlt — az túl nagy ahhoz, hogy eszközargumentumként használható legyen.

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

Nincs lehetőség webes kérések küldésére (pl. egy sandboxolt asszisztens esetében)? Küldje el a felhasználónak az upload_page linket, hogy a fájlt a böngészőbe helyezze, majd folytassa a file_url használatával.

A Claude-ban a fájlfeltöltéshez hálózati kimeneti forgalomra van szükség a vocalremover.com és az s3.vocalremover.com webhelyek felé — ezt a Beállítások → Képességek menüpont alatt kell engedélyezni (lásd a fenti Claude-beállításokat).

Példa: ének eltávolítása

Egyszerű nyelven kérdezze meg asszisztensét:

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

Az ingyenes eszközök ugyanúgy működnek — például a „convert this file to wav” parancs elindítja a convert_audio parancsot, és azonnal visszaad egy letöltési URL-t, anélkül, hogy krediteket használna fel.

Kipróbálandó dolgok

• ›Távolítsd el az éneket a https://example.com/song.mp3 fájlból, és küldd el nekem a karaoke-változatot.
• ›Oszd fel ezt a számot külön sávokra — ének, dob, basszusgitár, gitár és zongora.
• ›Konvertálja a „https://example.com/interview.m4a” fájlt MP3 formátumba, 128 kbps bitrátával.
• ›Kivonja csak az audiót ebből a videóból: https://example.com/clip.mp4
• ›Szűrd ki a zajt ebből a podcastból, és távolítsd el a helyiség visszhangját: https://example.com/episode.wav
• ›Konvertálja a számban szereplő énekes hangját a „tenor-male” hangazonosítóra, +2 félhangos hangmagassággal: https://example.com/song.mp3
• ›Készítsen egy 8D-s verziót, és vágja le 30 másodpercre.
• ›Mennyi az „https://example.com/track.flac” fájl hossza és bitrátája?
• ›Ellenőrizze a hitelegyenlegemet.

Korlátozások és megjegyzések

• A bemeneti fájloknak nyilvános http(s) URL-eknek kell lenniük, méretük legfeljebb 100 MB lehet.
• Az AI-elválasztás aszinkron módon fut — az eredményért mindig a check_audio_job függvényt kell lekérdezni.
• A krediteket az audio percenkénti mennyisége alapján számoljuk el, kizárólag az AI-alapú szeparáció esetében.
• Az ingyenes audioeszközök soha nem használnak krediteket.

Adatvédelem és biztonság

• Az Ön hangfájljait a megadott URL-ről töltjük le, feldolgozzuk, majd töröljük — a fájlokat nem tároljuk.
• Az API-tokenje a fiókjához van rendelve; bármikor visszavonhatja az API-oldalon.
• A végpont kizárólag HTTPS-en érhető el; blokkoljuk azokat az URL-eket, amelyek magán- vagy belső címekre mutatnak.

Hibaelhárítás

Vissza az MCP-kiszolgáló áttekintéséhez