AI 影片專用的 Yoh MCP 伺服器
一個遠端 MCP 端點,就讓任何代理用上完整的 Yoh 工作室:寫故事、選角並畫出角色、生成含配音與音樂的片段影片、編輯時間軸與字幕、輸出並發布。每個工具都遵循和 yoh.app 編輯器相同的規則。
連接任何 MCP 用戶端
使用這個網址
Streamable HTTP,以 OAuth 登入。請完全照抄含 www 的網址:沒有 www 的 yoh.app 會被轉址,而登入會檢查網址。
https://www.yoh.app/api/mcpClaude Code、Codex、Cursor、ChatGPT
每個登入指令都會開啟瀏覽器讓你登入 Yoh。Cursor:把 yoh 項目合併到 ~/.cursor/mcp.json,Cursor 詢問時登入。ChatGPT:加入自訂 MCP 伺服器並登入。Claude 桌面版和 claude.ai:加入自訂連接器。
Claude Codeclaude mcp add --transport http --scope user yoh https://www.yoh.app/api/mcp claude mcp login yohCodexcodex 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" } } }或使用 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 } } }確認連線
請代理執行 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 頁面和文件。
其他連接方式
- 用 Claude 做 AI 影片把 Claude 連上你的 Yoh 帳號,開口就能做影片故事。Claude 會寫劇本、維持角色一致、生成片段、編輯時間軸並輸出完成的影片,任何要花點數的步驟都會先問過你。
- 用 Codex 做 AI 影片把 Codex 連上 Yoh,直接從終端機或編輯器製作影片故事:劇本、選角、片段、配音、字幕到最後輸出,每個付費步驟都會先顯示價格,經你核准才進行。
- AI 影片生成 API送出一段提示詞,拿回完成的影片:Yoh 會寫劇本、安排一致的角色、加上配音、音樂和字幕,並輸出 MP4。也可以自己掌控每一步:故事、系列、片段、角色、時間軸和輸出。
- 給 AI 代理的 Yoh 技能MCP 伺服器給代理工具,技能教它手藝。一份採用開放 Agent Skills 格式的 SKILL.md,告訴代理怎麼把 Yoh 故事做好,以及哪些規則容易出錯。