HeyGen MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → HeyGen klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

HeyGen + Microsoft Copilot

Lass deine KI mit deinem eigenen Key HeyGen-Avatar-Videos erstellen: Avatare und Stimmen auswählen, aus einem Skript oder einem Prompt ein Sprechervideo machen, deine Vorlagen befüllen, Videos lippensynchron in andere Sprachen übersetzen, Foto-Avatare anlegen und Renderings und dein Guthaben prüfen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

HEYGEN_API_KEY

Schritt 1 — Zugangsdaten holen

1. Melde dich unter https://app.heygen.com an und öffne das API-Dashboard (https://app.heygen.com/developers/api).
2. Erzeuge einen API-Key und kopiere ihn. Die API-Nutzung wird getrennt von einem HeyGen-Web-Abo abgerechnet: Lade dort Guthaben auf oder hinterlege ein Zahlungsmittel, falls das Konto noch keins hat.
3. Füge den Key in HEYGEN_API_KEY ein und installiere den Connector. Der Key wird nur an HeyGen gesendet. Ein auf bestimmte Scopes beschränkter Key braucht Lesezugriff auf Avatare, Stimmen, Videos, Vorlagen, Übersetzungen und den Nutzer sowie Schreibzugriff für die Tools, die etwas erstellen.
4. Starte mit heygen_get_account: Es zeigt deine Abrechnungsart und was du noch ausgeben kannst.

Abgerechnet über dein HeyGen-API-Guthaben: Videos, Übersetzungen und Avatare werden aus deinem API-Guthaben bezahlt (eine Pay-as-you-go-Wallet oder die Credits deines Plans). HeyGen rechnet Videos nach Länge und Engine ab; die aktuellen Preise stehen im API-Dashboard, und ein abgelehnter Aufruf (402) nennt den benötigten Betrag. Auflisten und Abfragen ist kostenlos.

Erst bestätigen: Vor heygen_create_video, heygen_generate_from_template, heygen_create_agent_video oder heygen_translate_video sagt dir die KI, was erstellt wird (Avatar, Stimme, Skriptlänge, Format, Sprachen, Engine), und wartet auf dein Ja. heygen_create_photo_avatar nimmt nur das Foto einer Person, die zugestimmt hat, zum Beispiel deins, und die KI bittet dich zu bestätigen, dass du dieses Recht hast. heygen_delete_video ist bei der Installation deaktiviert.

So entsteht ein Video:

1. Die KI wählt mit heygen_list_avatar_groups eine Figur und mit heygen_list_avatar_looks einen ihrer Looks; der Look ist der Sprecher. Eine Stimme aus heygen_list_voices ist optional, sonst spricht die eigene Stimme des Avatars.
2. heygen_create_video nimmt das Skript (bis zu 5.000 Zeichen), das Format (zum Beispiel 9:16 für Shorts) und die Engine entgegen und gibt sofort eine Video-ID zurück.
3. Das Video wird im Hintergrund gerendert. Die KI fragt etwa alle 30 Sekunden mit heygen_get_video nach; ein Rendering dauert eine bis mehrere Minuten, bei langen Skripten länger.
4. Das fertige Video kommt mit einem MP4-Link, einer Version mit Untertiteln, SRT-Untertiteln und einem Link zum Video in HeyGen. Download-Links laufen ab; frag erneut nach frischen.

Weitere Wege zum Video:

• Vorlagen: heygen_list_templates und heygen_get_template zeigen deine API-fähigen Vorlagen und ihre Variablen; heygen_generate_from_template befüllt alle Textvariablen und rendert das Video.
• Video Agent: heygen_create_agent_video macht aus einem Prompt ein komplettes Video (Skript, Szenen, Avatar); heygen_get_agent_session verfolgt es, bis das Video gerendert wird.
• Übersetzung: heygen_translate_video übersetzt ein Video von einem öffentlichen Link in eine oder mehrere Sprachen, mit der geklonten Stimme des Sprechers und Lippensynchronisation oder nur als Audio; heygen_list_translation_languages listet die Zielsprachen.
• Foto-Avatar: heygen_create_photo_avatar macht aus einem Porträt einen Sprecher; heygen_get_avatar_look zeigt, wann er einsatzbereit ist.

Engines: avatar_iv ist der Standard. avatar_v liefert die natürlichsten Bewegungen, aber nur für Looks, die sie unterstützen. avatar_iii unterstützt 4K für Digital Twins und Studio-Avatare.

Limits: 10 Videos, Übersetzungen oder Agent-Sessions gleichzeitig im Rendering bei Pay-as-you-go (mehr bei Enterprise), 300 Listenabfragen und 500 Statusabfragen pro Minute. Quelldateien müssen öffentliche Links sein: Video bis 100 MB, Audio bis 50 MB und 10 Minuten.

Häufige Fehler: 401: Der Key ist falsch oder widerrufen. 402 insufficient_credit: Das Guthaben reicht für dieses Video nicht, und die Meldung nennt den benötigten Betrag. usage_limit_reached oder trial_limit_exceeded: ein Workspace- oder Testlimit, das ein Admin oder ein bezahlter Plan aufhebt. 403 insufficient_api_key_scope: Der Key ist eingeschränkt; gib ihm die oben genannten Scopes. 400 invalid_parameter: Die Meldung nennt das Feld, zum Beispiel eine Engine, die der Look nicht unterstützt. 404: eine ID, die es nicht gibt; die KI prüft sie mit den Listen-Tools. 429: zu viele Anfragen; warte und versuch es später einmal erneut.

Der Connector nutzt die API v3 von HeyGen (HeyGen schaltet die älteren Endpunkte v1 und v2 am 31. Oktober 2026 ab). Nicht abgedeckt sind Studio-Videos mit mehreren Szenen, Image-to-Video, Lippensynchronisation bestehender Videos, Klonen und Designen von Stimmen, reine Sprachausgabe ohne Video, interaktive Streaming-Avatare, Datei-Uploads (Quellen müssen öffentliche Links sein), Korrekturlesen von Übersetzungen, Webhooks, Brand Kits, Ordner und Batches.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die HeyGen-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie viel ist noch auf meinem HeyGen-API-Guthaben?“
• „Zeig mir meine eigenen Avatare und welche ihrer Looks am besten im Format 9:16 funktionieren.“
• „Erstelle ein 45-Sekunden-Video im Format 9:16, in dem mein Digital Twin dieses Skript vorliest. Bestätige vorher Avatar, Stimme und Länge mit mir und schick mir den MP4-Link, sobald es fertig ist.“
• „Befülle unsere Vorlage für das Wochen-Update mit diesen drei Neuigkeiten und rendere das Video.“
• „Übersetze dieses Produktdemo-Video lippensynchron ins Spanische (Spanien) und ins Japanische und sag mir, wenn beide Versionen fertig sind.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden