Audio MCP servera dokumentācija

Pārskats

Serveris izmanto Model Context Protocol (MCP) protokolu, izmantojot Streamable HTTP. Norādiet jebkuru MCP klientu uz zemāk norādīto galapunktu un autentificējieties ar VocalRemover API žetonu. Fails tiek nosūtīts kā publisks http(s) URL (līdz 100 MB), un rezultāti tiek atgriezti kā lejupielādējami URL.

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

Ātrs sākums

1. Saņemiet bezmaksas API žetonu vietnē API lapa.
2. Pievienojiet serveri savam klientam, izmantojot zemāk redzamo koda fragmentu.
3. Lūdziet: „Noņemiet vokālu no .”

Autentifikācija

1. Izveidojiet bezmaksas kontu un atveriet API lapa.
2. Izveidojiet API žetonu.
3. Pievienojiet to kā Bearer token savā MCP klienta konfigurācijā (skatīt zemāk).

Gan bezmaksas audio rīki, gan maksas AI rīki izmanto šo žetonu; atšķirība ir tikai tajā, vai tiek iekasēti konvertēšanas minūšu kredīti.

Klienta konfigurācija

Pievienojiet serveri savam AI klientam. Claude Desktop izmanto mcp-remote tiltu; Cursor, Windsurf, Cline, Zed un Claude Code atbalsta attālo MCP nativā veidā, izmantojot Bearer tokenu; ChatGPT un Claude.ai tīmekļa lietotne to pievieno kā pielāgotu savienotāju un piesakās, izmantojot OAuth (skatīt zemāk).

{
  "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 (izveidojiet savu aģentu)

Pievienojiet serveri Claude API izsaukumam, izmantojot MCP savienotāja beta galvenes informāciju:

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 (pielāgots savienotājs)

ChatGPT iestatījumos ieslēdziet izstrādātāja režīmu, atveriet sadaļu „Apps & Connectors” → „Create” un pievienojiet pielāgotu savienotāju, norādot uz zemāk minēto servera URL. ChatGPT izmanto OAuth plūsmu — jums jāpiesakās VocalRemover un jāapstiprina piekļuve; nav nepieciešams ievietot žetonu. (Nepieciešams plāns ar pielāgotiem savienotājiem, piemēram, Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Jūsu plānā nav piekļuves pielāgotajam savienotājam? Izveidojiet pielāgotu GPT un pievienojiet darbību, kas importē mūsu OpenAPI shēmu ar API atslēgas (Bearer) autentifikāciju.

Claude (tīmekļa lietotne, Cowork & Claude Code)

Vienreiz pievienojiet serveri kā pielāgotu savienotāju, pēc tam atļaujiet tīkla piekļuvi, lai Claude varētu augšupielādēt un lejupielādēt jūsu audio failus.

1. Atveriet „Pielāgot” → „Savienotāji”.
2. Noklikšķiniet uz „Pievienot savienotāju” (poga „+”), pēc tam izvēlieties „Pievienot pielāgotu savienotāju”.
3. Iestatiet nosaukumu „VocalRemover”, ielīmējiet zemāk norādīto MCP servera URL un noklikšķiniet uz „Pievienot”.
4. Piesakieties VocalRemover un apstipriniet piekļuvi, kad tiek par to lūgts — nav nepieciešams ievietot žetonu.

https://vocalremover.com/mcp/audio

1. Atveriet Iestatījumi → Funkcijas.
2. Ieslēdziet opciju „Atļaut datu plūsmu uz ārpusi”.
3. Pievienojiet šos divus domēnus: vocalremover.com un s3.vocalremover.com

Tas ir viss. Uzsāciet jaunu tērzēšanas, Cowork vai Claude Code sesiju, pievienojiet audio failu un teiciet „izņem vokālu” — Claude to augšupielādēs un nosūtīs atpakaļ rezultātu.

Pielāgotie savienotāji ir pieejami versijās Claude Pro, Max, Team un Enterprise.

Rīki

Vietējo failu augšupielāde

Rīki pieņem publisku URL. Ja fails atrodas lietotāja datorā, izsauciet bezmaksas rīku create_upload, lai iegūtu vienreizēju augšupielādes URL, nosūtiet failu uz to ar POST pieprasījumu (token nav nepieciešams), pēc tam nododiet atgriezto file_url jebkuram audio rīkam. Augšupielādes saite un fails zaudē derīgumu pēc 1 stundas. Nekad nekonvertējiet reālu audio failu base64 formātā — tas ir pārāk liels, lai to varētu izmantot kā rīka argumentu.

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

Nav iespējams veikt tīmekļa pieprasījumus (piemēram, izmantojot izolētu palīgu)? Nosūtiet lietotājam saiti upload_page, lai viņš varētu ievietot failu pārlūkprogrammā, pēc tam turpiniet ar file_url.

Claude lietotnē failu augšupielādei ir nepieciešama tīkla izeja uz vocalremover.com un s3.vocalremover.com — to var ieslēgt sadaļā „Settings” → „Capabilities” (skatiet iepriekš minēto Claude iestatījumu aprakstu).

Piemērs: vokāla noņemšana

Vienkārši lūdziet savam palīgam vienkāršā valodā:

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

Bezmaksas rīki darbojas tāpat — piemēram, komanda „convert this file to wav” izsauc funkciju convert_audio un nekavējoties atgriež lejupielādes URL, neizmantojot kredītus.

Ko var izmēģināt

• ›No dziesmas „https://example.com/song.mp3” izņem vokālu un sagatavo man karaoke versiju.
• ›Sadaliet šo ierakstu atsevišķās daļās — vokāls, bungas, bass, ģitāra un klavieres.
• ›Konvertējiet failu „https://example.com/interview.m4a” MP3 formātā ar bitu pārraides ātrumu 128 kbps.
• ›Izgūstiet tikai audio no šī video: https://example.com/clip.mp4
• ›Noņemiet troksni no šī podkāsta un izlīdziniet telpas atbalsi: https://example.com/episode.wav
• ›Pārveidojiet šajā ierakstā dziedātāja balsi uz balss identifikatoru „tenor-male” ar +2 pustoni augstāku toņu: https://example.com/song.mp3
• ›Izveidojiet 8D versiju un saīsiniet to līdz 30 sekundēm.
• ›Kāds ir faila „https://example.com/track.flac” ilgums un bitu pārraides ātrums?
• ›Pārbaudiet manu kredīta atlikumu.

Ierobežojumi un piezīmes

• Ievades failiem jābūt publiskiem http(s) URL, katrs ne lielāks par 100 MB.
• AI atdalīšana notiek asinhroni — rezultātu vienmēr pārbaudiet, izmantojot check_audio_job.
• Kredīti tiek aprēķināti par katru audio minūti, tikai attiecībā uz AI atdalīšanu.
• Bezmaksas audio rīki nekad neizmanto kredītus.

Privātums un drošība

• Jūsu audio tiek lejupielādēts no norādītās URL adreses, apstrādāts un izdzēsts — mēs neuzglabājam jūsu failus.
• Jūsu API tokens ir saistīts ar jūsu kontu; to var atsaukt jebkurā brīdī API lapā.
• Galapunkts darbojas tikai HTTPS protokolā; mēs bloķējam URL, kas novirza uz privātām/iekšējām adresēm.

Problēmu novēršana

Atgriezties pie MCP servera pārskata