Documentația serverului Audio MCP

Conectați setul de instrumente audio VocalRemover la asistentul dvs. AI și începeți să editați fișiere audio folosind limbajul natural.

Prezentare generală

Serverul utilizează Protocolul de Context al Modelului (MCP) prin Streamable HTTP. Direcționați orice client MCP către punctul final de mai jos și autentificați-vă cu un token API VocalRemover. Fișierele sunt transmise sub formă de adrese URL publice http(s) (până la 100 MB), iar rezultatele sunt returnate sub formă de adrese URL care pot fi descărcate.

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

Ghid de pornire rapidă

  1. Obțineți un token API gratuit pe Pagina API.
  2. Adăugați serverul la clientul dvs. folosind fragmentul de cod de mai jos.
  3. Întreabă: „Elimină vocea din .”

Autentificare

  1. Creați un cont gratuit și deschideți Pagina API.
  2. Generați un token API.
  3. Adăugați-l ca token Bearer în configurația clientului MCP (vezi mai jos).

Atât instrumentele audio gratuite, cât și cele cu AI cu plată utilizează acest token; singura diferență constă în faptul că, în cazul celor cu AI cu plată, se percep credite pentru minutele de conversie.

Configurarea clientului

Adăugați serverul la clientul dvs. AI. Claude Desktop utilizează puntea mcp-remote; Cursor, Windsurf, Cline, Zed și Claude Code acceptă MCP la distanță în mod nativ cu un token Bearer; ChatGPT și aplicația web Claude.ai îl adaugă ca un conector personalizat și se autentifică prin OAuth (vezi mai jos).

Claude Desktop

Adăugați la claude_desktop_config.json, apoi reporniți 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

MCP la distanță nativ — adăugați-l în fișierul mcp.json al clientului.

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

Codul Claude (CLI)

O singură comandă — MCP la distanță nativ, fără bridge.

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

API-ul Anthropic Messages (creați-vă propriul agent)

Conectați serverul la un apel API Claude folosind antetul conectorului MCP 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 (conector personalizat)

