Documentazione sul server Audio MCP

Panoramica

Il server utilizza il Model Context Protocol su Streamable HTTP. Indirizza qualsiasi client MCP all'endpoint riportato di seguito ed effettua l'autenticazione con un token API VocalRemover. I file vengono trasmessi come URL http(s) pubblici (fino a 100 MB) e i risultati vengono restituiti come URL scaricabili.

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

Guida rapida

1. Ottieni un token API gratuito su Pagina dell'API.
2. Aggiungi il server al tuo client utilizzando lo snippet riportato di seguito.
3. Chiedi: "Rimuovi la voce da ."

Autenticazione

1. Crea un account gratuito e apri il Pagina dell'API.
2. Generare un token API.
3. Aggiungilo come token Bearer nella configurazione del tuo client MCP (vedi sotto).

Sia gli strumenti audio gratuiti che quelli a pagamento basati sull'intelligenza artificiale utilizzano questo token; l'unica differenza consiste nel fatto che, nel caso degli strumenti a pagamento, vengono addebitati crediti per i minuti di conversione.

Configurazione del client

Aggiungi il server al tuo client AI. Claude Desktop utilizza il bridge mcp-remote; Cursor, Windsurf, Cline, Zed e Claude Code supportano nativamente l'MCP remoto con un token Bearer; ChatGPT e l'app web Claude.ai lo aggiungono come connettore personalizzato ed effettuano l'accesso tramite OAuth (vedi sotto).

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

API Anthropic Messages (crea il tuo agente)

Collega il server a una chiamata API Claude utilizzando l'intestazione del connettore 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 (connettore personalizzato)

Nelle impostazioni di ChatGPT, abilita la modalità Sviluppatore, apri App e connettori → Crea e aggiungi un connettore personalizzato che punti all'URL del server riportato di seguito. ChatGPT esegue il flusso OAuth: accedi a VocalRemover e approva l'accesso; non è necessario incollare alcun token. (Richiede un piano con connettori personalizzati, ad esempio Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Il tuo piano non prevede l'accesso ai connettori personalizzati? Crea invece un GPT personalizzato e aggiungi un'azione che importi il nostro schema OpenAPI con autenticazione tramite chiave API (Bearer).

Claude (app web, Cowork e Claude Code)

Aggiungi il server una volta come connettore personalizzato, quindi consenti l'accesso alla rete in modo che Claude possa caricare e recuperare i tuoi file audio.

1. Apri Personalizza → Connettori.
2. Fare clic su "Aggiungi connettore" (il pulsante +), quindi selezionare "Aggiungi connettore personalizzato".
3. Impostare il nome su "VocalRemover", incollare l'URL del server MCP qui sotto e fare clic su Aggiungi.
4. Accedi a VocalRemover e approva l'accesso quando richiesto — non è necessario incollare alcun token.

https://vocalremover.com/mcp/audio

1. Apri Impostazioni → Funzionalità.
2. Attiva l'opzione Consenti uscita dalla rete.
3. Aggiungi questi due domini: vocalremover.com e s3.vocalremover.com

Ecco fatto. Avvia una nuova sessione di Chat, Cowork o Claude Code, allega un file audio e dì "rimuovi la voce": Claude lo carica e ti restituisce il risultato.

I connettori personalizzati sono disponibili su Claude Pro, Max, Team ed Enterprise.

Strumenti

Caricamento di file locali

Gli strumenti richiedono un URL pubblico. Se il file si trova sul computer dell'utente, chiama lo strumento gratuito create_upload per ottenere un URL di caricamento monouso, invia il file tramite POST a tale URL (non è necessario alcun token), quindi passa il file_url restituito a qualsiasi strumento audio. Il link di caricamento e il file scadono dopo 1 ora. Non convertire mai un file audio reale in base64: è troppo grande per essere passato come argomento a uno strumento.

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

Non è possibile effettuare richieste web (ad esempio, un assistente in modalità sandbox)? Invia all'utente il link upload_page per trascinare il file nel browser, quindi procedi con file_url.

In Claude, il caricamento dei file richiede un accesso in uscita alla rete verso vocalremover.com e s3.vocalremover.com — abilitalo in Impostazioni → Funzionalità (vedi la configurazione di Claude sopra).

Esempio: rimuovere le voci

Basta chiedere al proprio assistente in un linguaggio semplice:

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

Gli strumenti gratuiti funzionano allo stesso modo: ad esempio, il comando "converti questo file in wav" richiama convert_audio e restituisce immediatamente un URL per il download, senza utilizzare alcun credito.

Cose da provare

• ›Rimuovi la voce da https://example.com/song.mp3 e forniscimi la traccia karaoke.
• ›Suddividi questa traccia in tracce separate: voce, batteria, basso, chitarra e pianoforte.
• ›Converti il file "https://example.com/interview.m4a" in formato MP3 a 128 kbps.
• ›Estrai solo l'audio da questo video: https://example.com/clip.mp4
• ›Riduci il rumore di questo podcast ed elimina l'eco della stanza: https://example.com/episode.wav
• ›Converti la voce del cantante in questa traccia nell'ID voce "tenore-maschile" con un'intonazione di +2 semitoni: https://example.com/song.mp3
• ›Realizza una versione 8D e riducila a 30 secondi.
• ›Qual è la durata e il bitrate di unhttps://example.com/track.flac?
• ›Controlla il mio saldo a credito.

Limiti e note

• I file di input devono essere URL http(s) pubblici, con una dimensione massima di 100 MB ciascuno.
• La separazione AI viene eseguita in modo asincrono: verificare sempre il risultato tramite check_audio_job.
• I crediti vengono addebitati al minuto di audio, solo per la separazione tramite IA.
• Gli strumenti audio gratuiti non utilizzano mai crediti.

Privacy e sicurezza

• I tuoi file audio vengono recuperati dall'URL che ci fornisci, elaborati e poi eliminati: non conserviamo i tuoi file.
• Il tuo token API è associato al tuo account; puoi revocarlo in qualsiasi momento dalla pagina API.
• L'endpoint è solo HTTPS; blocchiamo gli URL che rimandano a indirizzi privati/interni.

Risoluzione dei problemi

Torna alla panoramica del server MCP