Cocos MCP कनेक्शन ट्रबलशूटिंग: Cursor में cocos-creator नहीं दिखता

Cocos MCP को Cursor (या किसी अन्य MCP क्लाइंट) से जोड़ते समय अड़चन अक्सर «खराब प्रॉम्प्ट» नहीं होती—बल्कि ब्रिज जुड़ा ही नहीं: एडिटर में सर्वर बंद है, या AI IDE में cocos-creator लिस्ट नहीं है।

यदि आप कहते हैं “Cursor टूट गया / कनेक्ट नहीं हो रहा”, पहले Cursor-साइड लक्षण देखें: Cursor Broken After Cocos Creator MCP।

अगर अभी भी MCP क्या कर सकता है और “Cocos Creator AI” से कैसे अलग है—यह स्पष्ट नहीं, पहले पढ़ें: Cocos Creator MCP क्या है।

यह गाइड लक्षण → कारण → समाधान से Creator 2.x और 3.x कवर करती है। पूरा इंस्टॉल:

• Cocos Creator 3.x MCP इंस्टॉल
• Cocos Creator 2.x MCP इंस्टॉल

उदाहरण Cursor पर हैं; Claude Code, Codex आदि में MCP reload और कॉन्फ़िग जाँच वैसी ही है।

पहले: कौन-सी परत टूटी?

MCP पथ चार परतों का है। किसी भी परत की विफलता «कनेक्ट नहीं» जैसी लगती है:

1. प्लगइन प्रोजेक्ट में और सक्षम
        ↓
2. पैनल सक्रिय (अकाउंट / लाइसेंस कोड)
        ↓
3. MCP Server Running दिखाता है (localhost)
        ↓
4. AI IDE में कॉन्फ़िग लिखा और MCP सूची connected

जो दिखे	पहले जाँचें
Extension → Cocos MCP Server / MCP Server मेनू नहीं	परत 1: पैक वर्शन, इंपोर्ट पथ, रीस्टार्ट
पैनल खुलता है पर स्टार्ट/एक्टिवेशन नहीं	परत 2: अकाउंट और कोड
Start पर भी Running नहीं	परत 3: पोर्ट, फ़ायरवॉल, एक्टिवेशन
Creator में Running, Cursor में cocos-creator नहीं	परत 4: क्विक कॉन्फ़िग, MCP reload, कॉन्फ़िग फ़ाइल
Cursor connected दिखे पर सीन नोड सूची नहीं	सत्यापन प्रॉम्प्ट, टूल टॉगल, सही प्रोजेक्ट खुला

लक्षण A: मेनू में MCP एक्सटेंशन ही नहीं

संभावित कारण

1. 2.x / 3.x पैक मिलाए गए
2. 3.x: Extension Manager में इंपोर्ट नहीं, या अभी भी disabled
3. 2.x: packages/<plugin-name>/ पर नहीं, या unzip की अतिरिक्त परत
4. 2.x: फ़ाइलें रखीं पर Creator पूरी तरह रीस्टार्ट नहीं किया

समाधान

Creator 3.x:

1. Cocos MCP 3.x से डाउनलोड—2.x पैक नहीं
2. प्रोजेक्ट खोलें → Extension → Extension Manager → Import → 3.x zip
3. सूची में cocos-mcp-server enabled सुनिश्चित करें
4. मेनू फिर भी न हो: Creator बंद कर उसी प्रोजेक्ट को फिर खोलें

Creator 2.x:

1. Cocos MCP 2.x से डाउनलोड
2. अनज़िप के बाद संरचना:

your-project-root/
  packages/
    <plugin-name>/          ← प्लगइन फ़ाइलें यहीं
      package.json          ← इस पथ पर होना चाहिए

3. गलत nesting उदाहरण:

packages/
  xxx-mcp-unzip/
    <plugin-name>/
      package.json

4. पथ ठीक करें, फिर Creator पूरी तरह रीस्टार्ट करें (सिर्फ सीन रिफ्रेश नहीं)। Extension → MCP Server देखें।

लक्षण B: पैनल खुलता है, एक्टिवेशन/स्टार्ट फेल

संभावित कारण

• अकाउंट पर मैचिंग Pro नहीं
• लाइसेंस कोड एक्सपायर या ईमेल मिसमैच
• एक्टिवेशन से पहले Start

समाधान

1. MCP पैनल खोलें (3.x: Extension → Cocos MCP Server → Open Mcp Panel; 2.x: Extension → MCP Server)
2. इनमें से एक से सक्रिय करें:
   • VberAI अकाउंट + पासवर्ड
   • ईमेल + लाइसेंस कोड
3. आधिकारिक अकाउंट सेंटर में प्लान/कोड जाँचकर पैनल में फिर कोशिश करें
4. एक्टिवेशन सफल होने के बाद ही MCP Server सेटिंग्स में Start

बिना एक्टिवेशन अक्सर Running नहीं मिलता। Cursor से पहले एडिटर ठीक करें।

लक्षण C: Start दबाया, Running नहीं

संभावित कारण

1. अभी भी अनएक्टिवेटेड (लक्षण B)
2. पोर्ट व्यस्त (3.x अक्सर डिफ़ॉल्ट 3000; 2.x पैनल के अनुसार)
3. फ़ायरवॉल/सिक्योरिटी localhost listen रोकती है

समाधान

