Yukkurigen MCP

YukkuriGen — AI から使う「ゆっくり解説」動画生成

台本（話者＋セリフの配列）を渡すと、MP4 が返る。こちらで音声を合成してから 本番レンダーを開始する（動画1分につき1クレジット。クレジットパックか有料プランで）。焼く前は共有リンク （create_preview_link）で、無料プランでも全編を音つきで見られる（0クレジット）。 人が編集画面で作ることは想定していない——あなたが自分の AI に頼み、その AI が ここを呼ぶ。

あなた「ゆっくり解説で、日本の年金制度の動画を作って」

→ AI が create_yukkuri_video を呼ぶ（数秒で jobId が返る） → AI が get_job で音声合成とレンダー開始を待ち、get_render で MP4 の完成を待つ → MP4 の URL が返る あなた「3行目をもっと驚いた感じに」 → AI が update_lines でその行だけ直す（その行の喋る速さ・高さは voice、動画全体の速さは update_project_settings の voicePlaybackRate。既定 1.1） あなた「3行目の後ろに1行追加して」 → AI が insert_lines で行を挿入し、generate_audio で音声を作ってから render_mp4 を呼ぶ

直すのもこのサイトではなく、AI との会話で行う。

作例

台本は AI（Claude）が書いて MCP で渡し、返ってきた MP4 をそのまま載せている（人の手直し無し。2026-09-26 に撮り直し）。 台本は 21 行と 22 行。図解カード・写真・章の見出し・強調テロップ、行ごとの表情とポーズも、台本を書いた AI が指定している （card / photo / chapter / emphasis / emotion / pose）。YukkuriGen はそれを画像にして焼くだけで、サーバで AI は呼ばない。 音声・字幕・立ち絵・BGM・効果音は YukkuriGen が入れる。

立ち絵は目・眉・口・顔色・汗や涙・腕が別々の部品なので、セリフごとに組み替える。 表情は16種（ドヤ顔・ジト目・ガーン・照れ・大喜び など。全キャラ共通）、ポーズ（指さし・腕組み・マイク など）は ずんだもん・四国めたん・春日部つむぎ・あんこもんで使える。 聞き手も、直前に話したときの表情を穏やかにして残す。写真や図解が出ている間は、キャラが少し外へ寄って顔を空ける。

ずんだもん・四国めたん「コンビニコーヒーが安い本当の理由」

→ MP4 をダウンロード（720p・約96秒・音あり・6.7MB）

霊夢・魔理沙「寝る前のスマホが睡眠を壊す理由」

→ MP4 をダウンロード（720p・約82秒・音あり・5.2MB）

頼み方の例:

ずんだもんとめたんで、コンビニコーヒーが安い理由を1分半くらいで解説して。最後にチャンネル登録を呼びかけて。

AI は台本の行に、たとえば次のように演出も書いて create_yukkuri_video を呼ぶ:

{"speaker":"zundamon","text":"安くできる理由は三つあるのだ。",

"card":{"title":"安くできる3つの理由","style":"steps","items":["豆をまとめて大量仕入れ","ボタンひとつで自動抽出","お客さんのセルフ式"],"span":4}, "emotion":"smug","pose":"hip"} {"speaker":"metan","text":"味は大丈夫なのかしら？","photo":["coffee beans","coffee"],"emotion":"troubled","pose":"hold"} {"speaker":"metan","text":"えっ、儲からなくてもいいってこと！？","emotion":"shocked","pose":"mouth_cover","cameraMode":"dynamic","action":"jump"}

get_render で完成した MP4 の URL と、 YouTube の概要欄に貼るクレジット（credits）が返る。作例のクレジット:

【使用素材】

音声: VOICEVOX:ずんだもん、VOICEVOX:四国めたん 立ち絵: 坂本アヒル 様 背景: いらすとや 様（https://www.irasutoya.com/） BGM: DOVA-SYNDROME（https://dova-s.jp/）、こおろぎ 様 効果音: 効果音ラボ（https://soundeffect-lab.info/） 写真: Openverse（CC0・パブリックドメイン） 制作: YukkuriGen（https://yukkurigen.com/）

