Servidor MCP

O servidor MCP do VocalLab permite que ferramentas de IA — Claude Desktop, Claude Code, Cursor, VS Code e outras — gerem fala com a sua conta por meio do Model Context Protocol.

Assista ao tutorial completo · em inglês

Requer um plano Pro ou superior. Não é preciso ter uma chave de API antes — a configuração cria uma para você.

Configuração mais rápida (um clique)

Na página Desenvolvedor, abra Usar em ferramentas de IA (MCP). Escolha seu cliente e pressione o único botão — ele cria uma chave de API para você e conecta tudo em um passo. Não há nada para copiar nem colar.

Cliente	Botão	O que acontece
Cursor	Adicionar ao Cursor	Abre o Cursor e instala o servidor VocalLab diretamente.
VS Code	Adicionar ao VS Code	Abre o VS Code e instala o servidor diretamente.
Claude Code	Copiar comando de instalação	Copia um comando `claude mcp add …` — cole-o no seu terminal ou em um chat do Claude Code.
Claude Desktop	Baixar arquivo de configuração	Salva um `claude_desktop_config.json` pronto para usar, para colocar na sua pasta de configuração do Claude.

Sua nova chave é exibida uma única vez no aviso no topo da seção. Copie-a para um lugar seguro antes de sair da página — por segurança, não podemos mostrá-la novamente.

Prefere configurar manualmente? Cada cliente também tem botões Copiar e Baixar na pré-visualização da configuração, para colar o trecho onde quiser.

Usando o VocalLab Studio

No VocalLab Studio, abra API e MCP na barra lateral e mude para a aba MCP — mesma ideia: gere uma chave, escolha seu cliente e conecte-se. Ela também suporta Windsurf e qualquer outro cliente MCP por meio de uma configuração genérica.

Ferramentas

get_balance — seu saldo de pontos
list_voices — vozes que você pode usar
list_models — os modelos de fala (VocalLab Studio / Studio Flash / Pro / Lite)
generate_speech — texto → fala, retorna uma URL de áudio. Aceita um model opcional (v-studio, v-flash, v-pro ou v-lite)
get_speech — consultar uma geração por id: status + links de download/streaming
get_captions — legendas SRT de uma geração (linhas phrase ou word palavra por palavra)
delete_speech — excluir permanentemente uma geração que você possui
design_voice — descreva uma voz por escrito e obtenha até 3 pré-visualizações para ouvir
save_designed_voice — guarde uma pré-visualização como voz permanente para gerar
clone_voice — clone uma voz a partir de uma gravação curta (em base64)
list_voice_languages — idiomas e limites de gravação para clonagem e design
delete_voice — apague definitivamente uma das suas vozes clonadas ou criadas

Depois de conectar, peça ao seu assistente para "listar as vozes do VocalLab", "gerar fala com o VocalLab" ou "gerar isso com o modelo VocalLab Studio". Veja Modelos de voz para saber o que cada modelo faz.

Servidor hospedado

Toda opção de um clique aponta para o servidor hospedado — nada para instalar ou executar:

URL: https://mcp.vocallab.ai/mcp
Cabeçalho: Authorization: Bearer vl_live_...

Configuração manual (Claude Desktop e outros)

É exatamente o que o botão Baixar arquivo de configuração produz. Adicione isto à configuração MCP do seu cliente:

{
  "mcpServers": {
    "vocallab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vocallab.ai/mcp", "--header", "Authorization: Bearer vl_live_..."]
    }
  }
}

O arquivo de configuração do Claude Desktop fica em:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Se o arquivo já existir, mescle a entrada vocallab em mcpServers em vez de substituí-lo e, depois, reinicie o Claude Desktop.