Audio MCP serveri dokumentatsioon

Ülevaade

Server kasutab Model Context Protocolit Streamable HTTP kaudu. Suunake mis tahes MCP-klient allpool olevale lõpppunktile ja autentigeerige end VocalRemoveri API-tokeniga. Failid edastatakse avalikena http(s)-URL-idena (kuni 100 MB) ja tulemused saadakse tagasi allalaaditavate URL-idena.

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

Kiirjuhend

1. Hangi tasuta API-token aadressilt API-leht.
2. Lisage server oma kliendile, kasutades allpool olevat koodijuppi.
3. Küsi: „Eemalda vokaal -ist.”

Autentimine

1. Loo tasuta konto ja ava API-leht.
2. Loo API-token.
3. Lisage see oma MCP-kliendi konfiguratsioonis Bearer-tokenina (vt allpool).

Nii tasuta audio- kui ka tasulised AI-tööriistad kasutavad seda tokenit; erinevus seisneb vaid selles, kas konverteerimisminutite eest võetakse tasu.

Kliendi seadistamine

Lisa server oma AI-kliendisse. Claude Desktop kasutab mcp-remote-silda; Cursor, Windsurf, Cline, Zed ja Claude Code toetavad kaug-MCP-d natiivselt Bearer-tokeniga; ChatGPT ja Claude.ai veebirakendus lisavad selle kohandatud ühendusena ja logivad sisse OAuthi kaudu (vaata allpool).

{
  "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 (luua oma agent)

Ühenda server Claude API-kõnega, kasutades MCP-ühenduse beetaversiooni päist:

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 (kohandatud ühendus)

Lülita ChatGPT-i seadetes sisse arendaja režiim, ava „Rakendused ja ühendused“ → „Loo“ ning lisa kohandatud ühendus, mis viitab allpool olevale serveri URL-ile. ChatGPT käivitab OAuth-protsessi – logi sisse VocalRemoverisse ja kinnita juurdepääs; tokenit pole vaja kleepida. (Nõuab paketti, mis sisaldab kohandatud ühendajaid, nt Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Kas teie paketis puudub juurdepääs kohandatud ühendusele? Looge selle asemel kohandatud GPT ja lisage tegevus, mis impordib meie OpenAPI skeemi API-võtme (Bearer) autentimisega.

Claude (veebirakendus, Cowork & Claude Code)

Lisage server üks kord kohandatud ühendusena ja lubage seejärel võrgule juurdepääs, et Claude saaks teie audiofailid üles laadida ja alla laadida.

1. Avage „Kohandamine“ → „Ühendused“.
2. Klõpsake nuppu „Lisa ühendus“ (+), seejärel valige „Lisa kohandatud ühendus“.
3. Määrake nimeks „VocalRemover”, kleepige allpool olev MCP-serveri URL ja klõpsake nuppu „Lisa”.
4. Logi sisse VocalRemoverisse ja kinnita juurdepääs, kui seda palutakse — tokenit pole vaja kleepida.

https://vocalremover.com/mcp/audio

1. Ava Seaded → Võimalused.
2. Lülita sisse „Luba võrgust väljaminek”.
3. Lisa need kaks domeeni: vocalremover.com ja s3.vocalremover.com

See ongi kõik. Alusta uus vestlus, Cowork või Claude Code seanss, lisa helifail ja ütle „eemalda vokaal“ — Claude laadib selle üles ja annab tulemuse tagasi.

Kohandatud ühendused on saadaval versioonides Claude Pro, Max, Team ja Enterprise.

Tööriistad

Kohalike failide üleslaadimine

Tööriistad võtavad vastu avalikku URL-i. Kui fail asub kasutaja arvutis, kasuta tasuta tööriista create_upload, et saada ühekordne üleslaadimis-URL, saada fail sinna POST-meetodiga (tokenit ei ole vaja) ja edasta seejärel tagastatud file_url mis tahes audio-tööriistale. Üleslaadimislingi ja faili kehtivusaeg lõpeb 1 tunni pärast. Ära kunagi kodeeri päris helifaili base64-koodiks — see on tööriista argumendiks liiga suur.

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

Kas veebipäringuid ei ole võimalik teha (nt sandbox-keskkonnas töötav assistent)? Saada kasutajale link upload_page, et ta saaks faili brauserisse lohistada, ja jätka seejärel file_url-iga.

Claude'is vajab failide üleslaadimine võrguväljundit aadressidele vocalremover.com ja s3.vocalremover.com — lülita see sisse menüüs Seaded → Võimalused (vaata eespool toodud Claude'i seadistust).

Näide: vokaali eemaldamine

Lihtsalt küsi oma assistendilt lihtsas keeles:

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

Tasuta tööriistad toimivad samamoodi — näiteks käsk „convert this file to wav” kutsub välja funktsiooni convert_audio ja tagastab kohe allalaadimislingi, ilma et krediite kulutataks.

Proovida tasub

• ›Eemalda laul „https://example.com/song.mp3” laulupartiid ja anna mulle karaoke-lugu.
• ›Jaga see lugu osadeks – vokaal, trummid, bass, kitarr ja klaver.
• ›Muuda fail „https://example.com/interview.m4a” MP3-vormingusse kiirusega 128 kbps.
• ›Eralda sellest videost ainult heli: https://example.com/clip.mp4
• ›Eemalda sellest podcastist müra ja ruumi kaja: https://example.com/episode.wav
• ›Muuda selle loo laulja hääl hääletüübiks „tenor-male” ja tõsta helitugevust +2 pooltooni võrra: https://example.com/song.mp3
• ›Tee 8D-versioon ja lõika see 30 sekundini.
• ›Milline on faili „https://example.com/track.flac” kestus ja bitikiirus?
• ›Kontrolli minu krediidisaldot.

Piirangud ja märkused

• Sisendfailid peavad olema avalikud http(s)-URL-id, igaühe suurus kuni 100 MB.
• AI eraldamine toimub asünkroonselt — tulemuse saamiseks kontrollige alati check_audio_job'i.
• Krediite arvestatakse audio minuti kohta, ainult AI-eraldamise puhul.
• Tasuta helitöötlusvahendid ei kasuta kunagi krediite.

Privaatsus ja turvalisus

• Teie audio laaditakse alla teie poolt edastatud URL-aadressilt, töödeldakse ja kustutatakse — me ei säilita teie faile.
• Teie API-token kehtib ainult teie kontole; võite selle igal ajal API-lehelt tühistada.
• Lõpppunkt toetab ainult HTTPS-i; blokeerime URL-aadresse, mis viivad privaatsetele/sisemistele aadressidele.

Vigade kõrvaldamine

Tagasi MCP-serveri ülevaate juurde