Server MCP

Il server MCP di VocalLab permette agli strumenti AI — Claude Desktop, Claude Code, Cursor, VS Code e altri — di generare audio vocale con il tuo account tramite il Model Context Protocol.

Guarda il tutorial completo · in inglese

Richiede un piano Pro o superiore. Non serve una chiave API in anticipo — la configurazione ne crea una per te.

Configurazione più rapida (un clic)

Nella pagina Sviluppatore, apri Usa negli strumenti AI (MCP). Scegli il tuo client e premi l'unico pulsante: crea una chiave API per te e collega tutto in un solo passaggio. Non c'è nulla da copiare o incollare.

Client	Pulsante	Cosa succede
Cursor	Aggiungi a Cursor	Apre Cursor e installa il server VocalLab direttamente.
VS Code	Aggiungi a VS Code	Apre VS Code e installa il server direttamente.
Claude Code	Copia comando di installazione	Copia un comando `claude mcp add …` — incollalo nel terminale o in una chat di Claude Code.
Claude Desktop	Scarica file di configurazione	Salva un `claude_desktop_config.json` pronto all'uso da mettere nella cartella di configurazione di Claude.

La tua nuova chiave viene mostrata una sola volta nel banner in alto alla sezione. Copiala in un posto sicuro prima di lasciare la pagina — per sicurezza non possiamo mostrarla di nuovo.

Preferisci configurarlo a mano? Ogni client ha anche i pulsanti Copia e Scarica nell'anteprima della configurazione, così puoi incollare lo snippet dove preferisci.

Usare VocalLab Studio

In VocalLab Studio, apri API e MCP nella barra laterale e passa alla scheda MCP — stessa logica: genera una chiave, scegli il client, poi connettiti. Supporta anche Windsurf e qualsiasi altro client MCP tramite una configurazione generica.

Strumenti

get_balance — il saldo dei tuoi punti
list_voices — le voci che puoi usare
list_models — i modelli vocali (VocalLab Studio / Studio Flash / Pro / Lite)
generate_speech — testo → audio vocale, restituisce un URL audio. Accetta un model opzionale (v-studio, v-flash, v-pro o v-lite)
get_speech — consultare una generazione per id: stato + link di download/streaming
get_captions — sottotitoli SRT di una generazione (righe phrase o word parola per parola)
delete_speech — eliminare definitivamente una generazione di tua proprietà
design_voice — descrivi una voce a parole e ottieni fino a 3 anteprime da ascoltare
save_designed_voice — conserva un'anteprima come voce permanente con cui generare
clone_voice — clona una voce da una breve registrazione (in base64)
list_voice_languages — lingue e limiti di registrazione per clonazione e design
delete_voice — elimina definitivamente una delle tue voci clonate o progettate

Una volta connesso, chiedi al tuo assistente di "elencare le voci di VocalLab", "generare audio vocale con VocalLab" o "generarlo con il modello VocalLab Studio". Vedi Modelli vocali per cosa fa ciascun modello.

Server ospitato

Ogni opzione a un clic punta al server ospitato — niente da installare o eseguire:

URL: https://mcp.vocallab.ai/mcp
Header: Authorization: Bearer vl_live_...

Configurazione manuale (Claude Desktop e altri)

È esattamente ciò che produce il pulsante Scarica file di configurazione. Aggiungilo alla configurazione MCP del tuo client:

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

Il file di configurazione di Claude Desktop si trova qui:

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

Se il file esiste già, unisci la voce vocallab sotto mcpServers invece di sostituirlo, poi riavvia Claude Desktop.