Runway Dev 外掛串接 Cursor：MCP、技能、API 金鑰與生成費用怎麼分？

Runway Dev 是把 Runway 開發者帳號與 API 整合知識帶進編程代理的官方外掛。API 是讓應用程式呼叫服務的介面，外掛則協助代理理解這個介面如何使用。

Runway 在 2026 年 11 月 2 日透過官方 X 宣布登上 Cursor。對想在自己的產品加入影片、圖片或音訊生成的開發者，這項更新縮短的是找文件與設定整合的距離。

官方儲存庫把帳號連線與七個技能放在同一套件裡。MCP 負責讓代理查詢開發者平台，技能則提供寫程式時要遵循的流程，兩者處理不同工作。

因此，安裝外掛不會自動替應用程式填好金鑰，也不會自動建立 Runway 帳號。真正產生內容時，仍要依帳號條件與呼叫的服務支付費用。

不同編程工具的整合也有差別。Claude Code 使用專用連線端點，而且不提供直接建立新分身的工具，不能把 Cursor 的示範當成所有工具完全相同的操作。

這套外掛適合已確定要串接生成服務、願意檢查權限與用量的開發者。它能提供整合起點，應用是否可交付仍要回到自己的程式與實際任務驗收。

要看懂安裝後多了什麼，先分清開發者控制台操作，以及使用者應用程式執行生成的兩條路徑。

Runway Dev 的 MCP、技能與 SDK 各負責什麼？

三者分別提供帳號資訊、整合方法與程式呼叫方式，因此不能只靠其中一個，就推定整套應用已經完成。

依 Runway 官方儲存庫 README，Runway Dev MCP 能連接開發者平台帳號，查詢可用模型、價格和限制，也能檢查失敗任務及模型路由決策。

MCP 可以理解成代理使用外部工具的共同連接方式。它讓代理取得帳號相關資訊，但不等於應用程式日後所有生成請求，都要經過同一個代理對話。

技能則是給代理閱讀的任務規範，協助它選擇文件、處理憑證、串接非同步任務與回報錯誤。因為不同表面功能有不同呼叫方式，官方把它們拆成多個技能。

SDK 是供應商提供的程式開發套件，讓開發者用較一致的方法呼叫 API。外掛教代理怎麼把 SDK 接進專案，產出的應用仍需要自己的執行環境與帳號設定。

例如，一個影片製作網站可以讓使用者送出文字，後端呼叫生成服務，再把結果顯示在網頁。編程代理負責協助建構這條流程，不能因為代理已登入控制台，就省略後端的服務連線。

這個例子是依官方分工說明應用架構，並非 AI 郵報實測專案。分清責任後，才容易判斷應該讓哪個技能處理眼前的需求。

七個技能如何對應模型、路由與既有工作流程？

選擇技能應從應用要完成的工作出發，因為直接產生一支影片，和呼叫已發布的工作流程，所需整合資訊並不相同。

設定技能先處理帳號與專案連接，共用基礎技能則交代伺服器邊界、文件、憑證、任務與錯誤。這些是其他生成方式共同需要的條件。

若應用要直接呼叫特定模型，就使用模型整合技能。若希望依成本、速度或品質安排模型選擇，則需要模型路由器相關技能，而不是在程式裡猜測目前有哪些型號。

模型路由器是替請求安排模型選擇的設定。官方 MCP 能協助建立並調整路由器，也提供選用的額度上限，但上限與路由條件仍要由開發者確認。

即時角色的技能處理 Characters 與 Sessions，也就是角色與連線工作階段。它和影片生成任務不同，不能只替換一個模型名稱，就假設互動方式完全一致。

Recipes 技能對應文件所列的管線，Workflows 技能則用來呼叫已發布的 Runway 工作流程。因此，既有流程能否被呼叫，還要確認它的發布狀態及 API 契約。

以下用工作需求整理分工，實際名稱與可用功能仍以官方文件為準。

