ToRun MCP 伺服器
最後更新於 11 11月 2026
這是什麼
ToRun MCP 伺服器讓程式開發代理在處理你的專案時使用 ToRun。支援遠端 MCP 伺服器的代理，例如 Claude Code、Cursor 或 opencode，可以產生圖片、語音、音樂與影片，編輯圖片，轉錄音訊，執行深度研究和 ToRun 的工作流程範本，並將 HTML 頁面或瀏覽器遊戲發布為連結，而你不必離開編輯器。代理製作的內容會以與應用程式相同的價格從你的 ToRun 帳戶付費，並像你在應用程式中製作的任何內容一樣儲存在你的 ToRun 帳戶中。
位址與登入
| 伺服器位址 | https://mcp.torun.ai/mcp |
| 傳輸方式 | HTTP（遠端 MCP 伺服器） |
| 登入 | Authorization: Bearer <your developer key> |
開發者金鑰以 trn_live_ 開頭。你可以在 ToRun 帳戶的開發者頁面上建立它：請參閱開發者金鑰。各工具的設定：
工具
| 工具 | 功能 | 付費 |
|---|---|---|
image_generate |
根據提示詞產生圖片：角色圖、圖示、背景、插畫。回傳圖片；如果耗時超過代理選擇的等待時間，則回傳工作 ID。 | 是 |
image_edit |
依照文字指示修改圖片：換新背景、換顏色、加入或移除物件、換風格。圖片可以是代理用 ToRun 產生的圖片，也可以是指向不超過 20 MB 的 PNG、JPEG 或 WebP 檔案的連結；以連結提供的圖片會先儲存到你的 ToRun 資料庫中。與 image_generate 一樣，回傳圖片或工作 ID。 |
是 |
tts_generate |
把文字轉成語音，並回傳音訊檔及根據檔案測得的播放長度。 | 是 |
stt_transcribe |
把音訊或影片檔中的語音轉成文字，代理要求時還會提供附時間標記的字幕片段。接受不超過 25 MB 的 mp3、m4a、wav、webm、ogg、opus、flac、aac 和 mp4 檔案。 | 是 |
music_generate |
創作一首有或沒有人聲的音軌，並回傳工作 ID。 | 是 |
video_generate |
根據提示詞產生一段短片，並回傳工作 ID。 | 是 |
job_status |
回報圖片、音樂或影片工作的進度，並在檔案完成時回傳檔案。 | 免費 |
deep_research_start |
針對一個問題啟動深度研究：在網路上搜尋眾多來源，並撰寫註明來源的報告。回傳工作 ID。 | 是 |
deep_research_status |
回報深度研究的進度，並在報告完成時回傳報告。 | 免費 |
workflow_template_search |
尋找 ToRun 的工作流程範本（現成的多步驟流程），並顯示每個範本輸出什麼、通常花費多少，以及接受哪些輸入。 | 免費 |
workflow_run |
以代理提供的輸入執行工作流程範本，並回傳工作 ID。 | 是 |
workflow_run_status |
回報工作流程執行的進度和到目前為止花費的 Runs，並在結果完成時回傳結果。 | 免費 |
canvas_publish |
將單一檔案的 HTML 頁面或瀏覽器遊戲發布為連結。 | 免費 |
account_balance |
顯示剩餘的方案額度和錢包餘額，以及這把金鑰的每月上限和已花費金額。 | 免費 |
工具回傳的檔案連結不必登入即可下載，因此代理可以把檔案儲存到你的專案中。請保留完整連結，包括問號後面的部分。
發布的頁面是不公開的：任何擁有連結的人都能開啟，但它不會顯示在 ToRun 的探索中，搜尋引擎也不會索引它。
長時間工作
音樂、影片、深度研究和工作流程執行所需的時間比一次呼叫更長。工具會回傳一個工作 ID，代理會再次查詢，直到結果完成：圖片、音樂和影片用 job_status，研究報告用 deep_research_status，工作流程執行用 workflow_run_status。在代理選擇的等待時間內沒有完成的圖片也會以工作 ID 的形式回傳。
一次研究需要 1 到 10 分鐘，即使與代理的對話結束也會繼續進行；報告也會以一個獨立的對話出現在你的 ToRun 聊天清單中。一次工作流程執行需要一分鐘到數十分鐘，執行及其檔案會出現在你的 ToRun 帳戶中。較長的報告或較多的結果會分段回傳，代理會要求其餘部分。
呼叫如何付費
- 每次付費呼叫都以 Runs 依與應用程式相同的價格計費。
- 先從你的方案額度支付，如果你在金鑰上允許，再從你的錢包支付。
- 免費額度從不支付 API 呼叫。
- 工作流程執行會在執行過程中逐步計費。
- 每筆費用都會顯示在你的帳務頁面上，歸在產生它的金鑰下。
超過金鑰門檻的呼叫會先詢問
每把金鑰都有一個門檻。當單次呼叫的費用超過門檻時，工具暫時不會執行它。對於工作流程執行，比較的是該次執行的估算費用。
- 如果你的工具能在 MCP 伺服器提問時顯示表單（MCP elicitation），ToRun 會在那裡詢問你：表單顯示價格並詢問是否繼續。你同意，呼叫就會執行；你拒絕，則什麼都不會執行。
- 否則，工具會回覆價格，你的代理會把價格告訴你，只有在你同意後代理重新發出呼叫，呼叫才會執行。
詢問本身不收取任何費用。
限制
每把金鑰都有每月和每日消費上限，以及每分鐘呼叫次數限制。每個帳戶每天發布的頁面數量也有限制。金鑰的每月上限和門檻在建立時設定；預設值列在 torun.ai/developers 上。若要變更，請以你想要的設定建立一把新金鑰，並撤銷舊金鑰。
呼叫被拒絕時
| 代理收到的訊息 | 怎麼做 |
|---|---|
| 此呼叫需要開發者金鑰 | 確認 TORUN_API_KEY 包含完整的金鑰，以及金鑰沒有被撤銷。 |
| 方案額度已用完，且此金鑰不允許從錢包消費 | 等待額度更新，或建立一把允許從錢包消費的金鑰。 |
| 開發者金鑰只會消費付費方案的額度或錢包 | 儲值或訂閱。 |
| 此金鑰已達每月或每日消費上限 | 等到隔天或下個月，或建立一把上限更高的金鑰。 |
| 此金鑰一分鐘內的呼叫次數過多 | 稍等一下再試。 |
| 此金鑰沒有工具所需的範圍 | 金鑰的範圍無法變更。建立一把新金鑰：新金鑰擁有所有範圍。 |
| 檔案必須以 ToRun 資料庫 ID 或 https 連結指定，兩者只能擇一 | 只提供其中一個。 |
| 此帳戶的 ToRun 資料庫中沒有這個檔案 | 使用此帳戶的檔案。指向另一個帳戶檔案的 ToRun 連結同樣會被拒絕。 |
| 檔案太大、格式不受工具支援，或無法下載 | image_edit 的圖片：PNG、JPEG 或 WebP，不超過 20 MB。stt_transcribe 的檔案：mp3、m4a、wav、webm、ogg、opus、flac、aac 或 mp4，不超過 25 MB。連結必須不必登入即可下載。 |