部落格 產品對比 術語集錦
造訪官網
← 返回部落格

Cursor 連上 Cocos Creator MCP 後壞了？按症狀排查連不上

Cursor 接 VberAI Cocos Creator MCP 後像「壞了」：MCP 列表無服務、紅錯、已連但無工具。先從 Cursor 側核對，再按四層鏈路跳到 Creator 擴充、啟用與連接埠排查。

發布於 · Updated
  • cocos
  • cocos-creator
  • mcp
  • cursor
  • troubleshooting
  • cocos-mcp

摘要

Cursor 接 VberAI Cocos Creator MCP 後像「壞了」：MCP 列表無服務、紅錯、已連但無工具。先從 Cursor 側核對，再按四層鏈路跳到 Creator 擴充、啟用與連接埠排查。

正文

裝好 Cocos MCP 並在 Cursor 裡配過一次之後，很多人的直覺是「Cursor 壞了」：對話裡碰不到場景、MCP 面板一片紅、或昨天還能用今天突然沒了。多數情況下，Cursor 本體並沒有損壞，而是 MCP 橋沒通——Creator 側服務未運行，或 Cursor 側設定/重新載入未生效。

本文從 Cursor 裡能看見的症狀 下手，盡快判斷該查哪一層。Creator 擴充匯入、啟用碼、連接埠占用等長步驟，見通用排障：Cocos MCP 連線失敗排查。若還不清楚 MCP 是什麼，見：Cocos Creator MCP 是什麼。

先分清：壞的是 Cursor，還是橋

你的感受更可能的原因
Cursor 能寫普通程式碼，但碰不到 Cocos 場景/節點MCP 未連線或工具未啟用
MCP 面板裡沒有 cocos-creator（或面板顯示的服務名）設定未寫入，或需 Reload
有服務名但是錯誤 / 斷開狀態Creator 未 Running、URL/連接埠不對、或需重新載入
顯示已連線，但列不出目前場景節點連錯專案、工具未勾選、或唯讀驗證方式不對

Claude Code、Codex 等 MCP 用戶端的核對邏輯類似：先確認用戶端裡服務存在且健康，再查 Creator。

步驟 1：只看 Cursor 裡的 MCP

在 Cursor 開啟 MCP / 工具相關設定（具體選單位置隨版本可能略有差異），檢查：

  1. 列表裡是否出現 cocos-creator（或以面板「快速設定」寫入的名稱為準）
  2. 狀態是否為已連線 / 可用，而不是持續錯誤、斷開或空白
  3. 若剛改過設定或剛在 Creator 裡點過「自動設定」：執行一次 Reload Window（或等價的 MCP 重新載入），再看列表

常見情況是：Creator 側已經「運行中」，但 Cursor 仍握著舊設定——不重新載入就會像「突然壞了」。

步驟 2：核對位址是否指向本機 Creator

Cursor 側 MCP 條目應指向 本機 橋接位址，通常形如：

  • http://127.0.0.1:3000/mcp
  • 或 http://localhost:3000/mcp

連接埠以 Creator 裡 MCP 面板顯示為準（預設多為 3000，改過則以面板為準）。

同時開啟 Cocos Creator，確認同一專案裡 MCP 面板為 運行中。若面板未運行，Cursor 再怎麼 Reload 也不會出現可用工具。

產品頁（按專案大版本選包，勿混用）：

步驟 3：仍失敗時，按四層跳轉

MCP 鏈路可拆成四層。任一層失敗，在 Cursor 裡都可能表現為「壞了 / 連不上」：

1. 外掛已進專案且已啟用
        ↓
2. 面板已啟用（帳號/啟用碼）
        ↓
3. MCP Server 顯示「運行中」（本機 localhost）
        ↓
4. Cursor 已寫入設定且 MCP 列表顯示已連線
Cursor 裡看到的優先去哪
完全沒有服務條目第 4 層：回到 Creator 用「快速設定 → 自動設定」，再 Reload；細節見通用排障
有條目但是錯誤 / 連不上第 3 層：Creator 是否 Running、連接埠是否一致、localhost 是否被攔
Creator 選單裡就沒有 MCP第 1 層：2.x/3.x 包是否混用、匯入路徑、是否重啟（見通用排障症狀 A）
面板打不開服務 / 未啟用第 2 層：帳號與啟用（見通用排障）
已連線但列不出節點確認開啟了正確專案；先做下方唯讀冒煙；仍異常再查工具勾選

完整安裝：

步驟 4：冒煙驗收（確認「修好了」）

在 Cursor 裡先做一次唯讀確認，例如：

列出目前 Cocos Creator 開啟場景的根節點。

若回覆與編輯器層級一致，橋接可用。再視需要做一次可逆小寫入（如新建臨時節點並刪除）。大改前先提交版本；橋接只留在本機 localhost，不要把 MCP 連接埠暴露到公網。

常見問題

「Cursor 壞了」在 Cocos Creator MCP 之後通常代表什麼？
典型跡象：沒有 MCP 服務入口、紅色或錯誤狀態，或已連線但沒有工具/節點。多數情況並非 Cursor 崩潰，而是四層橋接中缺少某一層。

應該先檢查 Cursor 還是 Creator？
先從 Cursor 的 MCP 清單開始（缺少 vs 紅色）。接著驗證 Creator：外掛是否已匯入/啟用、面板是否啟動、伺服器是否 Running、連接埠是否與設定相符。使用本文中的症狀對照表。

已連線但沒有節點——下一步怎麼做？
確認開啟的是正確的專案/場景；執行唯讀冒煙測試（列出根節點）。若仍失敗，檢查工具開關與權限。完整路徑：連線疑難排解。

需要重新安裝 Cursor 嗎？
通常不需要。優先使用 Creator 的「快速設定 → 自動設定」、重新載入 MCP，並驗證 localhost 連接埠。分類邊界：什麼是 Cocos Creator MCP。

繼續閱讀

你可能還會喜歡這些文章