AvataReel MCP
Il server MCP di AvataReel permette al tuo assistente IA di usare il tuo account AvataReel. Può scegliere avatar, scrivere script, generare video e acquistare crediti, con la tua conferma.
Panoramica
MCP (Model Context Protocol) è uno standard aperto che collega gli assistenti IA alle app. AvataReel offre un server MCP via HTTP. Lo colleghi una volta con una chiave API personale e il tuo assistente ottiene le stesse funzioni che usi nell'app.
Guida rapida
1. Crea una chiave API
In AvataReel, apri Impostazioni, trova "Assistenti IA (MCP)", dai un nome alla chiave e creala. Copiala subito: la mostriamo una sola volta. Apri Impostazioni
2. Aggiungi il server al tuo client
Incolla questo nella configurazione MCP del tuo client e sostituisci avr_… con la tua chiave.
{ "mcpServers": { "avatareel": { "type": "http", "url": "https://api.avatareel.com/mcp", "headers": { "Authorization": "Bearer avr_…" } } } }In Claude Code, esegui:
claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
3. Chiedi ciò che ti serve
Chiedi con parole semplici. L'assistente sceglie gli strumenti, mostra il prezzo prima di spendere crediti e ti dà il link del video quando è pronto.
Cosa puoi chiedere
| Tu chiedi | L'assistente |
|---|---|
| “Crea uno spot di 30 secondi per il mio bar con un avatar simpatico.” | Elenca gli avatar, scrive lo script, mostra il prezzo, genera il video e restituisce il link per il download. |
| “Scrivi uno script partendo da questa pagina prodotto.” | Legge la pagina e prepara uno script UGC e una scena. |
| “Crea tre versioni con hook diversi.” | Scrive nuove aperture e genera un video per ciascuna. |
| “Quanti crediti ho? Comprane altri.” | Mostra il tuo saldo e le offerte, poi ti dà un link di pagamento con carta o un codice Pix. |
| “Crea un avatar da questa foto.” | Carica la foto, crea l'avatar e ti avvisa quando è pronto. |
| “Annulla il mio piano.” | Avvia l'annullamento e ti chiede conferma prima di procedere. |
Strumenti
Questi sono gli strumenti offerti dal server. Il tuo assistente li sceglie per te; i nomi aiutano quando vuoi chiederne uno direttamente.
Video
Preventivare, creare, seguire, riprovare e condividere video.
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
Script
Scrivere, riscrivere e tradurre script, o partire da una pagina prodotto.
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
Avatar e voci
Sfogliare avatar e voci, o creare un avatar da una foto o una descrizione.
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
Modifica
Cambiare abito e sfondo, modificare video finiti e usare l'editor di movimento.
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
Lotti
Creare e scaricare molti video insieme. Richiede i video in lotto sul tuo account.
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
Brand e prodotti
Kit del brand, loghi e foto prodotto salvate.
list_brand_kitscreate_brand_kitbrand_kit_from_briefupdate_brand_kitlist_brand_assetsgenerate_brand_assetdelete_brand_kitlist_product_assetscreate_product_asset_uploadcomplete_product_asset_upload
Crediti e pagamento
Saldo, cronologia, pacchetti di crediti, piani, Pix e annullamento.
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
Account e assistenza
Profilo, eliminazione dell'account e supporto.
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
Crediti e pagamento
I video usano gli stessi crediti dell'app. L'assistente chiede prima un preventivo e ti mostra il prezzo prima di creare un video.
Quando finisci i crediti, l'assistente mostra i pacchetti e i piani del tuo account. Ti dà un link per pagare con carta o un codice Pix da pagare nell'app della tua banca. I crediti arrivano appena il pagamento è confermato.
Sicurezza
- La tua chiave API agisce come te, anche per spendere crediti. Tienila segreta, come una password.
- Revoca una chiave in Impostazioni quando vuoi. Smette di funzionare alla richiesta successiva.
- I buoni assistenti chiedono prima di pagare, annullare o eliminare. Controlla queste richieste prima di approvarle.
- Le chiavi API accedono solo alle funzioni per i clienti. Non possono creare né revocare altre chiavi.
Errori
Quando qualcosa non va, lo strumento restituisce lo stato HTTP e un messaggio. I più comuni:
- 400
- Dati non validi. Il messaggio indica cosa correggere.
- 401
- Chiave API mancante, errata o revocata.
- 402
- Crediti insufficienti. Acquista crediti e riprova.
- 403
- Il tuo account non ha questa funzione.
- 429
- Troppe richieste. Attendi un po' e riprova.