表格呈現的是選擇文件的起點，沒有把所有功能包成一個固定生成指令。選對整合方向後，還要確認目前使用的編程工具到底安裝了哪些部分。

Cursor、Claude Code、Codex 與 Replit 的安裝範圍有何不同？

同一套官方儲存庫提供多種主機路徑，但外掛、單獨技能與 MCP 連線並非互相等價，應避免把不完整安裝當成產品故障。

Cursor 的根目錄外掛設定會選取開發技能及 MCP 連線。官方也提供單獨 MCP 的方式，但只加入連線，不會自動把七個整合技能一起安裝。

反過來，單獨放入技能也不會自動完成 MCP 設定。因此，代理可能知道怎麼寫程式，卻還沒有帳號資訊；也可能查得到控制台，卻缺少對應的整合規範。

Claude Code 的外掛放在獨立目錄，連到專用的 Claude 端點。官方明列該端點省略 create_avatar，使用者需要到開發者平台建立新的虛擬分身。

這個版本的技能以本機檢查驗證整合，實際生成、角色工作階段及流程呼叫留給使用者的應用執行。因此，本機程式檢查通過，和真的完成付費生成，是不同的驗收結果。

官方 README 也指出，Runway 維護的市集和 Anthropic 管理的官方目錄可能固定在不同版本。遇到功能差異時，先核對安裝來源與版本，比反覆重裝更有幫助。

Codex 有註冊儲存庫與安裝外掛的開發路徑，也能輸出套件。但套件驗證和原生登入是兩項檢查，公開目錄是否可見還涉及各主機的提交與審查。

Replit 則將 MCP 連線與 Agent Skills 分開散布，需要分別處理授權與技能安裝。相同功能名稱，不能推導出所有工具都已在公開目錄同步上架。

因此，第一次驗收應記錄主機、來源與實際載入的能力。當工具都找得到之後，才進入帳號連接與應用金鑰的設定。

為什麼瀏覽器登入與應用程式金鑰要分開？

兩種憑證對應不同使用者與執行位置，分開管理才能清楚知道哪個程式在取得資訊，以及哪個程式實際發出生成請求。

依 Runway 官方 MCP 連接指南，MCP 使用瀏覽器 OAuth 連接。OAuth 是由使用者在服務頁面登入並同意連線的方式，官方要求不要把 API 金鑰放進 MCP 設定。

應用程式則使用自己的伺服器端 RUNWAYML_API_SECRET。這個名稱是環境設定的識別，不是要讀者把真實金鑰填進文章中的範例或對話。

因為前端程式會送到訪客瀏覽器，金鑰若被打包在其中，就可能被取得。因此，官方要求把應用金鑰留在伺服器端，也不要貼進聊天室或提交到原始碼版本控制。

在前述影片網站的假設例子裡，瀏覽器只需要把使用者需求送給網站後端。後端再用自己的憑證呼叫服務，網站也才能在這一層管理誰可以使用生成能力。

這種分工還有助於排查錯誤。MCP 能登入，代表控制台連線已完成；後端缺少金鑰時，應用仍可能無法生成，兩者並不矛盾。

所以，安裝驗收可以先確認文件與工具可用，再確認應用設定存在，最後才安排獲得授權的實際呼叫。這樣比較容易區分設定問題與模型服務問題。

模型路由、非同步任務與費用應如何一起驗收？

生成服務常需要等待任務完成，因此應用不只要送出請求，還要能顯示進度、接回結果並處理失敗，費用也需要放進同一條流程觀察。

非同步任務的意思，是請求送出後，結果可能稍後才回來。若應用只顯示送出成功，使用者可能不知道內容仍在處理，或誤以為失敗而再次送出。

官方基礎技能涵蓋任務與錯誤，MCP 也可協助檢查失敗任務和路由決策。這讓開發者有機會把畫面上的問題，對回實際服務狀態，而不是只修改一段提示詞。

