MCP 経由で HeyGen を Meta Muse に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → HeyGen をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

HeyGen + Meta Muse

自分のキーで AI に HeyGen のアバター動画を作成させることができます。アバターと音声を選ぶ、台本やプロンプトを話す動画にする、テンプレートに入力する、動画をリップシンク付きで他の言語に翻訳する、フォトアバターを作成する、レンダリングと残高を確認する、といったことができます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

HEYGEN_API_KEY

ステップ 1 — 認証情報を取得

1. https://app.heygen.com にサインインし、API ダッシュボード（https://app.heygen.com/developers/api）を開きます。
2. API キーを生成してコピーします。API の利用料は HeyGen の Web サブスクリプションとは別に請求されます。アカウントに残高や支払い方法がない場合は、ダッシュボードで追加してください。
3. キーを HEYGEN_API_KEY に貼り付けて、コネクターをインストールします。キーは HeyGen にのみ送信されます。スコープを制限したキーには、アバター、音声、動画、テンプレート、翻訳、ユーザーへの読み取り権限と、作成を行うツール用の書き込み権限が必要です。
4. まず heygen_get_account を使ってください。請求タイプと、使える残りの金額が表示されます。

料金は自分の HeyGen API 残高から: 動画、翻訳、アバターは API 残高（従量課金のウォレット、またはプランのクレジット）から支払われます。HeyGen は動画の長さとエンジンに応じて課金します。現在の料金は API ダッシュボードに表示され、拒否された呼び出し（402）には必要な金額が示されます。一覧表示と確認は無料です。

事前に確認: heygen_create_video、heygen_generate_from_template、heygen_create_agent_video、heygen_translate_video の前に、AI は作成する内容（アバター、音声、台本の長さ、形式、言語、エンジン）を伝え、あなたの承認を待ちます。heygen_create_photo_avatar は、あなた自身など同意を得た人の写真しか使いません。AI はその権利があることをあなたに確認します。heygen_delete_video はインストール時に無効になっています。

動画の作成手順:

1. AI は heygen_list_avatar_groups でキャラクターを選び、heygen_list_avatar_looks でそのルックを 1 つ選びます。このルックがプレゼンターになります。heygen_list_voices の音声は任意で、指定しない場合はアバター自身の声で話します。
2. heygen_create_video は台本（最大 5,000 文字）、形式（たとえばショート動画なら 9:16）、エンジンを受け取り、すぐに動画 ID を返します。
3. 動画はバックグラウンドでレンダリングされます。AI は約 30 秒ごとに heygen_get_video で確認します。レンダリングには 1 分から数分かかり、長い台本ではさらに時間がかかります。
4. 完成した動画には、MP4 リンク、字幕付きバージョン、SRT 字幕、HeyGen 上の動画へのリンクが付きます。ダウンロードリンクは失効するので、必要なら改めて取得してください。

その他の動画作成方法:

• テンプレート: heygen_list_templates と heygen_get_template で API 対応のテンプレートとその変数を表示し、heygen_generate_from_template がすべてのテキスト変数を埋めて動画をレンダリングします。
• Video Agent: heygen_create_agent_video はプロンプトから動画全体（台本、シーン、アバター）を作成し、heygen_get_agent_session で動画がレンダリングされるまで追跡します。
• 翻訳: heygen_translate_video は公開リンクの動画を 1 つ以上の言語に翻訳します。話者のクローン音声とリップシンク付き、または音声のみを選べます。heygen_list_translation_languages で翻訳先の言語を一覧表示します。
• フォトアバター: heygen_create_photo_avatar は 1 枚のポートレートからプレゼンターを作成し、heygen_get_avatar_look で使用可能になったかを確認できます。

エンジン: デフォルトは avatar_iv です。avatar_v は最も自然な動きを実現しますが、対応しているルックでのみ使えます。avatar_iii は、デジタルツインとスタジオアバターで 4K に対応しています。

制限: 従量課金では、動画、翻訳、エージェントセッションを同時に 10 件までレンダリングできます（Enterprise ではそれ以上）。一覧の呼び出しは 1 分あたり 300 回、ステータス確認は 1 分あたり 500 回までです。ソースファイルは公開リンクである必要があり、動画は最大 100 MB、音声は最大 50 MB かつ 10 分までです。

よくあるエラー: 401: キーが間違っているか、取り消されています。402 insufficient_credit: 残高がこの動画の費用に足りません。メッセージに必要な金額が示されます。usage_limit_reached または trial_limit_exceeded: ワークスペースまたはトライアルの上限です。管理者または有料プランで解除できます。403 insufficient_api_key_scope: キーが制限されています。上記のスコープを付与してください。400 invalid_parameter: メッセージに該当するフィールドが示されます。たとえば、ルックが対応していないエンジンなどです。404: 存在しない ID です。AI は一覧ツールで ID を確認します。429: リクエストが多すぎます。しばらく待ってから 1 回だけ再試行してください。

コネクターは HeyGen の API v3 を使用します（HeyGen は旧 v1 および v2 のエンドポイントを 2026 年 10 月 31 日に廃止します）。複数シーンのスタジオ動画、画像から動画への変換、既存動画のリップシンク、ボイスクローンとボイスデザイン、単体のテキスト読み上げ、インタラクティブなストリーミングアバター、ファイルのアップロード（ソースは公開リンクである必要があります）、翻訳の校正、Webhook、ブランドキット、フォルダー、バッチには対応していません。

ステップ 2 — アダプターをインストール

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

ステップ 3 — Muse にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。

1. Muse で Settings → Connectors を開き、Add custom connector を選びます。
2. MCP サーバーの URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を貼り付けます。
3. Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
4. チャットで、HeyGen のツールが必要になる依頼を Muse にしてみましょう。

チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「HeyGen の API 残高はあといくら残っていますか？」
• 「私のアバターと、そのルックのうち 9:16 に最も適したものを見せてください。」
• 「私のデジタルツインがこの台本を読み上げる 45 秒の 9:16 動画を作成してください。先にアバター、音声、長さを私と確認し、完成したら MP4 リンクを送ってください。」
• 「週次アップデートのテンプレートにこの 3 つのニュースを入力して、レンダリングしてください。」
• 「この製品デモ動画をリップシンク付きでスペイン語（スペイン）と日本語に翻訳し、両方のバージョンが完成したら知らせてください。」

FAQ

Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。

Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続