Serveur MCP Voxdub

Créez une bande rythmo à partir d’une vidéo depuis votre agent : Claude Code, Codex, Cursor ou tout client MCP. L’agent envoie la vidéo, lance la transcription, corrige les répliques, règle le style et exporte la vidéo.

Créer un jeton d’accès

Nécessite un abonnement Voxdub actif ou un essai en cours.

Ce que fait le serveur MCP

Le serveur MCP donne à votre agent un accès direct à votre compte Voxdub. Il expose 15 outils pour piloter un projet de bout en bout.

L’agent peut envoyer une vidéo, lancer la transcription automatique avec détection des locuteurs, lire et corriger les répliques, attribuer les personnages, régler l’apparence de la bande, traduire la bande et exporter la vidéo avec la bande rythmo incrustée.

Chaque projet créé par l’agent apparaît aussi dans l’app Voxdub. Vous pouvez donc reprendre le travail à la main dans l’éditeur.

Qui peut l’utiliser

Le serveur MCP est disponible avec un abonnement Voxdub actif ou pendant un essai. L’essai dure 7 jours et demande une carte bancaire. Ensuite, l’abonnement coûte 12,99 € par mois ou 99 € par an.

Voir les offres

Obtenir un jeton d’accès

  1. Connectez-vous à Voxdub et ouvrez Réglages → Développeur.
  2. Créez un jeton d’accès personnel et donnez-lui un nom (par exemple « Claude Code »).
  3. Copiez le jeton tout de suite. Voxdub ne l’affiche qu’une seule fois.
  4. Gardez ce jeton secret, comme un mot de passe. Si vous le perdez, révoquez-le et créez-en un nouveau.

https://app-3.voxdub.com/settings?tab=developer

Configurer votre agent

Le serveur utilise le transport Streamable HTTP à l’adresse https://mcp.voxdub.com/mcp. Chaque requête envoie le jeton dans l’en-tête Authorization: Bearer <token>. Remplacez <token> par votre jeton.

Claude Code

claude mcp add --transport http voxdub https://mcp.voxdub.com/mcp \
  --header "Authorization: Bearer <token>"

Codex

# ~/.codex/config.toml
[mcp_servers.voxdub]
url = "https://mcp.voxdub.com/mcp"
bearer_token_env_var = "VOXDUB_TOKEN"

Codex lit le jeton dans la variable d’environnement VOXDUB_TOKEN. Définissez-la avant de lancer Codex :

export VOXDUB_TOKEN="<token>"

Cursor

{
  "mcpServers": {
    "voxdub": {
      "url": "https://mcp.voxdub.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VOXDUB_TOKEN}"
      }
    }
  }
}

Placez ce fichier dans .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global). Cursor lit le jeton dans la variable d’environnement VOXDUB_TOKEN.

La connexion OAuth (connecteurs claude.ai et ChatGPT) n’est pas encore disponible. Utilisez pour l’instant un client qui accepte un en-tête Authorization.

Exemple pas à pas

Vous pouvez simplement décrire le résultat à votre agent. Par exemple :

