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 대본과 장면을 작성합니다.
“후킹 문구를 다르게 해서 세 가지 버전을 만들어 줘.”새 도입부를 쓰고 각각 영상을 하나씩 생성합니다.
“크레딧이 얼마나 남았어? 더 사 줘.”잔액과 상품을 보여 주고 카드 결제 링크나 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 어시스턴트로 광고 영상 만들기