Przejdź do treści

Make AI videos with Codex

Connect Codex to Yoh and let it produce video stories from your terminal or editor: script, cast, clips, voices, captions and the final render, with a price shown and approved before every paid step.

Easiest: let your AI set it upCopy one prompt into Claude Code, Codex or Cursor. It installs Yoh and walks you through sign-in, on macOS, Linux or Windows.

Connect Codex

  1. Add the server and sign in

    Works in the Codex CLI, the IDE extension and the ChatGPT desktop app. Sign in to Yoh in the browser that opens.

    codex mcp add yoh --url https://www.yoh.app/api/mcp
    codex mcp login yoh
  2. Give long steps enough time

    Some Yoh steps take a few minutes. Set a 300-second tool timeout, then restart Codex.

    ~/.codex/config.toml
    [mcp_servers.yoh]
    url = "https://www.yoh.app/api/mcp"
    tool_timeout_sec = 300
    startup_timeout_sec = 20
  3. Add the Yoh skill (recommended)

    The skill (SKILL.md plus its reference files and a helper script, installed as one folder) teaches the agent how to make a Yoh story well: start in a series, quote before spending, and look at the clips before judging them. It is kept up to date with the server. In Codex, call it with $yoh.

    (
      set -eu
      skill_dir="$HOME/.agents/skills/yoh"
      if [ -e "$skill_dir" ]; then
        printf '%s\n' 'Yoh skill already exists. Use the setup prompt to check or update it.' >&2
        exit 1
      fi
      mkdir -p "$skill_dir/references" "$skill_dir/scripts"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/SKILL.md' --output "$skill_dir/SKILL.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/browser-workflow.md' --output "$skill_dir/references/browser-workflow.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/checking-clips.md' --output "$skill_dir/references/checking-clips.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/common-jobs.md' --output "$skill_dir/references/common-jobs.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/editing-clips.md' --output "$skill_dir/references/editing-clips.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/errors-and-refusals.md' --output "$skill_dir/references/errors-and-refusals.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/generation-and-pricing.md' --output "$skill_dir/references/generation-and-pricing.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/gotchas.md' --output "$skill_dir/references/gotchas.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/hires-ads-publishing.md' --output "$skill_dir/references/hires-ads-publishing.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/lines-and-voices.md' --output "$skill_dir/references/lines-and-voices.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/looks-and-assets.md' --output "$skill_dir/references/looks-and-assets.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/mcp-tool-index.md' --output "$skill_dir/references/mcp-tool-index.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/recipes.md' --output "$skill_dir/references/recipes.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/setup-and-clients.md' --output "$skill_dir/references/setup-and-clients.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/stories-and-scripts.md' --output "$skill_dir/references/stories-and-scripts.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-analysis.md' --output "$skill_dir/references/timeline-analysis.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-and-edit-mode.md' --output "$skill_dir/references/timeline-and-edit-mode.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/upload-and-cut.md' --output "$skill_dir/references/upload-and-cut.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/writing-clips.md' --output "$skill_dir/references/writing-clips.md"
      curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/scripts/download_timeline_analysis.py' --output "$skill_dir/scripts/download_timeline_analysis.py"
    )
  4. Check the connection

    Ask your agent to run get_credits. It should answer with your Yoh credit balance. Run /mcp in Claude Code or Codex to see the server's status.

Then just ask

  • “Make a 60-second story about a night-shift nurse who can hear ghosts.”
  • “Turn this script into a five-episode series and show me the cast before you draw anything.”
  • “Tighten episode 3: trim the dead air, move the captions onto the beats, then quote the render.”
  • “Swap the lead in clip 4 for my character and redo only that clip's video.”

Why it works well

Nothing is charged without your OK

Reading and editing are free. Every step that spends credits (drawing pictures, generating clip videos, rendering) first returns a price. The agent shows it to you and only goes ahead after you approve, and the same approval cannot be charged twice.

No key in your shell history

codex mcp login signs in with Yoh. For CI, use an API key in an environment variable instead (bearer_token_env_var = "YOH_API_KEY").

Same story, same rules as the app

The agent works on the same stories, clips and timeline you see on yoh.app, with the same rules as the editor. An edit made from the terminal lands exactly where a drag in the browser would, and the open page updates within seconds.

See it in the browser

In the ChatGPT desktop app, Codex can open the yoh.app pages it changes in its browser and check the result on screen.

Questions

Can Codex make videos?

Yes, with the Yoh MCP server connected. Codex calls Yoh tools to write the story, generate each clip and render the final video in your Yoh account.

Which Codex clients are supported?

The Codex CLI, the Codex IDE extension and Codex in the ChatGPT desktop app. They share ~/.codex/config.toml.

Can I run it headless in CI?

Yes. Create an API key at Settings → API keys, export it as YOH_API_KEY and set bearer_token_env_var = "YOH_API_KEY" under [mcp_servers.yoh]. Paid steps still need an explicit approval token from the quote.

Does it also work in ChatGPT?

Yes. In ChatGPT add a custom MCP server named Yoh with the same address and sign in. Some plans need an admin to allow custom servers.

Full reference: Yoh docs · Pricing

Other ways to connect