VOICEVOX の音声は「VOICEVOX:キャラ名」の表記が利用条件。動画を投稿するときは、この クレジットを概要欄に入れること（YukkuriGen から YouTube へ投稿した場合は自動で入る）。 写真は Openverse で CC0・パブリックドメインのものだけを使っている。

機能ごとの作例とスキル

skills/ に、機能ごとのスキル（AI 向けの手順書）が11本ある。Claude Code ならプラグインとしてまとめて入る（下の「つなぐ」）。 作例は、どれも AI（Claude）が MCP で作って焼いたものをそのまま載せている（2026-09-26）。

アカウントの無いまま呼ぶと、会員登録（無料・月の付与なし）の URL 付きで signup_required が返る。 ChatGPT・claude.ai のコネクタなら、つなぐ時に登録と許可の画面が開く。

つなぐ

ChatGPT・claude.ai（コネクタ）

コネクタの追加で、この URL を入れるだけ。鍵は要らない:

https://app.yukkurigen.com/api/mcp

YukkuriGen の許可画面が開くので「許可する」を押す（OAuth 2.1・PKCE・動的クライアント登録）。 つないだアプリは https://app.yukkurigen.com/settings/api-keys に「<アプリ名>（OAuth）」として出て、 そこから取り消せる。

VS Code

MCP サーバーを種類 HTTP で追加し、URL にこれを入れるだけ。鍵は要らない:

https://app.yukkurigen.com/api/mcp

VS Code が「MCP サーバー定義 … が YukkuriGen に認証しようとしています」と聞くので「許可」を押す。 ブラウザで YukkuriGen の許可画面（「Visual Studio Code を YukkuriGen につなぎますか？」）が開くので 「許可する」を押すと、VS Code に鍵が渡り、ツールが一覧に出る（2026-10-05 に VS Code 1.139 で確認）。 つないだ VS Code は API キーの画面に「Visual Studio Code」（「OAuth で接続」の札付き）として出て、そこから取り消せる。

Cursor・Windsurf など、ほかのエディタ

同じ URL を鍵なしで入れてつながるかは、実機では確かめていない。試してつながらなければ、 下の「鍵をヘッダーで渡すクライアント」と「その他の MCP クライアント」の方法でつなぐ（こちらは従来どおり使える）。

鍵をヘッダーで渡すクライアント

まず鍵を取る（無料・月の付与なし）: https://app.yukkurigen.com/settings/api-keys

Claude Code

プラグインとして入れると、MCP サーバの接続と機能ごとのスキル11本がまとめて入る（接続はブラウザでの許可）:

/plugin marketplace add yukkurigen/yukkurigen-mcp

/plugin install yukkurigen@yukkurigen

API キーで繋ぐなら:

claude mcp add --transport http yukkurigen https://app.yukkurigen.com/api/mcp \

-H "Authorization: Bearer $YUKKURIGEN_API_KEY"

チームで共有するなら、このリポジトリの .mcp.json をプロジェクトに置く。 鍵は環境変数 YUKKURIGEN_API_KEY から読む（ファイルに鍵を書かない）。

Codex

~/.codex/config.toml に足す:

[mcp_servers.yukkurigen]

url = "https://app.yukkurigen.com/api/mcp" bearer_token_env_var = "YUKKURIGEN_API_KEY"

export YUKKURIGEN_API_KEY=yg_live_...

鍵は環境変数から読むので、設定ファイルに書かない。

Gemini CLI

export YUKKURIGEN_API_KEY=yg_live_...

gemini extensions install https://github.com/yukkurigen/yukkurigen-mcp

このリポジトリの gemini-extension.json が読まれる。鍵は環境変数から読むので、 ファイルに書かない。

その他の MCP クライアント

エンドポイントは1つだけ:

POST https://app.yukkurigen.com/api/mcp

Authorization: Bearer

JSON-RPC 2.0 over HTTP。tools/list でツール一覧が取れる。 server.json は MCP レジストリ用のマニフェスト。

