AvataReel MCP
El servidor MCP de AvataReel permite que tu asistente de IA use tu cuenta de AvataReel. Puede elegir avatares, escribir guiones, generar videos y comprar créditos, con tu confirmación.
Resumen
MCP (Model Context Protocol) es un estándar abierto que conecta asistentes de IA con aplicaciones. AvataReel ofrece un servidor MCP por HTTP. Lo conectas una vez con una clave de API personal y tu asistente obtiene las mismas funciones que usas en la app.
Inicio rápido
1. Crea una clave de API
En AvataReel, abre Configuración, busca "Asistentes de IA (MCP)", ponle nombre a la clave y créala. Cópiala enseguida: solo la mostramos una vez. Abrir Configuración
2. Agrega el servidor a tu cliente
Pega esto en la configuración MCP de tu cliente y reemplaza avr_… con tu clave.
{ "mcpServers": { "avatareel": { "type": "http", "url": "https://api.avatareel.com/mcp", "headers": { "Authorization": "Bearer avr_…" } } } }En Claude Code, ejecuta:
claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
3. Pide lo que necesites
Pide con palabras simples. El asistente elige las herramientas, muestra el precio antes de gastar créditos y te da el enlace del video cuando está listo.
Qué puedes pedir
| Tú pides | El asistente |
|---|---|
| “Haz un anuncio de 30 segundos para mi cafetería con un avatar amigable.” | Lista avatares, escribe el guion, muestra el precio, genera el video y te da el enlace de descarga. |
| “Escribe un guion a partir de esta página de producto.” | Lee la página y redacta un guion UGC y una escena. |
| “Haz tres versiones con ganchos distintos.” | Escribe nuevas aperturas y genera un video para cada una. |
| “¿Cuántos créditos tengo? Compra más.” | Muestra tu saldo y las ofertas, y te da un enlace de pago con tarjeta o un código Pix. |
| “Crea un avatar a partir de esta foto.” | Sube la foto, crea el avatar y te avisa cuando está listo. |
| “Cancela mi plan.” | Inicia la cancelación y te pregunta antes de confirmar. |
Herramientas
Estas son las herramientas que ofrece el servidor. Tu asistente las elige por ti; los nombres ayudan cuando quieres pedir una directamente.
Videos
Cotizar, crear, seguir, reintentar y compartir videos.
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
Guiones
Escribir, reescribir y traducir guiones, o empezar desde una página de producto.
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
Avatares y voces
Explorar avatares y voces, o crear un avatar a partir de una foto o una descripción.
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
Edición
Cambiar ropa y fondo, editar videos terminados y usar el editor de movimiento.
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
Lotes
Crear y descargar muchos videos a la vez. Requiere videos en lote en tu cuenta.
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
Marca y productos
Kits de marca, logos y fotos de producto guardadas.
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éditos y pago
Saldo, historial, paquetes de créditos, planes, Pix y cancelación.
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
Cuenta y ayuda
Perfil, eliminación de cuenta y soporte.
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
Créditos y pago
Los videos usan los mismos créditos que la app. El asistente pide una cotización primero y te muestra el precio antes de crear un video.
Cuando te quedas sin créditos, el asistente muestra los paquetes y planes de tu cuenta. Te da un enlace para pagar con tarjeta o un código Pix para pagar en la app de tu banco. Los créditos llegan en cuanto se confirma el pago.
Seguridad
- Tu clave de API actúa como tú, incluso para gastar créditos. Mantenla en secreto, como una contraseña.
- Revoca una clave en Configuración cuando quieras. Deja de funcionar en la siguiente solicitud.
- Los buenos asistentes preguntan antes de pagar, cancelar o eliminar. Revisa esas solicitudes antes de aprobarlas.
- Las claves de API solo acceden a funciones de cliente. No pueden crear ni revocar otras claves.
Errores
Cuando algo falla, la herramienta devuelve el estado HTTP y un mensaje. Los más comunes:
- 400
- Datos no válidos. El mensaje indica qué corregir.
- 401
- Clave de API ausente, incorrecta o revocada.
- 402
- No tienes suficientes créditos. Compra créditos e inténtalo de nuevo.
- 403
- Tu cuenta no tiene esta función.
- 429
- Demasiadas solicitudes. Espera un poco e inténtalo de nuevo.