通過 MCP 創作 AI 分鏡與短劇
Say Action 是可由 AI Agent 直接操作的 AI 分鏡 MCP 服務:劇本 → 拆集 → 分鏡 → 角色 → 生成 → 成片。在 Claude Code、Codex 或 Cursor 中描述需求,Agent 就會搭建節點、連線和分鏡,結果隨執行實時出現在你打開的畫布上。
https://isayaction.com/api/mcp讓 AI Agent 幫你做 · MCP / API
claude mcp add --transport http isayaction https://isayaction.com/api/mcp --header "Authorization: Bearer $ISAYACTION_API_KEY"Agent 能做什麼
劇本拆集
把劇本整理成分集。
寫分鏡
為每集編寫鏡頭。
角色定妝
制作角色外觀參考。
批量生成
一次生成多個鏡頭。
搭畫布工作流
連接節點與生成步骤。
成片
將片段拼成影片。
一鍵委派站內 Agent
交給站內 Agent 創作。
試着這樣聊
幫我做一個 30 秒的猫咪短片分鏡並生成首幀。
Agent 創建畫布、寫鏡頭、連接節點並提交圖片任務。 generate_media(..., idempotencyKey=cat-frame-001).
把這個劇本拆成 12 集,給主角定妝。
Agent 導入分集、寫分鏡並制作角色參考圖。 create_project(..., idempotencyKey=script-project-001); generate_media(..., idempotencyKey=character-look-001). 專家檔:?profile=expert 後重新連接,並授予必要 scopes。
讓站內 Agent 補完這份分鏡,並拼成影片。
Agent 委派任務、查看進度,再把可用片段渲染成片。 agent_start(..., idempotencyKey=storyboard-agent-001); render_timeline(..., idempotencyKey=storyboard-render-001). 專家檔:?profile=expert 後重新連接,並授予必要 scopes。
各客戶端接入步骤
Claude Code
創建密鑰,在終端執行下方環境變量命令,再執行客戶端命令。重啟客戶端,要求它使用 isayaction。Windows 請用 PowerShell 環境變量命令;Claude Code 命令中的 $ISAYACTION_API_KEY 改為 $env:ISAYACTION_API_KEY。
claude mcp add --transport http isayaction https://isayaction.com/api/mcp --header "Authorization: Bearer $ISAYACTION_API_KEY"Codex
創建密鑰,在終端執行下方環境變量命令,再執行客戶端命令。重啟客戶端,要求它使用 isayaction。Windows 請用 PowerShell 環境變量命令;Claude Code 命令中的 $ISAYACTION_API_KEY 改為 $env:ISAYACTION_API_KEY。
codex mcp add isayaction --url https://isayaction.com/api/mcp --bearer-token-env-var ISAYACTION_API_KEYCodex 的無人值守執行需要設置审批模式。在 ~/.codex/config.toml 的 [mcp_servers.isayaction] 段加入下方配置;也可改為 "writes",讓只讀工具自動執行、寫入或扣費操作需確認。
default_tools_approval_mode = "approve"Cursor
點擊一鍵添加到 Cursor,確認安裝並重啟。公開配置需要在 Cursor 環境中設置 ISAYACTION_API_KEY;創建密鑰後可直接安裝已填入密鑰的配置。
{
"mcpServers": {
"isayaction": {
"url": "https://isayaction.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:ISAYACTION_API_KEY}"
}
}
}
}其他
把 JSON 粘贴到支援 Streamable HTTP 與 Authorization 請求頭的客戶端配置。在本機將 <YOUR_KEY> 替換為密鑰,重新連接並確認 isayaction 工具可用。
{
"mcpServers": {
"isayaction": {
"url": "https://isayaction.com/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_KEY>"
}
}
}
}計費與責任
MCP 調用直接執行,不逐次確認。收費、任務與創建工具必須提供 8–128 字符 idempotencyKey,重試時必須複用同一個 key 和原參數。付費模型與媒體用量直接扣積分,由密鑰持有人負責。可在密鑰頁設置累計消費上限;付費 MCP 錢包流水標註 MCP 來源。本地成片與轉寫當前不扣模型積分。外部客戶端自身的費用另計。
如何為密鑰設定消費上限
透過 MCP/API 的呼叫會直接扣積分;如果 Agent 出錯循環、誤操作或密鑰洩露,可能持續扣費。建議設定上限,例如 200 / 500 / 1000 積分,可隨時修改。留空表示不限。
平台不設定預設上限,新密鑰預設不限。建立時選擇 200 / 500 / 1000 積分,或輸入自訂上限;首頁及 MCP 的密鑰彈窗須按「儲存消費上限」。亦可隨時前往 /access-keys,按「修改上限」並儲存。上限按密鑰累計,不會每月重設;0 會阻止收費呼叫,退款與輪換密鑰不會重設已用額度。
修改上限安全使用密鑰
密鑰只通過 Authorization 請求頭鉴權,不要放入共享鏈接、提示詞或截圖。可在密鑰頁隨時吊銷;已提交的任務可能繼續完成。只在可信客戶端中安裝密鑰。
管理 API 密鑰常見問題
支援 Claude Desktop 或 claude.ai 嗎?
其自定義連接器需要 OAuth,本期尚未提供。請使用 Claude Code、Codex、Cursor 或兼容 HTTP 客戶端。
必須一直打開畫布嗎?
服務端任務可在瀏覽器關閉時繼續執行。登入並打開畫布可觀察同步結果;後臺標簽頁或網絡延遲可能推遲更新。
每次生成都需要確認嗎?
不需要。MCP 授權的生成和站內 Agent 委派可直接消費積分,請在授予訪問前設置密鑰消費上限。
可以限制或撤銷訪問嗎?
可以。在密鑰頁選擇權限和消費上限,或吊銷密鑰。密鑰僅訪問持有人資源,不開放管理後臺或支付。 新接入使用 default 常用檔;expert 為完整目錄,實際工具按權限減少。舊密鑰保持 expert。進階流程在 URL 加 ?profile=expert 後重新連接,檔位不授予權限。
