Audio MCP -palvelimen dokumentaatio

Yleiskatsaus

Palvelin käyttää Model Context Protocol -protokollaa Streamable HTTP:n kautta. Ohjaa mikä tahansa MCP-asiakasohjelma alla olevaan päätepisteeseen ja todenna itsesi VocalRemover-API-tunnuksella. Tiedostot lähetetään julkisina http(s)-URL-osoitteina (enintään 100 Mt) ja tulokset palautetaan ladattavina URL-osoitteina.

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

Pikaopas

1. Hanki ilmainen API-tunnus osoitteesta API-sivu.
2. Lisää palvelin asiakkaaseesi alla olevan koodinpätkän avulla.
3. Kysy: "Poista laulu :sta."

Todentaminen

1. Luo ilmainen tili ja avaa API-sivu.
2. Luo API-tunnus.
3. Lisää se Bearer-tunnukseksi MCP-asiakasohjelman asetuksiin (katso alla).

Sekä ilmaiset äänityökalut että maksulliset tekoälytyökalut käyttävät tätä tunnusta; ainoa ero on siinä, veloitetaanko muuntominuuttikrediittejä.

Asiakkaan asetukset

Lisää palvelin AI-asiakasohjelmaasi. Claude Desktop käyttää mcp-remote-siltaa; Cursor, Windsurf, Cline, Zed ja Claude Code tukevat etä-MCP:tä natiivisti Bearer-tunnuksen avulla; ChatGPT ja Claude.ai-verkkosovellus lisäävät sen mukautettuna liittimenä ja kirjautuvat sisään OAuthin kautta (katso alla).

{
  "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 (rakenna oma agenttisi)

Liitä palvelin Claude-API-kutsuun MCP-liittimen beta-otsikolla:

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 (mukautettu liitin)

Ota ChatGPT-asetuksissa käyttöön kehittäjätila, avaa Sovellukset ja liittimet → Luo ja lisää mukautettu liitin, joka osoittaa alla olevaan palvelimen URL-osoitteeseen. ChatGPT suorittaa OAuth-prosessin — kirjaudut VocalRemoveriin ja hyväksyt käyttöoikeuden; tokenia ei tarvitse liittää. (Vaatii tilauksen, johon sisältyy mukautetut liittimet, esim. Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Eikö tilauksessasi ole Custom-connector-käyttöoikeutta? Luo sen sijaan Custom GPT ja lisää toiminto, joka tuo OpenAPI-skeemamme API-avaimen (Bearer) todennuksella.

Claude (verkkosovellus, Cowork & Claude Code)

Lisää palvelin kerran mukautettuna liittimenä ja salli sitten verkkoyhteys, jotta Claude voi ladata ja hakea äänitiedostojasi.

1. Avaa Mukauta → Liittimet.
2. Napsauta Lisää liitin (+-painike) ja valitse sitten Lisää mukautettu liitin.
3. Aseta nimeksi "VocalRemover", liitä MCP-palvelimen URL-osoite alla olevaan kenttään ja napsauta Lisää.
4. Kirjaudu sisään VocalRemoveriin ja hyväksy käyttöoikeus, kun sitä pyydetään — tunnusta ei tarvitse liittää.

https://vocalremover.com/mcp/audio

1. Avaa Asetukset → Ominaisuudet.
2. Ota käyttöön Salli verkosta lähtevä liikenne.
3. Lisää nämä kaksi verkkotunnusta: vocalremover.com ja s3.vocalremover.com

Siinä se. Aloita uusi Chat-, Cowork- tai Claude Code -istunto, liitä äänitiedosto ja sano "poista laulu" — Claude lataa sen ja palauttaa tuloksen.

Mukautetut liittimet ovat käytettävissä Claude Pro-, Max-, Team- ja Enterprise-versioissa.

Työkalut

Paikallisten tiedostojen lataaminen

Työkalut vaativat julkisen URL-osoitteen. Jos tiedosto sijaitsee käyttäjän koneella, kutsu ilmaista create_upload-työkalua saadaksesi kertakäyttöisen lataus-URL-osoitteen, lähetä tiedosto sinne POST-pyynnöllä (tunnusta ei tarvita) ja välitä sitten palautettu file_url-osoite mihin tahansa äänityökaluun. Latauslinkki ja tiedosto vanhenevat 1 tunnin kuluttua. Älä koskaan koodaa todellista äänitiedostoa base64-muotoon — se on aivan liian suuri työkalun argumentiksi.

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

Eikö verkkopyyntöjä voi tehdä (esim. hiekkalaatikkotilassa toimiva avustaja)? Lähetä käyttäjälle upload_page-linkki, jotta hän voi pudottaa tiedoston selaimeen, ja jatka sitten file_url-linkillä.

Claudessa tiedostojen lähetys vaatii verkko-ulostulon osoitteisiin vocalremover.com ja s3.vocalremover.com — ota se käyttöön kohdassa Asetukset → Ominaisuudet (katso yllä oleva Claude-asetusten ohje).

Esimerkki: laulun poistaminen

Kysy avustajaltasi selkeällä kielellä:

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

Ilmaiset työkalut toimivat samalla tavalla — esimerkiksi komento "convert this file to wav" kutsuu convert_audio-toiminnon ja palauttaa latauslinkin välittömästi ilman, että krediittejä kuluu.

Kokeiltavia asioita

• ›Poista laulu kappaleesta https://example.com/song.mp3 ja anna minulle karaokeversio.
• ›Jaa tämä raita osiin — laulu, rummut, basso, kitara ja piano.
• ›Muunna tiedosto https://example.com/interview.m4a MP3-muotoon 128 kbps:n bittinopeudella.
• ›Pura vain ääni tästä videosta: https://example.com/clip.mp4
• ›Poista tämän podcastin kohina ja huoneen kaiku: https://example.com/episode.wav
• ›Muunna tämän kappaleen laulajan ääni äänen tunnukselle "tenor-male" ja korota sävelkorkeutta +2 puolisävelaskelta: https://example.com/song.mp3
• ›Tee 8D-versio ja lyhennä se 30 sekuntiin.
• ›Mikä on https://example.com/track.flac -tiedoston kesto ja bittinopeus?
• ›Tarkista luottosaldoni.

Rajoitukset ja huomautukset

• Syöttötiedostojen on oltava julkisia http(s)-URL-osoitteita, joiden koko on enintään 100 Mt kukin.
• AI-erottelu suoritetaan asynkronisesti — tarkista tulos aina check_audio_job-funktiosta.
• Krediittejä veloitetaan äänen minuuttikohtaisesti, ainoastaan tekoälypohjaisen erottelun osalta.
• Ilmaiset äänityökalut eivät koskaan käytä krediittejä.

Tietosuoja ja turvallisuus

• Äänitiedostosi haetaan antamastasi URL-osoitteesta, käsitellään ja poistetaan — emme tallenna tiedostojasi.
• API-tunnuksesi on sidottu tiliisi; voit peruuttaa sen milloin tahansa API-sivulta.
• Päätepiste toimii vain HTTPS-yhteydellä; estämme URL-osoitteet, jotka johtavat yksityisiin tai sisäisiin osoitteisiin.

Vianmääritys

Takaisin MCP-palvelimen yleiskatsaukseen