Scenaloom MCP 工具參考

這裡列出 Scenaloom MCP 伺服器提供給已連結 AI 應用程式的每一個工具，以及各自需要的權限。工具名稱和應用程式讀取的說明都是英文，但應用程式會用你的語言回答你。要連結應用程式，請見把 Scenaloom 接上 AI 應用程式。

工具

工具	權限	用途
list_projects	讀取	列出寫作者的專案，最新的排在最前面，可以用關鍵字或類型（劇本、小說、影片）篩選。
get_project	讀取	取得專案的標題、簡介、類型、寫作者的角色、各集與場次數，以及角色、地點和未解決評論的數量。
read_script	讀取	以區塊（場景標題、動作、角色、對白、括號提示、轉場、鏡頭）或 Fountain 格式讀取某一集的劇本，可以讀一段範圍或一次一場，並附上修改時需要的修訂版本和雜湊值。
list_scenes	讀取	依順序列出某一集的場次：場景標題、地點、出場角色、區塊範圍和摘要。
list_entities	讀取	列出專案的角色、地點或道具，包含詳細資料、出場次數和人物關係。
get_story_structure	讀取	取得節拍、專案大綱和單集大綱。
read_novel	讀取	取得小說的章節列表，或以每頁最多 40,000 字的分頁讀取單一章節的內文，並附上修改時需要的修訂版本。
search_project	讀取	在專案的劇本、小說、角色與地點、評論和節拍中搜尋某一行台詞、名字或詞句。
list_comments	讀取	列出專案中未解決或已解決的評論，包含評論位置、作者和寫下評論的應用程式。
list_generations	讀取	列出圖片、影片和音訊的生成任務，以及各自的狀態和積分。
get_generation	讀取	取得單一生成任務的狀態、進度、已使用或已退還的積分，以及生成結果。
propose_script_edits	編輯	為某一集準備最多六項修改（插入動作、改寫一行、取代文字、全部取代、新增節拍），並回傳修改前後的預覽；在呼叫 apply_script_edits 之前不會改動任何內容。
apply_script_edits	編輯	套用寫作者核准的提案，修改會與即時編輯合併、記錄在版本歷史中，而且可以復原。
undo_script_edits	編輯	復原一批已套用的修改，除非之後的修改與它衝突。
propose_novel_edits	編輯	為單一章節準備尋找並取代的修改，或要接在章節後面的段落，並回傳預覽；每一段要尋找的文字都必須只出現一次。
apply_novel_edits	編輯	套用已核准的小說提案，並與同時在這一章寫作的其他人合併。
undo_novel_edits	編輯	把已套用的小說修改從章節中撤回，之後新寫的內容都保留；若有人改過被修改的文字，就不復原。
update_entity	編輯	修改人物、場景或道具的詳細資料。讀取後若有人改過該條目，會被拒絕。作者可在一天內從 AI 面板復原。
undo_entity_update	編輯	復原 update_entity 做出的修改；若這些欄位之後又被改過，就不復原。
create_project	編輯	在寫作者方案的上限內，建立劇本或小說專案。
create_episode	編輯	在劇集中新增一集。
add_comment	評論	在劇本區塊上留下評論，並標明由已連結的應用程式所寫；協作者只有在寫作者確認後才會收到通知。
resolve_comment	評論	把評論標為已解決，或重新開啟。
get_credits	使用積分	取得寫作者的積分餘額和方案、這個應用程式的花費設定和每日上限，以及它今天已花費的積分。
quote_generation	使用積分	替圖片、影片或音訊生成估價而不花任何積分，回傳一份五分鐘內有效、只能使用一次的報價。
start_generation	使用積分	在寫作者確認費用後，花費報價中的積分並開始生成。
cancel_generation	使用積分	取消進行中的生成，積分依積分政策退還。

讀取類工具不會改動任何東西。編輯類工具只會透過你核准的提案修改作品，每一批套用的修改都可以復原。唯一會花積分的工具是 start_generation，而且要在你確認報價之後才會執行。

一次修改的流程

應用程式用 read_script 讀取場次，取得每個區塊的 id 和劇本目前的修訂版本。
它呼叫 propose_script_edits，最多提出六項修改。Scenaloom 檢查之後，為每一項回傳修改前後的預覽；提案會保留 30 分鐘，也會顯示在編輯器的「Scenaloom AI」面板裡。
應用程式把預覽拿給你看。你同意後，它再呼叫 apply_script_edits。如果這段期間有人改過劇本，套用會被拒絕，應用程式必須重新讀取。
結果會列出這批修改的 id。用這個 id 呼叫 undo_script_edits 就能撤回整批修改；不論是否撤回，版本歷史都會保留先前的草稿。

小說也是同樣的流程，使用 read_novel、propose_novel_edits 和 apply_novel_edits：每一段要取代的文字在章節中都必須只出現一次，所以修改絕不會落在錯的地方。

生成怎麼付費

quote_generation 會替請求估價，不花任何積分，並回傳一份五分鐘內有效、只能使用一次的報價。
應用程式告訴你費用和扣款後的餘額，等你同意才呼叫 start_generation。支援確認功能的應用程式會顯示 Scenaloom 自己的確認畫面；其他應用程式只能在你設定的每日上限內花費。
get_generation 會回報進度和結果。如果報價之後價格有變動，Scenaloom 會拒絕開始；生成失敗時，依照積分政策退還積分。

資源與提示詞

能瀏覽資源的應用程式，可以把專案、以 Fountain 格式呈現的某一集、小說章節，或專案的故事設定集（角色、地點、道具、人物關係、節拍和大綱）附加到對話中。提示詞則用來啟動常見的工作：劇本診斷、節拍結構建議、改寫一場戲、讀本筆記，以及一句話故事與故事梗概。提示詞的標題會跟著你的 Scenaloom 介面語言顯示。

應用程式可能回報的錯誤

訊息	處理方式
提案之後劇本已變更	重新讀取這場戲，再提案一次。
權限範圍不足	應用程式缺少某項權限。請在「已連結的應用程式」中中斷它的連結，再重新連結並勾選該權限。
找不到	專案已被刪除，或你已經沒有存取權限。
這個應用程式無法確認花費	替這個應用程式設定每日積分上限，或直接在 Scenaloom 裡開始生成。
請求過於頻繁	等候訊息中指定的秒數，再重試一次。