Server MCP
Il server MCP permette a un assistente IA di lavorare nel tuo account Evocal: inviare un video, avviare il doppiaggio, controllare e correggere i segmenti e scaricare i file. Usa la tua chiave API, con gli stessi crediti e le stesse regole dell’app.
Prima di iniziare
- Il server MCP fa parte dei piani Pro, Studio ed Enterprise, come l’API.
- Crea una chiave nell’app, in Account, API. Dai all’assistente una chiave tutta sua, così puoi revocarla senza fermare nient’altro.
- Il tuo assistente deve permetterti di aggiungere un server MCP remoto con un’intestazione. Gli agenti che lavorano in un terminale e gli editor di codice lo permettono; le app di chat che si collegano solo con un accesso all’account non possono ancora usarlo.
Collegarsi
L’indirizzo del server è https://www.evocal.app/api/mcp (Streamable HTTP). Riceve la chiave nell’intestazione Authorization. Per esempio, in Claude Code:
claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
--header "Authorization: Bearer evk_..."Gli editor che tengono i loro server in un file JSON accettano una voce come questa. Controlla nella guida del tuo editor il nome del file e la sua forma esatta.
{
"mcpServers": {
"evocal": {
"url": "https://www.evocal.app/api/mcp",
"headers": { "Authorization": "Bearer evk_..." }
}
}
}Poi chiedi, per esempio: «Doppia lesson-4.mp4 dal portoghese all’inglese, e dimmi quanto costa prima di iniziare.»
Cosa può fare l’assistente
| Strumento | Cosa fa |
|---|---|
get_account | Il piano e i crediti adesso. |
list_languages | Le coppie di lingue aperte adesso. |
list_projects | I tuoi progetti, dal più recente. |
get_project | Un progetto, con lo stato del suo file e i suoi doppiaggi. |
create_project | Crea un progetto con un doppiaggio per ogni lingua di destinazione. |
start_upload | Apre il caricamento del file e dà gli indirizzi delle prime parti. |
get_upload_part_urls | Indirizzi per altre parti, o nuovi per le parti non riuscite. |
complete_upload | Chiude il caricamento; poi il file viene controllato. |
start_dub | Avvia un doppiaggio. Consuma crediti. |
get_job | Lo stato e l’avanzamento di un job. |
get_dub | Un doppiaggio, con l’ultimo job eseguito su di esso. |
get_segments | I segmenti del doppiaggio: tempi, testi e avvisi. Può mostrare solo quelli con avvisi o modifiche. |
edit_segment | Salva un nuovo testo per un segmento. |
quote_regeneration | Quanto costa rigenerare alcuni segmenti. |
regenerate_segments | Rigenera i segmenti con i loro testi salvati. Consuma crediti. |
finish_dub | Conclude la modifica e apre i download. |
get_download_links | Link ai file del doppiaggio, validi 5 minuti. |
get_subtitles | I sottotitoli come testo, in SRT o WebVTT. |
delete_project | Elimina un progetto con i suoi file e doppiaggi. |
Inviare il file
L’assistente legge il file sul tuo computer e lo invia in parti, quindi deve girare dove si trova il file, con un terminale o l’accesso ai tuoi file. Taglia il file in parti di part_size byte e invia ognuna con un PUT al suo indirizzo.
Un assistente che non raggiunge i tuoi file può comunque lavorare sui progetti che invii nell’app: leggere i segmenti, correggerli, rigenerare e scaricare.
Crediti e sicurezza
- L’assistente consuma i tuoi crediti: un doppiaggio costa un credito per secondo di video (almeno 30), una rigenerazione i secondi dei suoi segmenti (almeno 15). Il server gli dice di comunicarti il costo e aspettare il tuo sì prima di entrambi, ma rispondi di ogni chiamata fatta con la tua chiave.
- Concludere un doppiaggio ed eliminare un progetto non si possono annullare. All’assistente viene detto di chiedertelo prima.
- Ogni file segue le stesse regole dell’app: invia solo voci che sono tue o di persone che ti hanno dato il permesso per iscritto. La conferma della voce della chiave vale per ogni file.
- Le sue chiamate contano nei limiti dell’API: 120 al minuto e 3.600 all’ora per tutto l’account.
- L’assistente vede ciò che mostra l’API: i tuoi progetti, doppiaggi, segmenti e crediti. Se la chiave trapela, revocala in Account, API.