AvataReel MCP
O servidor MCP do AvataReel permite que seu assistente de IA use sua conta AvataReel. Ele pode escolher avatares, escrever roteiros, gerar vídeos e comprar créditos, com a sua confirmação.
Visão geral
MCP (Model Context Protocol) é um padrão aberto que conecta assistentes de IA a aplicativos. O AvataReel oferece um servidor MCP via HTTP. Você conecta uma vez com uma chave de API pessoal, e seu assistente ganha os mesmos recursos que você usa no app.
Início rápido
1. Crie uma chave de API
No AvataReel, abra Configurações, encontre "Assistentes de IA (MCP)", dê um nome à chave e crie. Copie na hora: ela só aparece uma vez. Abrir Configurações
2. Adicione o servidor ao seu cliente
Cole isto na configuração MCP do seu cliente e troque avr_… pela sua chave.
{ "mcpServers": { "avatareel": { "type": "http", "url": "https://api.avatareel.com/mcp", "headers": { "Authorization": "Bearer avr_…" } } } }No Claude Code, execute:
claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
3. Peça o que precisar
Peça com palavras simples. O assistente escolhe as ferramentas, mostra o preço antes de gastar créditos e envia o link do vídeo quando ficar pronto.
O que você pode pedir
| Você pede | O assistente |
|---|---|
| “Faça um anúncio de 30 segundos para minha cafeteria com um avatar simpático.” | Lista avatares, escreve o roteiro, mostra o preço, gera o vídeo e envia o link de download. |
| “Escreva um roteiro a partir desta página de produto.” | Lê a página e cria um roteiro UGC e uma cena. |
| “Faça três versões com ganchos diferentes.” | Escreve novas aberturas e gera um vídeo para cada uma. |
| “Quantos créditos eu tenho? Compre mais.” | Mostra seu saldo e as ofertas, e envia um link de pagamento com cartão ou um código Pix. |
| “Crie um avatar a partir desta foto.” | Envia a foto, cria o avatar e avisa quando estiver pronto. |
| “Cancele meu plano.” | Inicia o cancelamento e pergunta a você antes de confirmar. |
Ferramentas
Estas são as ferramentas que o servidor oferece. Seu assistente escolhe por você; os nomes ajudam quando você quer pedir uma diretamente.
Vídeos
Ver preço, criar, acompanhar, tentar de novo e compartilhar vídeos.
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
Roteiros
Escrever, reescrever e traduzir roteiros, ou começar por uma página de produto.
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
Avatares e vozes
Ver avatares e vozes, ou criar um avatar a partir de uma foto ou descrição.
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
Edição
Trocar roupa e fundo, editar vídeos prontos e usar o editor de 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
Lotes
Criar e baixar vários vídeos de uma vez. Requer vídeos em lote na sua conta.
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
Marca e produtos
Kits de marca, logos e fotos de produto salvas.
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 e pagamento
Saldo, histórico, pacotes de créditos, planos, Pix e cancelamento.
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
Conta e ajuda
Perfil, exclusão da conta e suporte.
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
Créditos e pagamento
Os vídeos usam os mesmos créditos do app. O assistente faz um orçamento antes e mostra o preço antes de criar um vídeo.
Quando seus créditos acabam, o assistente mostra os pacotes e planos da sua conta. Ele envia um link para pagar com cartão ou um código Pix para pagar no app do seu banco. Os créditos chegam assim que o pagamento é confirmado.
Segurança
- Sua chave de API age como você, inclusive para gastar créditos. Guarde em segredo, como uma senha.
- Revogue uma chave em Configurações quando quiser. Ela para de funcionar na próxima solicitação.
- Bons assistentes perguntam antes de pagar, cancelar ou excluir. Revise esses pedidos antes de aprovar.
- Chaves de API só acessam recursos de cliente. Elas não podem criar nem revogar outras chaves.
Erros
Quando algo falha, a ferramenta retorna o status HTTP e uma mensagem. Os mais comuns:
- 400
- Dados inválidos. A mensagem diz o que corrigir.
- 401
- Chave de API ausente, errada ou revogada.
- 402
- Créditos insuficientes. Compre créditos e tente de novo.
- 403
- Sua conta não tem este recurso.
- 429
- Muitas solicitações. Aguarde um pouco e tente de novo.