用 Claude、Codex 與 Cursor 通過 MCP 制作分鏡和影片

先讓 Agent 整理鏡頭，再交給模型生成

Claude Code、Codex 或 Cursor 可以通過 Say Action MCP 操作你自己的項目和畫布，並提交圖像與影片任務。外部 Agent 負責理解你的要求；MCP 工具負責讀取、寫入和調用生成任務。模型能力與參考素材仍會影響結果。

先做一集、幾個鏡頭，檢查分鏡後再生成。本文講連接與運行邊界；已有英文 MCP 教程提供逐步示例，不在這裡重複整段對話。

在 MCP 頁創建密鑰並連接客戶端

打開 /mcp，選擇 Claude Code、Codex 或 Cursor 的接入卡片，點擊獲取密鑰並登入。在一次性密鑰弹窗中保存消費上限，再複制連接配置。以後到 /access-keys 管理權限、修改上限或撤銷密鑰。把 yc_live_ 密鑰保存在本機 ISAYACTION_API_KEY 環境變量中，不要發給 Agent 當作提示詞。

端點：https://isayaction.com/api/mcp；使用 Streamable HTTP，認證頭為 Authorization: Bearer yc_live_...。瀏覽器 Cookie 不能替代密鑰。

Claude Code（Unix shell）：claude mcp add --transport http isayaction https://isayaction.com/api/mcp --header "Authorization: Bearer $ISAYACTION_API_KEY"

Codex：codex mcp add isayaction --url https://isayaction.com/api/mcp --bearer-token-env-var ISAYACTION_API_KEY

Cursor 的 MCP 配置：{ "mcpServers": { "isayaction": { "url": "https://isayaction.com/api/mcp", "headers": { "Authorization": "Bearer ${env:ISAYACTION_API_KEY}" } } } }

無人值守 codex exec 需要在 ~/.codex/config.toml 的 [mcp_servers.isayaction] 中設置 default_tools_approval_mode = "approve"。這會允許工具自動執行；設置密鑰上限後再運行。客戶端审批設置與服務端扣費是兩回事。

按實際工具推進項目、劇本與畫布

先用 get_account 和 list_models 查看餘額與模型能力，再用 list_projects / create_project、list_canvases / create_canvas 選擇工作位置。讓 Agent 先把原劇本拆成集，再調用 import_script：它只導入調用方已經準備好的集，不調用模型拆集。list_units 和 get_unit_workspace 用於查詢劇本單元；set_unit_shots、create_shot、revise_shot 用於整理鏡頭。

畫布編輯前讀取 canvas_list_node_types 與 canvas_get_state；用 canvas_create_storyboard 創建表格，canvas_read_storyboard 讀取行，canvas_edit_storyboard 修改鏡頭，canvas_apply_ops 可添加節點、更新允許的字段和建立連線，不支援刪除或移動已有節點。需要快照的寫入使用當前 snapshotHash，完成後用 get_canvas_link 返回可打開的畫布。

確認鏡頭與模型後，用 generate_media 提交任務，再用 get_generation 或 wait_generations 查詢結果；list_recent_generations 查近期任務。retry_generation 是新的生成嘗試，可能再次計費。示例要求：“先把這場戲拆成三個鏡頭，保留臺詞，返回畫布鏈接；我檢查後再生成影片。”

直接扣積分，密鑰默認不限額

MCP 收費調用直接扣積分，服務端不會逐次等待你確認。新密鑰默認不限額；Agent 循環、誤操作或密鑰泄露都可能持續產生費用。外部客戶端的訂閱或模型費用另計。內置 Agent 的任務預算與訪問密鑰的累計上限也不是同一個設置。

在密鑰弹窗點擊“保存消費上限”，或到 /access-keys 點擊“修改上限”並保存。上限按此密鑰累計，不按月重置，退款與密鑰輪換不重置用量；密鑰頁在 80% 與 100% 顯示用量警告。開啟“API 額度提醒”後，服務還會創建對應通知；郵件送達取決於郵件配置。達到上限會拒絕新的收費調用。設為 0 可阻止收費調用，但不會取消已經提交的任務。

積分按渠道定價預估；實際扣除以後臺配置的價格檔為準。 影片按秒計費為按請求秒數預授權；若上游實際產出時長超出請求，可能產生少量讓利差額。

上游明確返回失敗時會退回預留積分；網絡狀態不明確的任務先保留待核對狀態，避免重複結算。

網絡重試與重新生成要分開處理

所有寫入工具（包括收費生成工具）要求 8–128 字符的 idempotencyKey。相同操作遇到網絡錯誤時，重用原來的鍵與完全相同的參數；不要換鍵盲目重交。改變參數是另一項操作，需要新的鍵。

遇到 idempotency_key_pending 先等待並查詢；outcome_unknown 表示結果未知，先檢查任務或對象現狀，不能自動重做。已經保存的結果會返回原結果；idempotency_key_conflict 表示同一鍵被用於不同參數。把任務 ID 留在記錄裡，便於用 get_generation 查清狀態。

密鑰只交給受信任的客戶端

密鑰代表你的權限，按需要選擇 scope。密鑰只在創建或輪換時顯示；不要放進公開倉庫、共享配置、截圖、畫布或聊天記錄。環境變量用於本機配置，不代表可以把終端截圖公開。

不再使用時到 /access-keys 撤銷密鑰；懷疑泄露時立即撤銷或輪換，並查看用量和任務。客戶端可以提交提示詞與參考素材，運行前先檢查它將使用哪個項目、模型和密鑰。

連接自帶模型與第三方中轉站

喺模型渠道設定填寫 Base URL 同 API Key，按供應商文件設定協議、模型 ID 同所需 Header。先確認文字生圖、圖片轉影片等功能，再開始生成；接口路徑、解像度同首尾幀參數以實際渠道為準。未支援嘅渠道可提交適配申請，申請唔代表已相容。

BYOK 支援自訂 API 地址、模型金鑰同 Header。使用 OneAPI、NewAPI 等中轉站時，要揀與實際接口相符嘅 OpenAI、Gemini 或 Claude 協議，並核對模型 ID 同圖片、影片接口；唔係所有中轉站或私有協議都可直接使用。BYOK 模型調用唔加收平台模型費用，亦唔扣平台生成積分；工作空間服務同供應商模型費用仍分開收取。

只連接你信任嘅渠道，正式環境使用 HTTPS。自訂請求會經已登入嘅後端轉發；所需提示詞、參考素材同憑證會參與請求。唔好將 API Key、密碼或含金鑰嘅 Header 放入公開畫布、截圖或客服申請。