但代理查到失敗原因，仍不等於任何重試都可以直接執行。應用需依當期任務文件處理重試與用量，避免把使用者的一次需求變成多次未預期呼叫。

README 刻意不固定模型目錄與價格表，因為可用項目會變動。實作前應查 Runway 開發文件 及帳號可見的最新條件，不能把舊範例的模型名和價格當成永久契約。

若使用模型路由器，驗收時就要檢查規則是否真的對應需求，以及選用的額度上限如何生效。更快或更便宜的選擇，仍需符合輸出品質和應用可接受的等待時間。

這些是依官方分工提出的工程檢查方向，並非本篇已測出某種最佳組合。對準備正式交付的團隊，一次可追溯的小規模驗收，比只看到整合程式碼更接近完成標準。

一個生成需求應留下哪些可追蹤的結果？

仍以前述影片網站作為假設情境，驗收可以從一個已核准的輸入開始，記錄應用送出了哪個需求、採用哪條模型路徑，以及最後顯示了什麼結果。這讓控制台資訊能對回使用者的操作。

如果畫面顯示失敗，開發者可先用任務資訊區分輸入不合條件、服務處理失敗，還是結果沒有正確接回網頁。不同原因需要修改的地方不同，不能一律把錯誤訊息換成「請再試一次」。

若使用者重新開啟頁面，應用也需要清楚呈現原任務是否仍在處理。這是把非同步服務接到產品時要設計的行為，不能把外掛能讀取任務，理解成前端已經自動具備完整進度管理。

同一項驗收也應核對輸入素材與輸出用途。例如，訪客上傳的圖片可能包含不適合交給外部服務的內容，所以應用需要自己的告知與處理範圍，而不是沿用編程代理登入時的同意。

官方外掛的職責是提供整合能力，產品如何對自己的使用者開放，仍由應用團隊設計。因此，團隊應把開發者平台連線成功，以及訪客能完成受控生成，列成兩個可觀察結果。

當這條流程能對上需求、任務、結果與用量後，再增加其他模型或管線會較容易排錯。先擴大功能清單、最後才補追蹤，則可能讓同一個畫面錯誤對應到多種不同後端問題。

Runway Dev 外掛常見問題

安裝 Runway Dev 後就有免費生成額度嗎？

官方沒有把外掛安裝定義成自動開立帳號或發放免費額度。應用的 API 生成可能消耗 Credits，實際條件應在開發者平台核對。

只把 MCP 連進 Cursor，就等於安裝整套技能嗎？

不等於。MCP 連線與程式整合技能各自負責一部分，官方 README 明列單獨 MCP 不會自動安裝技能，單獨技能也不會自動設定 MCP。

Claude Code 能直接建立新的即時虛擬分身嗎？

官方 Claude 專用端點省略建立分身的工具，使用者要在 Developer Portal 建立新分身。角色建立與應用整合需要分別確認。

本機測試通過，是否代表影片已成功生成？

本機測試可以確認程式結構或整合條件，實際生成仍要由應用呼叫服務。兩種結果應分別記錄，才能知道哪些工作已完成。

把帳號連接與應用交付接成完整流程

Runway Dev 的價值在於把最新平台資訊與整合方法帶到編程環境，讓開發者少在文件與編輯器之間來回。但最後仍要以自己的應用能否完成一個生成任務作為驗收。

準備加入影片或音訊功能的團隊，可以先選定一條用途，核對主機版本、權限和費用，再安排實際呼叫。想持續追蹤生成服務與編程代理的整合方式，歡迎免費訂閱 AI 郵報。

延伸閱讀：Runway Dev 是什麼？AI 影片競爭從單一模型走向多模型平台

延伸閱讀：Sunra MCP 是什麼？讓 Claude Code、Codex 生圖做影片，「原廠價」與最親民定價怎麼核對

原始資料來源

• Runway 官方儲存庫與 README
• Runway 官方 MCP 連接指南
• Runway 開發文件
• Runway 官方 Cursor 發表貼文