AvataReel
ドキュメント

AvataReel MCP サーバー

AvataReel の MCP サーバーを使うと、AI アシスタントがあなたの AvataReel アカウントを操作できます。あなたの確認のもと、アバター選び、台本作成、動画生成、クレジット購入を行えます。

概要

MCP(Model Context Protocol)は、AI アシスタントとアプリをつなぐオープン標準です。AvataReel は HTTP で MCP サーバーを提供しています。個人用 API キーで一度接続すれば、アプリと同じ機能をアシスタントが使えます。

クイックスタート

  1. 1. API キーを作成

    AvataReel で設定を開き、"AI アシスタント (MCP)" でキーに名前を付けて作成します。キーは一度しか表示されないので、すぐにコピーしてください。 設定を開く

  2. 2. クライアントにサーバーを追加

    これをクライアントの MCP 設定に貼り付け、avr_… をあなたのキーに置き換えます。

    {
      "mcpServers": {
        "avatareel": {
          "type": "http",
          "url": "https://api.avatareel.com/mcp",
          "headers": {
            "Authorization": "Bearer avr_…"
          }
        }
      }
    }

    Claude Code では次を実行します:

    claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
  3. 3. 必要なことを依頼

    普段の言葉で依頼してください。アシスタントがツールを選び、クレジットを使う前に価格を示し、完成したら動画のリンクを渡します。

依頼できること

あなたの依頼アシスタントの対応
“親しみやすいアバターで、私のカフェの 30 秒広告を作って。”アバターを一覧表示し、台本を書き、価格を示し、動画を生成してダウンロードリンクを返します。
“この商品ページから台本を書いて。”ページを読み、UGC 台本とシーンを作成します。
“フックを変えて 3 パターン作って。”新しい冒頭を書き、それぞれ動画を 1 本ずつ生成します。
“クレジットは何残ってる?追加で買って。”残高とプランを表示し、カード決済リンクまたは Pix コードを渡します。
“この写真からアバターを作って。”写真をアップロードしてアバターを作成し、完成したらお知らせします。
“プランを解約して。”解約手続きを始め、確定する前にあなたに確認します。

ツール

サーバーが提供するツールは以下のとおりです。アシスタントが自動で選びますが、特定のツールを指定したいときは名前が役立ちます。

動画

動画の見積もり、作成、進捗確認、再試行、共有。

  • 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

台本

台本の作成、書き直し、翻訳、または商品ページからの作成。

  • 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

アバターと音声

アバターと音声の閲覧、または写真や説明からのアバター作成。

  • 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

編集

服装と背景の変更、完成動画の編集、モーションエディターの利用。

  • 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

一括作成

多数の動画をまとめて作成・ダウンロード。アカウントで一括動画が有効である必要があります。

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

ブランドと商品

ブランドキット、ロゴ、保存した商品写真。

  • 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

クレジットと支払い

残高、履歴、クレジットパック、プラン、Pix、解約。

  • 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

アカウントとヘルプ

プロフィール、アカウント削除、サポート。

  • get_profile
  • update_profile
  • create_profile_photo_upload
  • delete_account
  • send_support_report
  • ask_support

クレジットと支払い

動画にはアプリと同じクレジットを使います。アシスタントは先に見積もりを取り、動画を作成する前に価格を示します。

クレジットがなくなると、アシスタントがあなたのアカウント向けのパックとプランを表示します。カードで支払うリンク、または銀行アプリで支払う Pix コードを渡します。支払いが確認されるとすぐにクレジットが追加されます。

セキュリティ

  • API キーはクレジットの使用も含め、あなたとして動作します。パスワードと同じく秘密にしてください。
  • キーは設定からいつでも無効化できます。次のリクエストから使えなくなります。
  • 優れたアシスタントは支払い、解約、削除の前に確認します。承認する前に内容を確認してください。
  • API キーで使えるのはお客様向け機能だけです。他のキーを作成・無効化することはできません。

エラー

失敗すると、ツールは HTTP ステータスとメッセージを返します。主なものは次のとおりです:

400
入力が無効です。修正すべき点がメッセージに表示されます。
401
API キーがない、間違っている、または無効化されています。
402
クレジットが足りません。クレジットを購入して再試行してください。
403
お使いのアカウントではこの機能を利用できません。
429
リクエストが多すぎます。少し待ってから再試行してください。
AvataReel MCP:AI アシスタントから広告動画を作成