AvataReel MCP
Mit dem MCP-Server von AvataReel kann dein KI-Assistent dein AvataReel-Konto nutzen. Er kann Avatare wählen, Skripte schreiben, Videos rendern und Credits kaufen, mit deiner Bestätigung.
Überblick
MCP (Model Context Protocol) ist ein offener Standard, der KI-Assistenten mit Apps verbindet. AvataReel bietet einen MCP-Server über HTTP. Du verbindest ihn einmal mit einem persönlichen API-Schlüssel, und dein Assistent bekommt dieselben Funktionen wie du in der App.
Schnellstart
1. API-Schlüssel erstellen
Öffne in AvataReel die Einstellungen, suche "KI-Assistenten (MCP)", benenne den Schlüssel und erstelle ihn. Kopiere ihn sofort: Wir zeigen ihn nur einmal. Einstellungen öffnen
2. Server zum Client hinzufügen
Füge dies in die MCP-Konfiguration deines Clients ein und ersetze avr_… durch deinen Schlüssel.
{ "mcpServers": { "avatareel": { "type": "http", "url": "https://api.avatareel.com/mcp", "headers": { "Authorization": "Bearer avr_…" } } } }In Claude Code ausführen:
claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
3. Sag, was du brauchst
Frag in einfachen Worten. Der Assistent wählt die Tools, zeigt den Preis, bevor er Credits ausgibt, und schickt dir den Videolink, sobald es fertig ist.
Was du fragen kannst
| Du fragst | Der Assistent |
|---|---|
| “Mach eine 30-Sekunden-Werbung für mein Café mit einem freundlichen Avatar.” | Listet Avatare auf, schreibt das Skript, zeigt den Preis, rendert das Video und gibt den Download-Link zurück. |
| “Schreib ein Skript anhand dieser Produktseite.” | Liest die Seite und entwirft ein UGC-Skript und eine Szene. |
| “Mach drei Versionen mit verschiedenen Hooks.” | Schreibt neue Einstiege und rendert für jeden ein Video. |
| “Wie viele Credits habe ich? Kauf mehr.” | Zeigt dein Guthaben und die Angebote und gibt dir einen Link zur Kartenzahlung oder einen Pix-Code. |
| “Erstelle einen Avatar aus diesem Foto.” | Lädt das Foto hoch, erstellt den Avatar und sagt dir, wann er fertig ist. |
| “Kündige mein Abo.” | Startet die Kündigung und fragt dich, bevor er sie bestätigt. |
Tools
Das sind die Tools, die der Server anbietet. Dein Assistent wählt sie für dich aus; die Namen helfen, wenn du eines direkt anfragen willst.
Videos
Videos kalkulieren, erstellen, verfolgen, wiederholen und teilen.
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
Skripte
Skripte schreiben, umschreiben und übersetzen oder mit einer Produktseite starten.
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
Avatare und Stimmen
Avatare und Stimmen durchsuchen oder einen Avatar aus einem Foto oder einer Beschreibung erstellen.
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
Bearbeitung
Outfit und Hintergrund ändern, fertige Videos bearbeiten und den Bewegungseditor nutzen.
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
Stapel
Viele Videos auf einmal erstellen und herunterladen. Erfordert Stapelvideos in deinem Konto.
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
Marke und Produkte
Brand-Kits, Logos und gespeicherte Produktfotos.
list_brand_kitscreate_brand_kitbrand_kit_from_briefupdate_brand_kitlist_brand_assetsgenerate_brand_assetdelete_brand_kitlist_product_assetscreate_product_asset_uploadcomplete_product_asset_upload
Credits und Zahlung
Guthaben, Verlauf, Credit-Pakete, Abos, Pix und Kündigung.
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
Konto und Hilfe
Profil, Kontolöschung und Support.
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
Credits und Zahlung
Videos verbrauchen dieselben Credits wie in der App. Der Assistent holt zuerst ein Angebot ein und zeigt dir den Preis, bevor er ein Video erstellt.
Wenn dir die Credits ausgehen, zeigt der Assistent die Pakete und Abos für dein Konto. Er gibt dir einen Link zur Kartenzahlung oder einen Pix-Code für deine Banking-App. Die Credits kommen an, sobald die Zahlung bestätigt ist.
Sicherheit
- Dein API-Schlüssel handelt in deinem Namen, auch beim Ausgeben von Credits. Halte ihn geheim wie ein Passwort.
- Widerrufe einen Schlüssel jederzeit in den Einstellungen. Er funktioniert ab der nächsten Anfrage nicht mehr.
- Gute Assistenten fragen, bevor sie zahlen, kündigen oder löschen. Prüfe diese Anfragen, bevor du sie freigibst.
- API-Schlüssel erreichen nur Kundenfunktionen. Sie können keine anderen Schlüssel erstellen oder widerrufen.
Fehler
Wenn etwas fehlschlägt, gibt das Tool den HTTP-Status und eine Nachricht zurück. Die häufigsten:
- 400
- Ungültige Eingabe. Die Nachricht nennt, was zu korrigieren ist.
- 401
- API-Schlüssel fehlt, ist falsch oder widerrufen.
- 402
- Nicht genug Credits. Kauf Credits und versuch es erneut.
- 403
- Dein Konto hat diese Funktion nicht.
- 429
- Zu viele Anfragen. Warte kurz und versuch es erneut.