Vai al contenuto principale
Youka ha un server MCP. MCP (Model Context Protocol) è lo standard con cui gli assistenti AI si collegano a strumenti esterni. Una volta connesso, puoi chiedere al tuo assistente cose come “crea un video karaoke di ~/Music/song.mp3” e lui crea il progetto nel tuo account Youka, aspetta che finisca e ti fornisce il link all’editor o un link per il download. Il server funziona con qualsiasi client MCP che supporti server remoti (Streamable HTTP) con un header personalizzato, come Claude Code, Cursor e Codex.
Le app ufficiali Youka per ChatGPT e Claude arriveranno presto. Nel frattempo, usa un client da questa pagina con una chiave API Youka.

Cosa ti serve

Dettagli del server:
La tua chiave API dà accesso completo al tuo account Youka e ai suoi crediti. Tienila fuori da file e repository condivisi. Se una chiave viene compromessa, eliminala nella pagina del tuo account e creane una nuova.

Collega il tuo assistente

Esegui questo nel terminale, sostituendo YOUR_API_KEY con la tua chiave:
Verifica che si sia connesso:
Dovresti vedere youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.Per impostazione predefinita, il server viene aggiunto solo per la cartella corrente. Aggiungi --scope user per usare Youka in ogni cartella.

Provalo

Chiedi al tuo assistente in linguaggio naturale. Per esempio:
Una tipica richiesta karaoke segue questo flusso:
1

Upload

L’assistente chiede a Youka un link di caricamento e carica il tuo file. Il caricamento è gratuito.
2

Check the cost

Controlla quanti crediti userà il progetto e li confronta con il tuo saldo.
3

Create the project

Youka rimuove la voce e sincronizza il testo. Questo richiede alcuni minuti. L’ assistente controlla lo stato finché il progetto non è pronto.
4

Edit or export

Ottieni un link per aprire il progetto nell’editor Youka. Se chiedi il file video, l’assistente lo esporta e ti fornisce un link per il download.
La creazione di un progetto non esegue mai il rendering di un video da sola. Decidi tu quando esportare, così puoi prima correggere il testo o lo stile, sia in chat sia nell’editor Youka.

Cosa può fare l’assistente

Crediti e sicurezza

  • Stessi crediti della web app. Creare un progetto, risincronizzare il testo ed esportare costa come su online.youka.io.
  • Il costo viene controllato prima. Se non hai abbastanza crediti, Youka rifiuta la richiesta e lo segnala. Non viene addebitato nulla.
  • Nessun doppio addebito. Se l’assistente ritenta una richiesta dopo un timeout, Youka riconosce il tentativo e restituisce il risultato originale invece di addebitare di nuovo.
  • I crediti si acquistano su Youka. L’assistente non può acquistare crediti. Per aggiungerne altri, vedi Buy more credits.
  • Gli strumenti a pagamento vengono eseguiti solo quando lo chiedi. All’assistente viene indicato di creare progetti, sincronizzare il testo o esportare solo quando lo richiedi.

Risoluzione dei problemi

La chiave API manca o non è valida. Verifica che l’header sia esattamente Authorization: Bearer yk_..., con uno spazio dopo Bearer e senza spazi extra o virgolette dentro la chiave. Se hai eliminato la chiave nella pagina del tuo account, creane una nuova e aggiorna il tuo client. Per le configurazioni Codex e Cursor che leggono YOUKA_API_KEY, assicurati che la variabile sia impostata nell’ambiente da cui l’app viene avviata.
Chiedi all’assistente il tuo saldo, oppure controllalo su online.youka.io. Poi buy more credits e riprova.
Chiedi all’assistente di mostrarti il progetto. Include l’errore. Assicurati che il file sia un file audio o video supportato entro i limiti di upload mostrati dal tuo account.
Comunica all’assistente il testo corretto e chiedigli di sincronizzarlo di nuovo, oppure apri il link dell’editor e modifica il testo tu stesso. Poi esporta di nuovo.

Documentazione correlata