Cursor Bị Lỗi Sau Khi Cài Cocos Creator MCP: Sửa Theo Triệu Chứng

Sau khi bạn cài đặt Cocos MCP và cấu hình một lần trong Cursor, nhiều người cảm thấy Cursor bị hỏng: chat không thể chạm vào scene, bảng MCP toàn màu đỏ, hoặc hôm qua hoạt động tốt mà hôm nay biến mất. Trong hầu hết các trường hợp, bản thân Cursor vẫn ổn—cầu nối MCP bị sập. Hoặc máy chủ phía Creator không chạy, hoặc cấu hình / tải lại của Cursor chưa có hiệu lực.

Hướng dẫn này bắt đầu từ các triệu chứng bạn có thể thấy trong Cursor, để bạn biết nên kiểm tra lớp nào tiếp theo. Các bước dài về Creator (nhập extension, mã kích hoạt, xung đột cổng) nằm trong hướng dẫn chung: Khắc phục kết nối Cocos MCP. Nếu bạn vẫn cần ranh giới sản phẩm, xem Cocos Creator MCP là gì.

Đầu tiên: Cursor Hỏng, Hay Cầu Nối?

Cảm giác của bạn	Nguyên nhân có khả năng nhất
Cursor vẫn viết mã bình thường, nhưng không thể truy cập scene/nút của Cocos	MCP chưa kết nối hoặc công cụ chưa được bật
Danh sách MCP không có cocos-creator (hoặc tên từ Quick configure)	Cấu hình chưa được ghi, hoặc cần Reload
Tên service tồn tại nhưng báo lỗi / ngắt kết nối	Creator không chạy, sai URL/cổng, hoặc cần reload
Hiển thị đã kết nối, nhưng không thể liệt kê các nút của scene đang mở	Sai dự án, công cụ chưa được chọn, hoặc kiểm tra read-only không đúng

Claude Code, Codex và các MCP client tương tự cũng tuân theo ý tưởng tương tự: xác nhận client có một mục service khỏe mạnh, sau đó kiểm tra Creator.

Bước 1: Chỉ Xem MCP Bên Trong Cursor

Mở cài đặt MCP / công cụ của Cursor (nhãn menu có thể khác nhau tùy phiên bản) và kiểm tra:

1. Liệu cocos-creator có xuất hiện không (hoặc tên do Quick configure của Creator ghi)
2. Trạng thái có phải là connected / usable không—không bị kẹt ở lỗi, ngắt kết nối, hoặc trống
3. Nếu bạn vừa thay đổi cấu hình hoặc chạy Auto configure trong Creator: hãy Reload Window (hoặc reload MCP tương đương), sau đó kiểm tra lại danh sách

Một trường hợp phổ biến: Creator đã hiển thị Running, nhưng Cursor vẫn giữ cấu hình cũ—nếu không reload, cảm giác như “đột nhiên hỏng”.

Bước 2: Xác Nhận URL Trỏ Đến Creator Cục Bộ

Mục MCP trong Cursor nên trỏ đến một URL cục bộ của bridge, thường là:

• http://127.0.0.1:3000/mcp
• hoặc http://localhost:3000/mcp

Sử dụng cổng hiển thị trong bảng MCP của Creator (thường mặc định là 3000; nếu bạn đã đổi, hãy khớp với bảng).

Cũng mở Cocos Creator và xác nhận bảng MCP đang Running cho cùng dự án. Nếu bảng không chạy, Reload trong Cursor sẽ không kỳ diệu mà hiện công cụ.

Trang sản phẩm (chọn gói phù hợp với phiên bản chính của bạn; không trộn lẫn):

• Cocos MCP 3.x
• Cocos MCP 2.x

Bước 3: Nếu Vẫn Thất Bại, Nhảy Theo Lớp

Đường dẫn MCP có bốn lớp. Lỗi ở bất kỳ lớp nào cũng có thể trông như “Cursor bị hỏng / không kết nối được”:

1. Plugin trong dự án và được bật
        ↓
2. Bảng được kích hoạt (tài khoản / mã license)
        ↓
3. MCP Server hiển thị Running (localhost)
        ↓
4. Cursor có cấu hình được ghi và danh sách MCP hiển thị connected

Những gì bạn thấy trong Cursor	Hãy đến đây trước
Không có mục service nào	Lớp 4: quay lại Creator → Quick configure → Auto configure, sau đó Reload; chi tiết trong hướng dẫn chung
Mục tồn tại nhưng lỗi / không kết nối được	Lớp 3: Creator có Running không, cổng có khớp không, localhost có bị chặn không
Không có menu MCP trong Creator	Lớp 1: nhầm gói 2.x/3.x, đường dẫn import, khởi động lại (triệu chứng A trong hướng dẫn chung)
Bảng không khởi động được / chưa kích hoạt	Lớp 2: tài khoản và kích hoạt (hướng dẫn chung)
Đã kết nối nhưng không liệt kê được nút	Xác nhận đúng dự án đang mở; chạy kiểm tra read-only bên dưới; sau đó kiểm tra công tắc công cụ

Cài đặt đầy đủ:

• Cài đặt Cocos Creator 3.x MCP
• Cài đặt Cocos Creator 2.x MCP

Bước 4: Kiểm Tra Nhanh (Xác Nhận Đã Sửa)

Trong Cursor, hãy bắt đầu bằng kiểm tra chỉ đọc, ví dụ:

Liệt kê các nút gốc của scene hiện đang mở trong Cocos Creator.

Nếu phản hồi khớp với hệ thống phân cấp trong editor, bridge hoạt động. Tùy chọn, bạn có thể thực hiện một thao tác ghi có thể đảo ngược (tạo một nút tạm và xóa nó). Cam kết trước khi chỉnh sửa lớn; chỉ giữ bridge trên localhost—không để lộ cổng MCP ra internet công cộng.

Câu hỏi thường gặp

“Cursor bị lỗi” sau khi dùng Cocos Creator MCP thường có nghĩa là gì?
Các dấu hiệu điển hình: không có mục dịch vụ MCP, trạng thái đỏ/lỗi, hoặc đã kết nối nhưng không có công cụ/nút. Hầu hết các trường hợp không phải do Cursor bị sập—mà là do thiếu một lớp trong cầu nối bốn lớp.

Nên kiểm tra Cursor hay Creator trước?
Bắt đầu với danh sách MCP của Cursor (thiếu hay báo đỏ). Sau đó xác minh Creator: plugin đã được cài đặt/kích hoạt, bảng điều khiển đã mở, máy chủ đang chạy, cổng khớp với cấu hình. Sử dụng bảng triệu chứng trong bài viết này.

Đã kết nối nhưng không có nút—làm gì tiếp theo?
Xác nhận đúng dự án/cảnh đang mở; chạy kiểm tra khói chỉ đọc (liệt kê nút gốc). Nếu vẫn thất bại, kiểm tra công tắc công cụ và quyền truy cập. Đường dẫn đầy đủ: khắc phục sự cố kết nối.

Có cần cài đặt lại Cursor không?
Thường là không. Ưu tiên “cấu hình nhanh → tự động cấu hình” của Creator, tải lại MCP và xác minh cổng localhost. Ranh giới danh mục: Cocos Creator MCP là gì.