REST で直接叩く

curl -X POST https://app.yukkurigen.com/api/v1/agent/generate \

-H "Authorization: Bearer $YUKKURIGEN_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: my-first-video-sync" \ -d '{"title":"テスト","script":[{"speaker":"reimu","text":"こんにちは"},{"speaker":"marisa","text":"よろしくだぜ"}]}'

これは同期の呼び出しで、音声合成とレンダー開始を待ってから返る（台本が長いと数十秒。 サーバの設定によっては、一定時間だけ待って終わらなければ 202 が返る）。 待っている途中で接続が切れても、サーバ側では生成と課金が進む。投げ直すときは同じ Idempotency-Key を付ける （同じ鍵なら、処理中は 409、終わっていれば最初の結果が返り、2本目は作られない）。 待たずに済ませるなら Prefer: respond-async を付ける。数秒で 202 と jobId / projectId が返る （サーバの設定によってはジョブにならず、同期で待ってから 200 が返る）:

curl -X POST https://app.yukkurigen.com/api/v1/agent/generate \

-H "Authorization: Bearer $YUKKURIGEN_API_KEY" \ -H "Content-Type: application/json" \ -H "Prefer: respond-async" \ -H "Idempotency-Key: my-first-video" \ -d '{"title":"テスト","script":[{"speaker":"reimu","text":"こんにちは"},{"speaker":"marisa","text":"よろしくだぜ"}]}'

GET /api/v1/jobs/{jobId} が succeeded になったら、result.renderId を GET /api/v1/projects/{projectId}/render/{renderId}/progress に渡して完成を待つ。 failed なら error.code に理由が入り、クレジットは返金される。 例外は、レンダーを起動したあとにジョブだけが失敗した場合（まれ）で、レンダーは課金されたまま 動いていて返金されず、Idempotency-Key も空かない（同じ鍵で投げ直すと、起動済みのレンダーが 200 で 返り、2本目は作られない）。renderId に agent-{jobId} を渡して進捗を見れば結果が分かる （not_found なら起動しておらず、返金される）。

複数本は POST /api/v1/agent/generate/batch（MCP は create_yukkuri_videos_batch、最大20件）にまとめて渡せる。 Prefer: respond-async を付けると数秒で 202 と jobId が返り、各件はサーバ側で1件ずつ順に作られる （サーバの設定によってはジョブにならず、同期で処理して 200 が返る。MCP のツールは自分で付ける）。 succeeded の result.results に各件の projectId / renderId / jobId が並ぶので、renderId を 上と同じ進捗の URL に渡す。バッチのジョブが failed になっても返金ではない——作り始めた件は それぞれのジョブで課金されたまま進む。失敗したバッチは GET /api/v1/jobs/{jobId} の partialResults に 作り始めた件と投げ直してよい件（resendIndexes）が分かれて入るので、その件だけを新しい idempotencyKeyPrefix の新しいバッチで送る。同じ prefix で全件を投げ直しても作り始めた件が二重に 作られないのは、その件のジョブが終わってから 24 時間以内だけ（期限は partialResults.fullResendSafeUntil）。

画像を取り込むには POST /api/v1/assets/import（MCP は import_images）。 URL リストから画像を S3 へコピーし、materialImageUrl / backgroundImageUrl に使える 永続 URL を返す。期限付きの画像生成サービス出力など、再リクエストで変わる URL を 動画に使うときに使う。クレジット消費なし。

利用者の PC にある画像（ComfyUI などで作ったもの）は、シェルを実行できる AI なら POST /api/v1/assets/image-uploads（MCP は create_image_upload）で署名付き URL を出して PUT し、 POST /api/v1/assets/image-uploads/confirm（confirm_image_upload）で確定する（最大 10MB）。 シェルが無ければ POST /api/v1/assets/image-uploads/inline（upload_image）に base64 で渡す （デコード後 8MB まで）。返る URL は取り込みと同じ扱い。クレジット消費なし。

