Menu della documentazione

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.

Aggiornato il 20 nov 2026

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

StrumentoCosa fa
get_accountIl piano e i crediti adesso.
list_languagesLe coppie di lingue aperte adesso.
list_projectsI tuoi progetti, dal più recente.
get_projectUn progetto, con lo stato del suo file e i suoi doppiaggi.
create_projectCrea un progetto con un doppiaggio per ogni lingua di destinazione.
start_uploadApre il caricamento del file e dà gli indirizzi delle prime parti.
get_upload_part_urlsIndirizzi per altre parti, o nuovi per le parti non riuscite.
complete_uploadChiude il caricamento; poi il file viene controllato.
start_dubAvvia un doppiaggio. Consuma crediti.
get_jobLo stato e l’avanzamento di un job.
get_dubUn doppiaggio, con l’ultimo job eseguito su di esso.
get_segmentsI segmenti del doppiaggio: tempi, testi e avvisi. Può mostrare solo quelli con avvisi o modifiche.
edit_segmentSalva un nuovo testo per un segmento.
quote_regenerationQuanto costa rigenerare alcuni segmenti.
regenerate_segmentsRigenera i segmenti con i loro testi salvati. Consuma crediti.
finish_dubConclude la modifica e apre i download.
get_download_linksLink ai file del doppiaggio, validi 5 minuti.
get_subtitlesI sottotitoli come testo, in SRT o WebVTT.
delete_projectElimina 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.

Leggi anche