« Avec Voxdub, créez une bande rythmo pour scene.mp4 (en français, 2 personnages), corrigez les fautes, appliquez le style studio et exportez en 9:16. »

  1. 1

    Vérifier le compte

    get_account affiche votre e-mail, l’état de votre abonnement et vos limites. L’agent l’appelle en premier.

  2. 2

    Envoyer la vidéo

    create_upload prend le nom du fichier, sa taille exacte en octets, son type (video/mp4, video/quicktime ou video/x-matroska) et la langue parlée. Il renvoie une adresse put_url valable 15 minutes. L’agent envoie le fichier à cette adresse, puis appelle complete_upload, qui renvoie le project_id.

    curl -X PUT -H "Content-Type: video/mp4" \
      --upload-file scene.mp4 "<put_url>"
  3. 3

    Transcrire

    transcribe lance la transcription automatique. La langue est détectée automatiquement et la détection des locuteurs crée un personnage par voix. Vous pouvez fixer min_speakers et max_speakers (1 à 20). L’agent suit la tâche avec wait_for_job jusqu’à finished: true.

  4. 4

    Corriger les répliques

    get_project donne l’identifiant de la bande source et les personnages. list_lines lit les répliques (par pages de 200 au plus). update_lines corrige jusqu’à 100 répliques à la fois : texte, start_ms, end_ms et personnage. assign_character et update_character règlent les personnages, leurs noms et leurs couleurs.

  5. 5

    Régler le style

    set_band_style applique un préréglage (standard, large, studio, comic ou reset) ou des réglages précis : police, taille, couleur, vitesse de défilement, nombre de pistes et hauteur de bande. translate_band peut aussi créer des bandes dans 1 à 5 autres langues.

  6. 6

    Exporter

    export_video rend la vidéo avec la bande rythmo incrustée, au format 16:9, 9:16 ou carré, en 720p ou 1080p, à 24, 25, 30 ou 60 images par seconde. L’option remove_voice retire les voix d’origine.

  7. 7

    Télécharger

    Quand wait_for_job indique que l’export est terminé, get_download_url donne un lien de téléchargement valable 1 heure.

Référence des outils

OutilRôle
get_accountAffiche le compte lié au jeton, l’état de l’abonnement et les limites.
list_projectsListe vos projets, du plus récent au plus ancien, avec recherche par titre.
get_projectDonne un projet avec ses bandes (une par langue), ses personnages et son style.
create_uploadDémarre l’envoi d’une vidéo (mp4, mov ou mkv, 5 Go au plus) et renvoie une adresse d’envoi.
complete_uploadTermine l’envoi, vérifie le fichier et crée le projet.
transcribeLance la transcription automatique, avec détection de la langue et des locuteurs.
list_linesListe les répliques d’une bande, triées par temps, par pages.
update_linesModifie jusqu’à 100 répliques : texte, début, fin et personnage.
assign_characterAttribue un personnage à plusieurs répliques d’une bande en une fois.
update_characterRenomme un personnage ou change ses couleurs (texte, badge, piste).
set_band_styleChange l’apparence de la bande rythmo, avec un préréglage ou des réglages précis.
translate_bandTraduit une bande dans 1 à 5 langues. Chaque langue devient une nouvelle bande.
export_videoExporte la vidéo avec la bande rythmo incrustée (16:9, 9:16 ou carré, jusqu’en 1080p).
wait_for_jobAttend la fin d’une tâche (45 secondes au plus par appel) et renvoie son état.
get_download_urlDonne un lien de téléchargement (valable 1 heure) pour un export terminé.

Limites

  • 1 export en cours et 2 tâches ouvertes au plus en même temps par compte.
  • Vidéos de 5 Go au plus, aux formats mp4, mov ou mkv.
  • Exports jusqu’en 1080p.
  • Envoi de fichier uniquement : l’import depuis une adresse web n’est pas encore disponible.

Droits sur les vidéos

Envoyez uniquement des vidéos que vous avez le droit d’utiliser : vos propres images, des vidéos sous licence, du domaine public, ou sous licence CC BY avec crédit. Voxdub supprime les contenus qui enfreignent des droits.

Dépannage

401 UNAUTHENTICATED

Le jeton est absent, invalide, expiré ou révoqué. Vérifiez l’en-tête Authorization: Bearer <token>, ou créez un nouveau jeton.

Créer un jeton

402 SUBSCRIPTION_REQUIRED

Votre abonnement n’est pas actif. Abonnez-vous ou réactivez votre abonnement, puis relancez l’outil. Le code TRIAL_TRANSCRIPTION_LIMIT indique que les minutes de transcription de l’essai sont épuisées.

Voir les offres

409 MCP_RENDER_LIMIT_REACHED / MCP_JOB_LIMIT_REACHED

Un export ou deux tâches sont déjà en cours. Attendez la fin avec wait_for_job, puis réessayez.

429 RATE_LIMITED

Trop de requêtes. Attendez quelques secondes, puis réessayez.

Prêt à connecter votre agent ?

Créer un jeton d’accès