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