AvataReel MCP
Le serveur MCP d'AvataReel permet à votre assistant IA d'utiliser votre compte AvataReel. Il peut choisir des avatars, écrire des scripts, générer des vidéos et acheter des crédits, avec votre accord.
Présentation
MCP (Model Context Protocol) est un standard ouvert qui relie les assistants IA aux applications. AvataReel propose un serveur MCP via HTTP. Vous le connectez une fois avec une clé API personnelle, et votre assistant obtient les mêmes fonctions que vous dans l'app.
Démarrage rapide
1. Créez une clé API
Dans AvataReel, ouvrez Paramètres, trouvez "Assistants IA (MCP)", nommez la clé et créez-la. Copiez-la tout de suite : nous ne l'affichons qu'une fois. Ouvrir les Paramètres
2. Ajoutez le serveur à votre client
Collez ceci dans la configuration MCP de votre client et remplacez avr_… par votre clé.
{ "mcpServers": { "avatareel": { "type": "http", "url": "https://api.avatareel.com/mcp", "headers": { "Authorization": "Bearer avr_…" } } } }Dans Claude Code, exécutez :
claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
3. Demandez ce dont vous avez besoin
Demandez avec des mots simples. L'assistant choisit les outils, affiche le prix avant de dépenser des crédits et vous donne le lien de la vidéo quand elle est prête.
Ce que vous pouvez demander
| Vous demandez | L'assistant |
|---|---|
| “Fais une pub de 30 secondes pour mon café avec un avatar sympathique.” | Liste les avatars, écrit le script, affiche le prix, génère la vidéo et renvoie le lien de téléchargement. |
| “Écris un script à partir de cette page produit.” | Lit la page et rédige un script UGC et une scène. |
| “Fais trois versions avec des accroches différentes.” | Écrit de nouvelles ouvertures et génère une vidéo pour chacune. |
| “Combien de crédits ai-je ? Achètes-en d'autres.” | Affiche votre solde et les offres, puis vous donne un lien de paiement par carte ou un code Pix. |
| “Crée un avatar à partir de cette photo.” | Envoie la photo, crée l'avatar et vous prévient quand il est prêt. |
| “Résilie mon abonnement.” | Lance la résiliation et vous demande avant de confirmer. |
Outils
Voici les outils proposés par le serveur. Votre assistant les choisit pour vous ; les noms aident si vous voulez en demander un directement.
Vidéos
Estimer, créer, suivre, relancer et partager des vidéos.
quote_videocreate_videowait_for_videolist_videosget_videoget_video_stepsretry_videodelete_videocreate_videos_from_briefcreate_hook_variationsgenerate_post_captioncreate_product_image_uploadcreate_character_swap_uploadcomplete_character_swap_uploadcreate_character_swap_image_uploadcomplete_character_swap_image_uploadclaim_video_guaranteeget_video_feedbacksend_video_feedbacksubmit_post_linklist_listing_imagescreate_listing_imagesregenerate_listing_image
Scripts
Écrire, réécrire et traduire des scripts, ou partir d'une page produit.
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
Avatars et voix
Parcourir avatars et voix, ou créer un avatar à partir d'une photo ou d'une description.
list_avatarsget_avatarlist_voicesget_avatar_quotacreate_avatar_photo_uploadassess_avatar_photogenerate_avatar_facecreate_avatarconfirm_avatar_likenessget_avatar_source_photoreplace_avatar_photoset_avatar_voicecreate_voice_recording_uploadmerge_voice_takesretry_avatardelete_avatar
Montage
Changer de tenue et de fond, modifier des vidéos terminées et utiliser l'éditeur de mouvement.
classify_videocheck_product_scriptsuggest_wardrobecreate_background_uploadcreate_brand_logo_uploadcreate_scene_image_uploadpreview_appearancechange_appearanceget_video_captionsedit_videoget_motion_editor_accesscreate_motion_editcreate_automatic_motion_editget_motion_editget_video_motion_editsave_motion_editdirect_motion_editadd_motion_soundtrackexport_motion_edit
Lots
Créer et télécharger de nombreuses vidéos d'un coup. Nécessite les vidéos en lot sur votre compte.
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
Marque et produits
Kits de marque, logos et photos produit enregistrées.
list_brand_kitscreate_brand_kitbrand_kit_from_briefupdate_brand_kitlist_brand_assetsgenerate_brand_assetdelete_brand_kitlist_product_assetscreate_product_asset_uploadcomplete_product_asset_upload
Crédits et paiement
Solde, historique, packs de crédits, abonnements, Pix et résiliation.
get_credit_balancelist_credit_transactionslist_unseen_refundsget_billing_offerscreate_pack_checkoutcreate_pix_chargeget_payment_orderget_subscriptioncreate_subscription_checkoutcreate_subscription_pixget_subscription_pixchange_subscriptionstart_subscription_cancelaccept_cancel_offerconfirm_subscription_cancelcreate_billing_portalget_billing_profileupdate_billing_profile
Compte et aide
Profil, suppression du compte et support.
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
Crédits et paiement
Les vidéos utilisent les mêmes crédits que l'app. L'assistant demande d'abord un devis et vous montre le prix avant de créer une vidéo.
Quand vous n'avez plus de crédits, l'assistant affiche les packs et abonnements de votre compte. Il vous donne un lien pour payer par carte ou un code Pix à payer dans l'app de votre banque. Les crédits arrivent dès que le paiement est confirmé.
Sécurité
- Votre clé API agit en votre nom, y compris pour dépenser des crédits. Gardez-la secrète, comme un mot de passe.
- Révoquez une clé dans Paramètres à tout moment. Elle cesse de fonctionner dès la requête suivante.
- Les bons assistants demandent avant de payer, résilier ou supprimer. Vérifiez ces demandes avant de les approuver.
- Les clés API n'accèdent qu'aux fonctions client. Elles ne peuvent ni créer ni révoquer d'autres clés.
Erreurs
En cas d'échec, l'outil renvoie le statut HTTP et un message. Les plus courants :
- 400
- Données non valides. Le message indique quoi corriger.
- 401
- Clé API absente, incorrecte ou révoquée.
- 402
- Crédits insuffisants. Achetez des crédits et réessayez.
- 403
- Votre compte n'a pas cette fonction.
- 429
- Trop de requêtes. Patientez un peu et réessayez.