GUIA

Servidor MCP de texto para fala: dê uma voz ao seu assistente de IA

O MCP (Model Context Protocol) permite que um assistente de IA use ferramentas externas. O servidor MCP da SuperClonica dá a ele uma voz: o assistente encontra uma voz, narra seu texto e devolve um link para o arquivo de áudio.

Ele funciona com a mesma chave e o mesmo plano da API de voz da SuperClonica, então uma chave grátis basta para começar.

O que o servidor faz

O servidor fica em https://superclonica.com/mcp e oferece três ferramentas. list_voices busca entre as vozes padrão e todo o catálogo (personagens, narradores, locutores) pelo nome em qualquer idioma, tags e descrição. speak narra um texto com uma voz e devolve um link para um arquivo MP3, OGG ou WAV que vale por uma hora. get_usage mostra o plano e quantos segundos de áudio restam.

Conectar o Claude Code

Crie uma chave grátis na página da API de voz e rode um comando no terminal: claude mcp add --transport http superclonica https://superclonica.com/mcp --header "Authorization: Bearer sc_YOUR_KEY". Troque sc_YOUR_KEY pela sua chave. O Claude Code mostra as três ferramentas em /mcp, e o assistente as usa quando você pede voz.

Conectar o Cursor ou o VS Code

No Cursor, adicione o servidor em ~/.cursor/mcp.json: {"mcpServers": {"superclonica": {"url": "https://superclonica.com/mcp", "headers": {"Authorization": "Bearer sc_YOUR_KEY"}}}}. No VS Code, o arquivo é .vscode/mcp.json: {"servers": {"superclonica": {"type": "http", "url": "https://superclonica.com/mcp", "headers": {"Authorization": "Bearer sc_YOUR_KEY"}}}}. Qualquer outro cliente MCP que aceite servidores HTTP remotos com cabeçalho próprio se conecta do mesmo jeito: o endereço e o cabeçalho Authorization.

O que pedir

Peça com palavras normais, por exemplo: diga "Bem-vindo ao lado sombrio" com a voz do Darth Vader; encontre uma narradora calma e leia este parágrafo em português; quantos segundos ainda tenho hoje. A voz pode ser indicada pelo nome ou pelo id; se várias têm o mesmo nome, o assistente recebe uma lista curta para escolher. Clientes que tocam áudio podem receber o som na própria resposta.

Limites e planos

O servidor MCP faz parte dos planos da API de voz. Uma chave grátis narra 3 minutos por dia com qualquer voz do catálogo; os planos pagos começam em US$ 5 por mês por até 216 horas de áudio. Uma chamada aceita até 20.000 caracteres e, ao atingir um limite, o assistente recebe uma mensagem clara com o tempo de espera em vez de uma falha.