AvataReel
Dokumentation

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. 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. 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. 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 fragstDer 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_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

Skripte

Skripte schreiben, umschreiben und übersetzen oder mit einer Produktseite starten.

  • 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

Avatare und Stimmen

Avatare und Stimmen durchsuchen oder einen Avatar aus einem Foto oder einer Beschreibung erstellen.

  • 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

Bearbeitung

Outfit und Hintergrund ändern, fertige Videos bearbeiten und den Bewegungseditor nutzen.

  • 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

Stapel

Viele Videos auf einmal erstellen und herunterladen. Erfordert Stapelvideos in deinem Konto.

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

Marke und Produkte

Brand-Kits, Logos und gespeicherte Produktfotos.

  • 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

Credits und Zahlung

Guthaben, Verlauf, Credit-Pakete, Abos, Pix und Kündigung.

  • 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

Konto und Hilfe

Profil, Kontolöschung und Support.

  • get_profile
  • update_profile
  • create_profile_photo_upload
  • delete_account
  • send_support_report
  • ask_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.
AvataReel MCP: Werbevideos mit deinem KI-Assistenten erstellen