În setările ChatGPT, activați modul Dezvoltator, deschideți Aplicații și conectori → Creați și adăugați un conector personalizat care să indice adresa URL a serverului de mai jos. ChatGPT execută fluxul OAuth — vă autentificați în VocalRemover și aprobați accesul; nu este necesar să inserați niciun token. (Necesită un plan cu conectori personalizați, de exemplu Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Planul dvs. nu include acces la conectorul personalizat? Creați în schimb un GPT personalizat și adăugați o acțiune care importă schema noastră OpenAPI cu autentificare prin cheie API (Bearer).

Claude (aplicație web, Cowork & Claude Code)

Adăugați serverul o singură dată ca conector personalizat, apoi permiteți accesul la rețea pentru ca Claude să poată încărca și prelua fișierele audio.

1. Adăugați conectorul
  1. Deschideți Personalizare → Conectori.
  2. Faceți clic pe „Adăugați conector” (butonul +), apoi selectați „Adăugați conector personalizat”.
  3. Setați numele la „VocalRemover”, lipiți adresa URL a serverului MCP mai jos și faceți clic pe Adăugare.
  4. Conectați-vă la VocalRemover și aprobați accesul când vi se solicită — nu este necesar să inserați niciun token.
https://vocalremover.com/mcp/audio
2. Permiteți accesul la rețea (pentru a putea încărca fișiere)
  1. Deschideți Setări → Capabilități.
  2. Activați opțiunea „Permite ieșirea din rețea”.
  3. Adăugați aceste două domenii: vocalremover.com și s3.vocalremover.com

Asta e tot. Deschide o nouă sesiune de Chat, Cowork sau Claude Code, atașează un fișier audio și spune „elimină vocea” — Claude îl încarcă și îți returnează rezultatul.

Conectorii personalizați sunt disponibili în versiunile Claude Pro, Max, Team și Enterprise.

Instrumente

Instrument Nivel Parametri Ce face
probe_audio Gratuit url Returnează durata, rata de biți, formatul și costul estimat al creditelor pentru un fișier.
convert_audio Gratuit url, format Recodifică fișierele audio în format mp3, wav, flac, ogg, m4a, aac sau opus și generează o adresă URL de descărcare.
trim_audio Gratuit url, start_seconds, duration_seconds Extrage o secțiune dintr-un fișier audio și returnează o adresă URL de descărcare.
extract_audio Gratuit url Extrageți pista audio dintr-un fișier video în format MP3.
separate_audio Credite url, task Pornește separarea AI (voce, instrumental, voce principală, piste, eliminare zgomot, eliminare reverberație). Returnează un job_id.
clone_voice Credite url, voice, pitch? Modifică vocea dintr-un fișier audio la un ID de voce țintă. Modificarea opțională a înălțimii tonului în semitonuri. Returnează un job_id — interoghează check_audio_job pentru fișierul audio convertit.
check_audio_job Gratuit job_id Interoghează o sarcină de separare sau de conversie vocală și obține adresele URL de descărcare a fișierelor de ieșire la finalizare.
check_balance Gratuit Afișează numărul de credite de minute de conversie rămase în cont.

Încărcarea fișierelor locale

Instrumentele acceptă o adresă URL publică. Dacă fișierul se află pe computerul utilizatorului, apelați instrumentul gratuit create_upload pentru a obține o adresă URL de încărcare valabilă o singură dată, trimiteți fișierul prin POST la aceasta (nu este necesar un token), apoi transmiteți adresa file_url returnată către orice instrument audio. Linkul de încărcare și fișierul expiră după 1 oră. Nu codificați niciodată un fișier audio real în format base64 — este mult prea mare pentru a fi folosit ca argument al unui instrument.

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

Nu există nicio modalitate de a efectua solicitări web (de exemplu, un asistent în mediul sandbox)? Trimiteți utilizatorului linkul upload_page pentru a încărca fișierul într-un browser, apoi continuați cu file_url.

În Claude, încărcarea fișierelor necesită acces la rețea către vocalremover.com și s3.vocalremover.com — activați această opțiune din Setări → Capacități (consultați configurarea Claude de mai sus).

Exemplu: eliminarea vocii

Adresă-te asistentului tău folosind un limbaj simplu:

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

Instrumentele gratuite funcționează în același mod — de exemplu, comanda „convert this file to wav” apelează funcția convert_audio și returnează instantaneu o adresă URL de descărcare, fără a consuma credite.

Lucruri de încercat

  • Eliminați vocea din melodia „https://example.com/song.mp3” și dați-mi pista de karaoke.
  • Împărțiți această piesă în piste separate — voce, tobe, bas, chitară și pian.
  • Convertiți fișierul „https://example.com/interview.m4a” în format MP3 la 128 kbps.
  • Extrageți doar partea audio din acest videoclip: https://example.com/clip.mp4
  • Eliminați zgomotul din acest podcast și eliminați ecoul din încăpere: https://example.com/episode.wav
  • Convertiți vocea cântărețului din această piesă la tipul de voce „tenor-masculin” cu o înălțime de +2 semitonuri: https://example.com/song.mp3
  • Realizați o versiune 8D și scurtați-o la 30 de secunde.
  • Care sunt durata și rata de biți a fișierului „https://example.com/track.flac”?
  • Verifică soldul meu de credit.

Limite și note

  • Fișierele de intrare trebuie să fie adrese URL publice de tip http(s), cu o dimensiune de până la 100 MB fiecare.
  • Separarea AI se execută asincron — verificați întotdeauna check_audio_job pentru a afla rezultatul.
  • Creditele se debitează pe minut de înregistrare audio, numai pentru separarea AI.
  • Instrumentele audio gratuite nu consumă niciodată credite.

Confidențialitate și securitate

  • Fișierele audio sunt preluate de la adresa URL pe care o furnizați, sunt procesate și apoi șterse — nu stocăm fișierele dvs.
  • Tokenul API este asociat contului dvs.; îl puteți revoca oricând de pe pagina API.
  • Punctul final acceptă numai HTTPS; blocăm adresele URL care redirecționează către adrese private/interne.

Depanare

„Este necesară autentificarea”: Tokenul lipsește sau antetul este incorect — trebuie să fie exact Authorization: Bearer YOUR_API_TOKEN.

„Nu s-a putut descărca fișierul”: Adresa URL trebuie să fie publică — fără cerințe de autentificare — și nu trebuie să redirecționeze către o adresă privată.

O sarcină de separare pare blocată: Sarcinile AI sunt asincrone — interogați check_audio_job după 10–30 de secunde până când valoarea „done” este „true”.

Claude Desktop nu se conectează: Asigurați-vă că Node/npx este instalat și se află în variabila PATH, utilizați mcp-remote@latest și reporniți complet Claude după modificarea configurației.

Înapoi la prezentarea generală a serverului MCP