Documentação do servidor Audio MCP

Visão geral

O servidor utiliza o Protocolo de Contexto de Modelo (MCP) através de HTTP Streamable. Aponte qualquer cliente MCP para o ponto de extremidade abaixo e autentique-se com um token da API do VocalRemover. Os ficheiros são enviados como URLs http(s) públicas (até 100 MB) e os resultados são devolvidos como URLs para download.

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

Introdução rápida

1. Obtenha um token de API gratuito no Página da API.
2. Adicione o servidor ao seu cliente utilizando o fragmento de código abaixo.
3. Pergunte: «Remova as vozes de .»

Autenticação

1. Crie uma conta gratuita e abra o Página da API.
2. Gerar um token de API.
3. Adicione-o como um token Bearer na configuração do seu cliente MCP (ver abaixo).

Tanto as ferramentas de áudio gratuitas como as ferramentas de IA pagas utilizam este token; a única diferença reside no facto de serem ou não cobrados créditos por minuto de conversão.

Configuração do cliente

Adicione o servidor ao seu cliente de IA. O Claude Desktop utiliza a ponte mcp-remote; o Cursor, o Windsurf, o Cline, o Zed e o Claude Code suportam o MCP remoto de forma nativa com um token Bearer; o ChatGPT e a aplicação web Claude.ai adicionam-no como um conector personalizado e iniciam sessão através do OAuth (ver abaixo).

{
  "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 de mensagens da Anthropic (crie o seu próprio agente)

Associe o servidor a uma chamada da API do Claude com o cabeçalho do conector 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 personalizado)

Nas definições do ChatGPT, ative o modo «Desenvolvedor», abra «Aplicações e Conectores» → «Criar» e adicione um conector personalizado que aponte para o URL do servidor abaixo. O ChatGPT executa o fluxo OAuth — inicie sessão no VocalRemover e aprove o acesso; não é necessário colar nenhum token. (Requer um plano com conectores personalizados, por exemplo, Plus/Pro/Business/Enterprise.)

https://vocalremover.com/mcp/audio

Não tem acesso a conectores personalizados no seu plano? Crie, em vez disso, um GPT personalizado e adicione uma ação que importe o nosso esquema OpenAPI com autenticação por chave API (Bearer).

Claude (aplicação web, Cowork e Claude Code)

Adicione o servidor uma vez como um conector personalizado e, em seguida, permita o acesso à rede para que o Claude possa carregar e recuperar o seu áudio.

1. Abra «Personalizar» → «Conectores».
2. Clique em «Adicionar conector» (o botão +) e, em seguida, selecione «Adicionar conector personalizado».
3. Defina o nome como «VocalRemover», cole o URL do servidor MCP abaixo e clique em «Adicionar».
4. Inicie sessão no VocalRemover e aprove o acesso quando solicitado — não é necessário colar nenhum token.

https://vocalremover.com/mcp/audio

1. Abra «Definições» → «Funcionalidades».
2. Ative a opção «Permitir saída de rede».
3. Adicione estes dois domínios: vocalremover.com e s3.vocalremover.com

E pronto. Inicia uma nova sessão de Chat, Cowork ou Claude Code, anexa um ficheiro de áudio e diz «remover as vozes» — o Claude carrega o ficheiro e devolve o resultado.

Os conectores personalizados estão disponíveis nas versões Claude Pro, Max, Team e Enterprise.

Ferramentas

Carregar ficheiros locais

As ferramentas aceitam um URL público. Se o ficheiro estiver no computador do utilizador, utilize a ferramenta gratuita create_upload para obter um URL de envio único, envie o ficheiro para esse URL através de um pedido POST (não é necessário qualquer token) e, em seguida, passe o file_url devolvido para qualquer ferramenta de áudio. O link de envio e o ficheiro expiram após 1 hora. Nunca codifique um ficheiro de áudio real em base64 — é demasiado grande para ser passado como argumento a uma ferramenta.

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

Não é possível efetuar pedidos web (por exemplo, num assistente em ambiente sandbox)? Envie ao utilizador o link upload_page para que este arraste o ficheiro para o navegador e, em seguida, continue com o file_url.

No Claude, o envio de ficheiros requer acesso à rede para vocalremover.com e s3.vocalremover.com — ative-o em Definições → Funcionalidades (consulte a configuração do Claude acima).

Exemplo: remover a voz

Basta pedir ao seu assistente em linguagem simples:

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

As ferramentas gratuitas funcionam da mesma forma — por exemplo, «converter este ficheiro para wav» chama a função convert_audio e devolve instantaneamente um URL para download, sem utilizar créditos.

Coisas a experimentar

• ›Retira as vozes de «https://example.com/song.mp3» e dá-me a faixa de karaoke.
• ›Divida esta faixa em faixas individuais — voz, bateria, baixo, guitarra e piano.
• ›Converta «https://example.com/interview.m4a» para MP3 a 128 kbps.
• ›Extraia apenas o áudio deste vídeo: https://example.com/clip.mp4
• ›Elimine o ruído deste podcast e remova o eco da sala: https://example.com/episode.wav
• ›Converta a voz do cantor nesta faixa para o tipo de voz «tenor masculino» com um tom +2 semitons: https://example.com/song.mp3
• ›Crie uma versão em 8D e reduza-a para 30 segundos.
• ›Qual é a duração e a taxa de bits de um ficheiro «https://example.com/track.flac»?
• ›Verificar o meu saldo de crédito.

Limites e notas

• Os ficheiros de entrada devem ser URLs públicas http(s), com um tamanho máximo de 100 MB cada.
• A separação por IA é executada de forma assíncrona — verifique sempre o estado em `check_audio_job` para obter o resultado.
• Os créditos são cobrados por minuto de áudio, apenas para a separação por IA.
• As ferramentas de áudio gratuitas nunca utilizam créditos.

Privacidade e segurança

• O seu áudio é obtido a partir do URL que indicar, processado e eliminado — não armazenamos os seus ficheiros.
• O seu token da API está vinculado à sua conta; pode revogá-lo a qualquer momento na página da API.
• O ponto de extremidade é apenas HTTPS; bloqueamos URLs que remetem para endereços privados/internos.

Resolução de problemas

Voltar à visão geral do servidor MCP