AvataReel
Documentazione

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. 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. 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. 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 chiediL'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_video
  • create_video
  • wait_for_video
  • list_videos
  • get_video
  • get_video_steps
  • retry_video
  • delete_video
  • create_videos_from_brief
  • create_hook_variations
  • generate_post_caption
  • create_product_image_upload
  • create_character_swap_upload
  • complete_character_swap_upload
  • create_character_swap_image_upload
  • complete_character_swap_image_upload
  • claim_video_guarantee
  • get_video_feedback
  • send_video_feedback
  • submit_post_link
  • list_listing_images
  • create_listing_images
  • regenerate_listing_image

Script

Scrivere, riscrivere e tradurre script, o partire da una pagina prodotto.

  • list_scripts
  • generate_script
  • generate_guided_script
  • script_from_url
  • rewrite_script
  • translate_script
  • generate_hooks
  • suggest_avatar
  • preview_speech
  • preview_voice
  • generate_batch_scripts

Avatar e voci

Sfogliare avatar e voci, o creare un avatar da una foto o una descrizione.

  • list_avatars
  • get_avatar
  • list_voices
  • get_avatar_quota
  • create_avatar_photo_upload
  • assess_avatar_photo
  • generate_avatar_face
  • create_avatar
  • confirm_avatar_likeness
  • get_avatar_source_photo
  • replace_avatar_photo
  • set_avatar_voice
  • create_voice_recording_upload
  • merge_voice_takes
  • retry_avatar
  • delete_avatar

Modifica

Cambiare abito e sfondo, modificare video finiti e usare l'editor di movimento.

  • classify_video
  • check_product_script
  • suggest_wardrobe
  • create_background_upload
  • create_brand_logo_upload
  • create_scene_image_upload
  • preview_appearance
  • change_appearance
  • get_video_captions
  • edit_video
  • get_motion_editor_access
  • create_motion_edit
  • create_automatic_motion_edit
  • get_motion_edit
  • get_video_motion_edit
  • save_motion_edit
  • direct_motion_edit
  • add_motion_soundtrack
  • export_motion_edit

Lotti

Creare e scaricare molti video insieme. Richiede i video in lotto sul tuo account.

  • quote_video_batch
  • create_video_batch
  • get_video_batch
  • get_video_batch_download
  • create_batch_motion_edits
  • list_batch_motion_edits

Brand e prodotti

Kit del brand, loghi e foto prodotto salvate.

  • list_brand_kits
  • create_brand_kit
  • brand_kit_from_brief
  • update_brand_kit
  • list_brand_assets
  • generate_brand_asset
  • delete_brand_kit
  • list_product_assets
  • create_product_asset_upload
  • complete_product_asset_upload

Crediti e pagamento

Saldo, cronologia, pacchetti di crediti, piani, Pix e annullamento.

  • get_credit_balance
  • list_credit_transactions
  • list_unseen_refunds
  • get_billing_offers
  • create_pack_checkout
  • create_pix_charge
  • get_payment_order
  • get_subscription
  • create_subscription_checkout
  • create_subscription_pix
  • get_subscription_pix
  • change_subscription
  • start_subscription_cancel
  • accept_cancel_offer
  • confirm_subscription_cancel
  • create_billing_portal
  • get_billing_profile
  • update_billing_profile

Account e assistenza

Profilo, eliminazione dell'account e supporto.

  • get_profile
  • update_profile
  • create_profile_photo_upload
  • delete_account
  • send_support_report
  • ask_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.
AvataReel MCP: crea video pubblicitari dal tuo assistente IA