跳至主要內容

AI 影片專用的 Yoh MCP 伺服器

一個遠端 MCP 端點,就讓任何代理用上完整的 Yoh 工作室:寫故事、選角並畫出角色、生成含配音與音樂的片段影片、編輯時間軸與字幕、輸出並發布。每個工具都遵循和 yoh.app 編輯器相同的規則。

最簡單:讓 AI 幫你設定把一段提示詞複製到 Claude Code、Codex 或 Cursor。它會安裝 Yoh 並帶你完成登入,macOS、Linux、Windows 都適用。

連接任何 MCP 用戶端

  1. 使用這個網址

    Streamable HTTP,以 OAuth 登入。請完全照抄含 www 的網址:沒有 www 的 yoh.app 會被轉址,而登入會檢查網址。

    https://www.yoh.app/api/mcp
  2. Claude Code、Codex、Cursor、ChatGPT

    每個登入指令都會開啟瀏覽器讓你登入 Yoh。Cursor:把 yoh 項目合併到 ~/.cursor/mcp.json,Cursor 詢問時登入。ChatGPT:加入自訂 MCP 伺服器並登入。Claude 桌面版和 claude.ai:加入自訂連接器。

    Claude Code
    claude mcp add --transport http --scope user yoh https://www.yoh.app/api/mcp
    claude mcp login yoh
    Codex
    codex mcp add yoh --url https://www.yoh.app/api/mcp
    codex mcp login yoh
    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "yoh": {
          "url": "https://www.yoh.app/api/mcp"
        }
      }
    }
  3. 或使用 API 金鑰

    適用無法登入的用戶端、腳本和 CI:到 Settings → API keys 建立具備所需權限範圍的金鑰,以 Bearer token 傳送。

    .mcp.json
    {
      "mcpServers": {
        "yoh": {
          "type": "http",
          "url": "https://www.yoh.app/api/mcp",
          "headers": { "Authorization": "Bearer ${YOH_API_KEY}" },
          "timeout": 900000
        }
      }
    }
  4. 確認連線

    請代理執行 get_credits,它應該會回覆你的 Yoh 點數餘額。在 Claude Code 或 Codex 中執行 /mcp 可查看伺服器狀態。

接著直接開口

  • “做一支 60 秒的故事:一位聽得見鬼魂聲音的夜班護理師。”
  • “把這份劇本改成五集的系列,畫任何東西之前先給我看角色陣容。”
  • “精修第 3 集:剪掉空檔,把字幕對到節拍上,然後幫我報價輸出。”
  • “把片段 4 的主角換成我的角色,只重做那個片段的影片。”

為什麼好用

工具涵蓋範圍

故事與系列、拆成集數的劇本與 PDF、角色、場景與道具、片段圖片與影片、配音與對嘴、音樂與音效、時間軸(移動、修剪、分割、字幕、疊加層)、輸出、發布、範本以及委託創作者。

沒有你的同意,不會扣任何點數

瀏覽和編輯都免費。每個會花點數的步驟(畫圖、生成片段影片、輸出)都會先回傳價格。代理會先給你看,你核准後才繼續,同一次核准也不會被重複扣款。

依權限範圍存取

金鑰和登入都帶有權限範圍(stories:read、stories:write、stories:generate、series、assets、hires、ads),只能讀取的代理絕對無法花費或修改任何東西。

可接續的長時間工作

生成和輸出會以持久性工作執行:啟動一次,用 get_job 或 get_run 查詢進度,用 cancel_generation 停止。重複送出同一個核准會接上同一次執行,不會重複扣款。

常見問題

Yoh MCP 伺服器的網址是什麼?

https://www.yoh.app/api/mcp(streamable HTTP)。用你的 Yoh 帳號登入,或以 Bearer token 傳送 API 金鑰。

哪些用戶端可以用?

任何支援遠端 HTTP 伺服器的 MCP 用戶端:Claude Code、Claude desktop app、claude.ai、Codex、ChatGPT、Cursor、搭配 GitHub Copilot 的 VS Code 等。

MCP 伺服器免費嗎?

連接、瀏覽和編輯都免費。生成和輸出會使用你的 Yoh 點數,而且每個付費步驟都需要你明確核准報價。

也有 REST API 嗎?

有。同一個帳號可以用 API 金鑰呼叫 /api/v1 的 REST API;請見 API 頁面和文件。

完整說明: Yoh 文件 · 價格

其他連接方式