1. MCP Server सेटिंग्स पर पोर्ट नोट करें (नीचे उदाहरण 3000—अपना मान लगाएँ)
2. टर्मिनल में जाँचें:

macOS / Linux:

lsof -iTCP:3000 -sTCP:LISTEN

Windows (PowerShell):

netstat -ano | findstr :3000

3. अगर कोई और प्रोसेस पोर्ट पकड़े:
   • उसे बंद करें, या
   • पैनल में खाली पोर्ट चुनकर फिर Start
4. 127.0.0.1 ब्लॉक न हो (MCP पब्लिक नेट पर न खोलें)
5. पैनल Running दिखे तब AI IDE कॉन्फ़िगर करें

लक्षण D: Creator Running है, Cursor में cocos-creator नहीं

सबसे आम «कनेक्शन फेल»: एडिटर ठीक, क्लाइंट ने कॉन्फ़िग नहीं खाया।

समाधान (क्रम से)

1. Creator में MCP पैनल अभी भी Running है पुष्टि करें (पोर्ट बदलने/रीस्टार्ट से रुक सकता है)
2. Tool Manager में जरूरी टूल ऑन
3. Quick Config → Cursor → Auto Config जब तक Configured न दिखे
4. Cursor → MCP / टूल सूची:
   • cocos-creator (या पैनल वाला नाम) दिखना चाहिए
   • नहीं तो Reload MCP (या Cursor रीस्टार्ट)
5. फिर भी नहीं: Cursor MCP कॉन्फ़िग में लोकल ब्रिज (127.0.0.1 + पैनल पोर्ट) है या नहीं

Auto Config का रूप Cursor वर्शन पर निर्भर। मैन्युअल जाँच:

• सर्विस नाम Cocos MCP (जैसे cocos-creator)
• होस्ट 127.0.0.1 / localhost, पोर्ट Creator से मैच
• गलती से LAN/पब्लिक IP नहीं

कॉन्फ़िग बदलने के बाद फिर MCP reload—वरना UI पुराना स्टेट रखेगा।

अन्य AI IDE

Quick Config में Claude Code, Codex, Windsurf, Cline चुनें, फिर «Auto Config → उस क्लाइंट में MCP reload»। Cursor सेट ≠ सभी IDE जुड़े।

लक्षण E: Connected दिखे, पर सीन सूची/नोड एडिट नहीं

संभावित कारण

1. Creator में खुला प्रोजेक्ट/सीन सवाल से मेल नहीं खाता
2. Tool Manager में जरूरी क्षमताएँ ऑफ
3. सिर्फ «डिस्क स्क्रिप्ट» जाँचीं, एडिटर कॉन्टेक्स्ट नहीं

सत्यापन

Cursor में पहले read-only प्रॉम्प्ट:

List the root node names of the scene currently open in Cocos Creator.

परिणाम	अर्थ
Hierarchy से मेल	ब्रिज OK; छोटा write टेस्ट करें
साफ़ एरर / कोई टूल नहीं	लक्षण C/D पर लौटें
काल्पनिक नोड नाम	MCP शायद नहीं चला; कनेक्शन व टॉगल जाँचें

फिर छोटा write (अस्थायी नोड बनाकर हटाएँ)। बड़े बदलाव से पहले commit।

2.x / 3.x त्वरित तालिका

आइटम	Creator 3.x	Creator 2.x
प्रोडक्ट पेज	cocos (3.x)	cocos2x
इंस्टॉल	Extension Manager → Import	प्रोजेक्ट packages/ में अनज़िप
बाद में	सूची में enable	ज़रूरी रीस्टार्ट
पैक	सिर्फ 3.x	सिर्फ 2.x
पूरे चरण	3.x इंस्टॉल	2.x इंस्टॉल

मिश्रित पैक अक्सर «मेनू नहीं» या «इंपोर्ट फेल» देते हैं—पहले यह तालिका।

सुझाया क्रम (5 मिनट चेकलिस्ट)

ऊपर से टिक करें; ज़्यादातर फेल पहले चार में:

1. Creator मेजर वर्शन MCP zip से मैच (2.x↔2.x, 3.x↔3.x)
2. एक्सटेंशन enabled / packages पथ सही; 2.x रीस्टार्ट हुआ
3. पैनल एक्टिवेशन सफल
4. पैनल Running; पोर्ट फ्री
5. वर्तमान IDE पर Quick Config → Auto Config
6. AI IDE में MCP reload; सूची में cocos-creator
7. Read-only प्रॉम्प्ट अभी खुली सीन के रूट लिस्ट करे

फिर भी फेल हो तो ये नोट करें

सपोर्ट/टीममेट के लिए:

• सटीक Creator वर्शन (जैसे 3.8.x / 2.4.x)
• MCP पैक प्रकार (2.x या 3.x Pro)
• पैनल Running है या नहीं, पोर्ट नंबर
• AI IDE नाम/वर्शन, MCP सूची स्क्रीनशॉट
• Read-only प्रॉम्प्ट का मूलपाठ और जवाब

ब्रिज सिर्फ localhost; MCP पोर्ट पब्लिक न खोलें।

संबंधित दस्तावेज़

• Cocos Creator 3.x MCP इंस्टॉल
• Cocos Creator 2.x MCP इंस्टॉल
• Cocos Creator MCP वीडियो सेटअप
• इंजन चुनें: Godot MCP vs Unity MCP vs Cocos MCP