كسر المؤشر بعد Cocos Creator MCP: إصلاح الاتصال حسب الأعراض

أولاً: هل المؤشر مكسور أم الجسر؟

ما تشعر به	السبب الأكثر احتمالاً
لا يزال المؤشر يكتب تعليمات برمجية عادية، لكنه لا يستطيع الوصول إلى مشاهد/عقد Cocos	MCP غير متصل أو الأدوات غير مفعلة
قائمة MCP لا تحتوي على cocos-creator (أو الاسم من الإعداد السريع)	لم يتم كتابة الإعداد، أو يلزم إعادة التحميل
اسم الخدمة موجود لكنه يظهر خطأ / غير متصل	Creator غير قيد التشغيل، أو عنوان URL/منفذ خاطئ، أو يلزم إعادة التحميل
يظهر متصلاً، لكنه لا يستطيع سرد عقد المشهد المفتوح	مشروع خاطئ، أو أدوات غير محددة، أو فحص قراءة فقط سيئ

يتبع Claude Code وCodex وعملاء MCP المماثلون نفس الفكرة: تأكد من أن العميل لديه إدخال خدمة سليم، ثم تحقق من Creator.

الخطوة 1: انظر فقط إلى MCP داخل المؤشر

افتح إعدادات MCP / الأدوات في المؤشر (قد تختلف تسميات القوائم حسب الإصدار) وتحقق من:

1. ما إذا كان cocos-creator يظهر (أو الاسم المكتوب بواسطة الإعداد السريع في Creator)
2. ما إذا كانت الحالة متصلة / قابلة للاستخدام - وليست عالقة في خطأ أو غير متصلة أو فارغة
3. إذا قمت للتو بتغيير الإعداد أو قمت بتشغيل الإعداد التلقائي في Creator: قم بإجراء إعادة تحميل النافذة (أو ما يعادله من إعادة تحميل MCP)، ثم أعد فحص القائمة

حالة شائعة: يعرض Creator بالفعل قيد التشغيل، لكن المؤشر لا يزال يحتفظ بإعداد قديم - بدون إعادة التحميل، يبدو “مكسورًا فجأة”.

الخطوة 2: تأكد من أن عنوان URL يشير إلى Creator المحلي

يجب أن يستهدف إدخال MCP في المؤشر عنوان URL للجسر المحلي، عادةً:

• http://127.0.0.1:3000/mcp
• أو http://localhost:3000/mcp

استخدم المنفذ الموضح في لوحة MCP في Creator (غالبًا 3000 افتراضيًا؛ إذا قمت بتغييره، طابق اللوحة).

افتح أيضًا Cocos Creator وتأكد من أن لوحة MCP قيد التشغيل لنفس المشروع. إذا لم تكن اللوحة قيد التشغيل، فلن تؤدي إعادة التحميل في المؤشر إلى كشف الأدوات بأعجوبة.

صفحات المنتج (اختر الحزمة لإصدارك الرئيسي؛ لا تخلط):

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

الخطوة 3: إذا استمر الفشل، انتقل حسب الطبقة

يحتوي مسار MCP على أربع طبقات. يمكن أن يبدو الفشل في أي طبقة وكأنه “المؤشر مكسور / لن يتصل”:

1. المكون الإضافي في المشروع وممكّن
        ↓
2. اللوحة مفعلة (حساب / رمز ترخيص)
        ↓
3. خادم MCP يعرض قيد التشغيل (localhost)
        ↓
4. المؤشر لديه إعداد مكتوب وقائمة MCP تعرض متصلاً

ما تراه في المؤشر	اذهب إلى هنا أولاً
لا يوجد إدخال خدمة على الإطلاق	الطبقة 4: عد إلى Creator → الإعداد السريع → الإعداد التلقائي، ثم أعد التحميل؛ التفاصيل في الدليل العام
الإدخال موجود لكن خطأ / لا يمكن الاتصال	الطبقة 3: هل Creator قيد التشغيل، هل المنفذ متطابق، هل localhost محظور
لا توجد قائمة MCP داخل Creator	الطبقة 1: خلط حزمة 2.x/3.x، مسار الاستيراد، إعادة التشغيل (عرض أ في الدليل العام)
اللوحة لا يمكن أن تبدأ / غير مفعلة	الطبقة 2: الحساب والتفعيل (الدليل العام)
متصل لكن لا يمكن سرد العقد	تأكد من فتح المشروع الصحيح؛ قم بتشغيل اختبار القراءة فقط أدناه؛ ثم تحقق من مفاتيح الأدوات

التثبيت الكامل:

• تثبيت Cocos Creator 3.x MCP
• تثبيت Cocos Creator 2.x MCP

الخطوة 4: اختبار سريع (تأكد من إصلاحه)

في المؤشر، ابدأ بفحص للقراءة فقط، على سبيل المثال:

قم بسرد العقد الجذرية للمشهد المفتوح حاليًا في Cocos Creator.

إذا تطابق الرد مع التسلسل الهرمي للمحرر، فإن الجسر يعمل. اختياريًا، قم بكتابة واحدة قابلة للعكس (إنشاء عقدة مؤقتة وحذفها). قم بالالتزام قبل التعديلات الكبيرة؛ أبقِ الجسر على localhost فقط - لا تعرض منفذ MCP للإنترنت العام.

الأسئلة الشائعة

ماذا يعني “Cursor معطل” بعد Cocos Creator MCP عادةً؟
العلامات النموذجية: لا يوجد إدخال لخدمة MCP، حالة خطأ/حمراء، أو اتصال بدون أدوات/عقد. معظم الحالات ليست تعطلًا في Cursor—بل هي طبقة مفقودة واحدة في الجسر رباعي الطبقات.

هل يجب أن أفحص Cursor أم Creator أولاً؟
ابدأ بقائمة MCP في Cursor (مفقودة مقابل حمراء). ثم تحقق من Creator: المكوّن الإضافي مستورد/مفعّل، اللوحة نشطة، الخادم يعمل، والمنفذ يطابق الإعدادات. استخدم جدول الأعراض في هذه المقالة.

متصل ولكن لا توجد عقد—ما الخطوة التالية؟
تأكد من فتح المشروع/المشهد الصحيح؛ نفّذ اختبارًا للقراءة فقط (قائمة العقد الجذرية). إذا استمر الفشل، تحقق من مفاتيح الأدوات والأذونات. المسار الكامل: استكشاف أخطاء الاتصال.

هل أحتاج إلى إعادة تثبيت Cursor؟
عادةً لا. يُفضّل استخدام “إعداد سريع ← إعداد تلقائي” في Creator، إعادة تحميل MCP، والتحقق من منفذ localhost. حدود الفئة: ما هو Cocos Creator MCP.