AvataReel MCP サーバー
AvataReel の MCP サーバーを使うと、AI アシスタントがあなたの AvataReel アカウントを操作できます。あなたの確認のもと、アバター選び、台本作成、動画生成、クレジット購入を行えます。
概要
MCP(Model Context Protocol)は、AI アシスタントとアプリをつなぐオープン標準です。AvataReel は HTTP で MCP サーバーを提供しています。個人用 API キーで一度接続すれば、アプリと同じ機能をアシスタントが使えます。
クイックスタート
1. API キーを作成
AvataReel で設定を開き、"AI アシスタント (MCP)" でキーに名前を付けて作成します。キーは一度しか表示されないので、すぐにコピーしてください。 設定を開く
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. 必要なことを依頼
普段の言葉で依頼してください。アシスタントがツールを選び、クレジットを使う前に価格を示し、完成したら動画のリンクを渡します。
依頼できること
| あなたの依頼 | アシスタントの対応 |
|---|---|
| “親しみやすいアバターで、私のカフェの 30 秒広告を作って。” | アバターを一覧表示し、台本を書き、価格を示し、動画を生成してダウンロードリンクを返します。 |
| “この商品ページから台本を書いて。” | ページを読み、UGC 台本とシーンを作成します。 |
| “フックを変えて 3 パターン作って。” | 新しい冒頭を書き、それぞれ動画を 1 本ずつ生成します。 |
| “クレジットは何残ってる?追加で買って。” | 残高とプランを表示し、カード決済リンクまたは Pix コードを渡します。 |
| “この写真からアバターを作って。” | 写真をアップロードしてアバターを作成し、完成したらお知らせします。 |
| “プランを解約して。” | 解約手続きを始め、確定する前にあなたに確認します。 |
ツール
サーバーが提供するツールは以下のとおりです。アシスタントが自動で選びますが、特定のツールを指定したいときは名前が役立ちます。
動画
動画の見積もり、作成、進捗確認、再試行、共有。
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
台本
台本の作成、書き直し、翻訳、または商品ページからの作成。
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
アバターと音声
アバターと音声の閲覧、または写真や説明からのアバター作成。
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
編集
服装と背景の変更、完成動画の編集、モーションエディターの利用。
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
一括作成
多数の動画をまとめて作成・ダウンロード。アカウントで一括動画が有効である必要があります。
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
ブランドと商品
ブランドキット、ロゴ、保存した商品写真。
list_brand_kitscreate_brand_kitbrand_kit_from_briefupdate_brand_kitlist_brand_assetsgenerate_brand_assetdelete_brand_kitlist_product_assetscreate_product_asset_uploadcomplete_product_asset_upload
クレジットと支払い
残高、履歴、クレジットパック、プラン、Pix、解約。
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
アカウントとヘルプ
プロフィール、アカウント削除、サポート。
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
クレジットと支払い
動画にはアプリと同じクレジットを使います。アシスタントは先に見積もりを取り、動画を作成する前に価格を示します。
クレジットがなくなると、アシスタントがあなたのアカウント向けのパックとプランを表示します。カードで支払うリンク、または銀行アプリで支払う Pix コードを渡します。支払いが確認されるとすぐにクレジットが追加されます。
セキュリティ
- API キーはクレジットの使用も含め、あなたとして動作します。パスワードと同じく秘密にしてください。
- キーは設定からいつでも無効化できます。次のリクエストから使えなくなります。
- 優れたアシスタントは支払い、解約、削除の前に確認します。承認する前に内容を確認してください。
- API キーで使えるのはお客様向け機能だけです。他のキーを作成・無効化することはできません。
エラー
失敗すると、ツールは HTTP ステータスとメッセージを返します。主なものは次のとおりです:
- 400
- 入力が無効です。修正すべき点がメッセージに表示されます。
- 401
- API キーがない、間違っている、または無効化されています。
- 402
- クレジットが足りません。クレジットを購入して再試行してください。
- 403
- お使いのアカウントではこの機能を利用できません。
- 429
- リクエストが多すぎます。少し待ってから再試行してください。