Documentação do servidor Audio MCP

Visão geral

O servidor utiliza o Protocolo de Contexto de Modelo (MCP) sobre HTTP Streamable. Direcione qualquer cliente MCP para o endpoint abaixo e faça a autenticação com um token da API do VocalRemover. Os arquivos são enviados como URLs públicas em http(s) (até 100 MB) e os resultados são retornados 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 usando o trecho de código abaixo.
3. Pergunte: “Remova os vocais de .”

Autenticação

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

Tanto as ferramentas de áudio gratuitas quanto as ferramentas de IA pagas utilizam esse token; a única diferença é se os créditos por minuto de conversão são cobrados ou não.

Configuração do cliente

Adicione o servidor ao seu cliente de IA. O Claude Desktop usa a ponte mcp-remote; o Cursor, o Windsurf, o Cline, o Zed e o Claude Code oferecem suporte nativo ao MCP remoto com um token Bearer; o ChatGPT e o aplicativo web Claude.ai adicionam-no como um conector personalizado e fazem o login via OAuth (veja 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 seu próprio agente)

Conecte o servidor a uma chamada da API do Claude usando 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 configurações do ChatGPT, ative o modo Desenvolvedor, abra Aplicativos e Conectores → Criar e adicione um conector personalizado apontando para a URL do servidor abaixo. O ChatGPT executa o fluxo OAuth — você faz login no VocalRemover e aprova 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 ao conector personalizado no seu plano? Crie um GPT personalizado e adicione uma ação que importe nosso esquema OpenAPI com autenticação por chave de API (Bearer).

Claude (aplicativo 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 enviar e baixar seus arquivos de á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 a URL do servidor MCP abaixo e clique em Adicionar.
4. Faça login no VocalRemover e aprove o acesso quando solicitado — não é necessário colar nenhum token.

https://vocalremover.com/mcp/audio

1. Abra Configurações → Recursos.
2. Ative a opção “Permitir saída de tráfego de rede”.
3. Adicione estes dois domínios: vocalremover.com e s3.vocalremover.com

É isso aí. Comece uma nova sessão no Chat, no Cowork ou no Claude Code, anexe um arquivo de áudio e diga “remova os vocais” — o Claude faz o upload e devolve o resultado.

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

Ferramentas

Envio de arquivos locais

As ferramentas aceitam uma URL pública. Se o arquivo estiver no computador do usuário, chame a ferramenta gratuita `create_upload` para obter uma URL de envio válida por uma única vez, envie o arquivo por POST para essa URL (não é necessário token) e, em seguida, passe a `file_url` retornada para qualquer ferramenta de áudio. O link de envio e o arquivo expiram após 1 hora. Nunca codifique um arquivo de áudio real em base64 — ele é grande demais para ser usado como argumento de 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 há como fazer solicitações na web (por exemplo, um assistente em ambiente sandbox)? Envie ao usuário o link upload_page para que ele arraste o arquivo no navegador e, em seguida, continue com o file_url.

No Claude, o envio de arquivos requer acesso à rede para vocalremover.com e s3.vocalremover.com — ative essa opção em Configurações → Recursos (consulte a configuração do Claude acima).

Exemplo: remover vocais

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 maneira — por exemplo, “converter este arquivo para wav” chama a função convert_audio e retorna uma URL para download instantaneamente, sem consumir créditos.

O que experimentar

• ›Remova os vocais da música “https://example.com/song.mp3” e me forneça a faixa de karaokê.
• ›Divida esta faixa em faixas individuais — vocais, bateria, baixo, guitarra e piano.
• ›Converta o arquivo “https://example.com/interview.m4a” para MP3 a 128 kbps.
• ›Extraia apenas o áudio deste vídeo: https://example.com/clip.mp4
• ›Remova o ruído deste podcast e elimine 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 arquivo dhttps://example.com/track.flac?
• ›Verificar meu saldo de crédito.

Limites e observações

• Os arquivos de entrada devem ser URLs públicas em http(s), com tamanho máximo de 100 MB cada.
• A separação por IA é executada de forma assíncrona — sempre verifique o resultado em `check_audio_job`.
• 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

• Seu áudio é obtido a partir da URL que você fornece, processado e excluído — não armazenamos seus arquivos.
• Seu token de API está vinculado à sua conta; você pode revogá-lo a qualquer momento na página da API.
• O endpoint é exclusivamente HTTPS; bloqueamos URLs que apontam para endereços privados/internos.

Solução de problemas

Voltar à visão geral do servidor MCP