BGM と効果音は行ごとに決められる。行の bgm に組み込みの曲の名前（GET /api/v1/audio-library、MCP は list_bgm）・ 利用者が上げた音の url・"none"（止める）を書くと、その行から次に bgm を書いた行まで流れる。行の effect には 組み込みの効果音の名前か上げた音の url。手元の音（mp3 / wav / ogg。BGM 30MB・効果音 5MB）は POST /api/v1/assets/audio-uploads（create_audio_upload）→ PUT → POST /api/v1/assets/audio-uploads/confirm （confirm_audio_upload）、シェルが無ければ POST /api/v1/assets/audio-uploads/inline（upload_audio）。 上げた音を使ってよいかは利用者の責任。話している間だけ BGM を下げるダッキングは、テンプレートの bgm.ducking （update_template_style）か PATCH /api/v1/projects/{id}/settings の bgmDucking（既定は切）。クレジット消費なし。

BGM を AI に作らせるなら POST /api/v1/assets/bgm/generate（MCP は generate_bgm）。ACE-Step で1曲（30〜240 秒。 雰囲気は英語のタグで指定）作り、利用者の BGM 素材として登録する（上げた音と同じ扱いで、url を行の bgm に書ける）。 いつも非同期で、GET /api/v1/jobs/{jobId}（get_job）の result に永続の url と1時間の downloadUrl が入る。 2クレジット（失敗したら返金）。projectId を渡しても動画の BGM は変えない（applyToProject: true のときだけ変える）。 ACE-Step はコード・モデルとも Apache License 2.0 で公開されている。作った曲が既存の曲に似ないことは確かめていない （使ってよいかの判断は利用者の責任）。

上げた PNG・WebP の画像1枚から、話者にできる自分のキャラを作るには POST /api/v1/agent/characters （MCP は create_character）。声は GET /api/v1/voices（list_voices）の speakerId か、組み込みキャラと同じ声の voiceOf（reimu など）。返る characterId を speaker に書く。直すのは PATCH /api/v1/agent/characters/{characterId} （update_character）。PSD の取り込みと削除は画面だけ。クレジット消費なし。

全項目の定義: https://app.yukkurigen.com/openapi.json

AI に読ませるもの

[SKILL.md](./SKILL.md) が手順書のすべて。接続、最小例、立ち絵、カメラ、素材の位置、縦型、 テンプレートの位置の直し方、クレジット、402 を受けたときの購入導線、冪等キー、バッチ生成、コールバックまで。 app.yukkurigen.com/skill.md と同一のファイルで、CI で一致を検査している。 機能ごとに短く分けたものが skills/（上の表）。

できること / かかるもの

月のクレジットはスタンダード100・プロ300（MP4 なら100分・300分）。クレジットパックは50・150・500（買い切り・期限なし）。402 を受けたら create_checkout で決済リンクを出せる ——会話を止めずに購入まで進める。

同時に走らせられるレンダーはプランごとに上限がある（無料1 / スタンダード3 / プロ10）。超えると 429 too_many_concurrent_renders（課金なし）。

正直に言っておくこと

• `create_yukkuri_video`（ジョブで受け付ける形）から MP4 までは、2026-09-25 に本番で通した （OAuth で接続 → create_yukkuri_video → get_job → get_render の完成まで。上の作例がその出力）。 まとめて作るバッチ（create_yukkuri_videos_batch）は 2026-09-26 に本番でプレビュー出力（当時あった1クレジットの低解像度 MP4。2026-09-27 に廃止）の3本を最後まで通した。MP4 出力のバッチは本番未検証（本番で最後まで通した実績はまだ無い）。 初めての形の台本は少数の行で試してほしい。途中で止まる場合は段ごとに切り分けられる （get_project → generate_audio → render_mp4）。不具合として報告してほしい。
• 台本はこちらのサーバで生成しない（LLM は呼ばない）。 台本・図解・写真の検索語・章・強調を決めるのは、 あなたが使っている AI（ChatGPT・Claude などのあなたのサブスク）。こちらは音声