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.
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
| Outil | Ce qu’il fait |
|---|---|
get_account | La formule et les crédits maintenant. |
list_languages | Les paires de langues ouvertes maintenant. |
list_projects | Vos projets, du plus récent au plus ancien. |
get_project | Un projet, avec l’état de son fichier et ses doublages. |
create_project | Crée un projet avec un doublage pour chaque langue cible. |
start_upload | Ouvre l’envoi du fichier et donne les adresses des premières parties. |
get_upload_part_urls | Des adresses pour d’autres parties, ou de nouvelles pour les parties qui ont échoué. |
complete_upload | Termine l’envoi ; le fichier est ensuite vérifié. |
start_dub | Lance un doublage. Dépense des crédits. |
get_job | L’état et l’avancement d’une tâche. |
get_dub | Un doublage, avec la dernière tâche lancée dessus. |
get_segments | Les segments du doublage : temps, textes et alertes. Il peut ne montrer que ceux qui ont des alertes ou des modifications. |
edit_segment | Enregistre un nouveau texte pour un segment. |
quote_regeneration | Ce que coûte la régénération de certains segments. |
regenerate_segments | Régénère des segments avec leurs textes enregistrés. Dépense des crédits. |
finish_dub | Termine l’édition et ouvre les téléchargements. |
get_download_links | Des liens vers les fichiers du doublage, valables 5 minutes. |
get_subtitles | Les sous-titres en texte, en SRT ou WebVTT. |
delete_project | Supprime 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.