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.
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
Dentro do workspace do VocalLab Studio, use sua própria página de 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 pontoslist_voices— vozes que você pode usarlist_models— os modelos de fala (VocalLab Studio / Pro / Lite)generate_speech— texto → fala, retorna uma URL de áudio. Aceita ummodelopcional (v-studio,v-proouv-lite)
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.


