Menu de la documentation

Serveur MCP

Le serveur MCP permet à un assistant IA de travailler dans votre compte Evocal : envoyer une vidéo, lancer le doublage, vérifier et corriger des segments, et télécharger les fichiers. Il utilise votre clé API, avec les mêmes crédits et les mêmes règles que l’app.

Mis à jour le 20 nov. 2026

Avant de commencer

  • Le serveur MCP fait partie des formules Pro, Studio et Enterprise, comme l’API.
  • Créez une clé dans l’app, dans Compte, API. Donnez à l’assistant une clé à lui, pour pouvoir la révoquer sans rien arrêter d’autre.
  • Votre assistant doit vous permettre d’ajouter un serveur MCP distant avec un en-tête. Les agents qui travaillent dans un terminal et les éditeurs de code le permettent ; les apps de chat qui se connectent seulement en se connectant à un compte ne peuvent pas encore l’utiliser.

Se connecter

L’adresse du serveur est https://www.evocal.app/api/mcp (Streamable HTTP). Il reçoit la clé dans l’en-tête Authorization. Par exemple, dans Claude Code :

claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
  --header "Authorization: Bearer evk_..."

Les éditeurs qui gardent leurs serveurs dans un fichier JSON acceptent une entrée comme celle-ci. Consultez le guide de votre éditeur pour le nom du fichier et sa forme exacte.

{
  "mcpServers": {
    "evocal": {
      "url": "https://www.evocal.app/api/mcp",
      "headers": { "Authorization": "Bearer evk_..." }
    }
  }
}

Puis demandez, par exemple : « Double lesson-4.mp4 du portugais vers l’anglais, et dis-moi combien ça coûte avant de commencer. »

Ce que l’assistant peut faire

OutilCe qu’il fait
get_accountLa formule et les crédits maintenant.
list_languagesLes paires de langues ouvertes maintenant.
list_projectsVos projets, du plus récent au plus ancien.
get_projectUn projet, avec l’état de son fichier et ses doublages.
create_projectCrée un projet avec un doublage pour chaque langue cible.
start_uploadOuvre l’envoi du fichier et donne les adresses des premières parties.
get_upload_part_urlsDes adresses pour d’autres parties, ou de nouvelles pour les parties qui ont échoué.
complete_uploadTermine l’envoi ; le fichier est ensuite vérifié.
start_dubLance un doublage. Dépense des crédits.
get_jobL’état et l’avancement d’une tâche.
get_dubUn doublage, avec la dernière tâche lancée dessus.
get_segmentsLes segments du doublage : temps, textes et alertes. Il peut ne montrer que ceux qui ont des alertes ou des modifications.
edit_segmentEnregistre un nouveau texte pour un segment.
quote_regenerationCe que coûte la régénération de certains segments.
regenerate_segmentsRégénère des segments avec leurs textes enregistrés. Dépense des crédits.
finish_dubTermine l’édition et ouvre les téléchargements.
get_download_linksDes liens vers les fichiers du doublage, valables 5 minutes.
get_subtitlesLes sous-titres en texte, en SRT ou WebVTT.
delete_projectSupprime un projet avec ses fichiers et ses doublages.

Envoyer le fichier

L’assistant lit le fichier sur votre ordinateur et l’envoie en parties : il doit donc tourner là où se trouve le fichier, avec un terminal ou un accès à vos fichiers. Il découpe le fichier en parties de part_size octets et envoie chacune avec un PUT à son adresse.

Un assistant qui n’accède pas à vos fichiers peut quand même travailler sur les projets que vous envoyez dans l’app : lire les segments, les corriger, régénérer et télécharger.

Crédits et sécurité

  • L’assistant dépense vos crédits : un doublage coûte un crédit par seconde de vidéo (30 au minimum), une régénération les secondes de ses segments (15 au minimum). Le serveur lui demande de vous donner le coût et d’attendre votre accord avant l’un ou l’autre, mais vous répondez de chaque appel fait avec votre clé.
  • Terminer un doublage et supprimer un projet sont irréversibles. L’assistant a pour consigne de vous demander d’abord.
  • Chaque fichier suit les mêmes règles que dans l’app : n’envoyez que des voix qui sont les vôtres ou celles de personnes qui vous ont donné leur accord écrit. La confirmation de voix de la clé couvre chaque fichier.
  • Ses appels comptent dans les limites de l’API : 120 par minute et 3 600 par heure pour tout le compte.
  • L’assistant voit ce que montre l’API : vos projets, doublages, segments et crédits. Si la clé fuit, révoquez-la dans Compte, API.

À lire ensuite