Unity MCP مع Claude Code و Cursor: تشغيل المحرر دون كتابة كل تغيير يدويًا

حدود “الذكاء الاصطناعي يكتب C# في مجلد”

أدوات البرمجة القائمة على الدردشة جيدة في إنشاء السكربتات. الذكاء الاصطناعي الذي يعدل الملفات فقط لا يزال يفتقد حالة المحرر الحية—المشاهد المفتوحة، GameObjects المحددة، متغيرات البريفاب، سلوك وضع التشغيل، وأخطاء Console.

إذا كان النموذج يرى الملفات على القرص فقط، فإنه يخمن التسلسل الهرمي ولا يمكنه النقر على Play، أو إعادة تسمية عقدة في Hierarchy، أو فحص مرجع مفقود. تحتاج الفرق إلى مساعد داخل حلقة المحرك، وليس فقط في المستودع.

Model Context Protocol (MCP) هو معيار لتمكين عملاء الذكاء الاصطناعي من استدعاء الأدوات. يكشف خادم Unity MCP عن إجراءات المحرر عبر جسر محلي بحيث يمكن لعملاء مثل Claude Code و Cursor وسير عمل بأسلوب Codex قراءة المشروع وتغييره أثناء تشغيل Unity.

توفر VberAI مكونًا إضافيًا لـ Unity MCP لهذا الجسر. هذا الدليل هو مسار إعداد واستخدام عملي—وليس عرضًا للميزات.

ما الذي يغيّره Unity MCP في العمل اليومي

بدون MCP	مع Unity MCP
الصق السكربتات المولدة، ثم أصلح أخطاء الترجمة بنفسك	اطلب من العميل إنشاء سكربت و إرفاقه بـ GameObject مسمى
كرر لوحات الواجهة يدويًا	موجه: “استنسخ Panel_Shop تحت Canvas وأعد تسمية الأطفال”
صف أخطاء Console في الدردشة	دع العميل يقرأ السجلات الأخيرة / سياق التحديد (حيث يسمح المكون الإضافي بذلك)
خمن تخطيط المشهد من YAML	استعلم عن التسلسل الهرمي، ثم عدّل مع التأكيد

ما زلت تراجع الاختلافات ونتائج وضع التشغيل. تتوقف عن كتابة كل نقرة محرر يمكن للوكيل القيام بها بأمان.

المتطلبات الأساسية

• مشروع Unity مفتوح (يوصى بـ LTS للعمل الجماعي)
• عميل يدعم MCP: Claude Code أو Cursor أو Windsurf أو ما شابه
• وصول شبكة محلي إلى 127.0.0.1 (يبقى الجسر عادة على loopback)
• حزمة VberAI Unity MCP لإصدار Unity الخاص بك (تنزيل / وثائق)

مفيد لكن اختياري: مشهد عينة صغير (Canvas فارغ + زران) بحيث يسهل التحقق من الموجّهات الأولى.

قائمة التحقق للإعداد

1. تثبيت مكون Unity MCP الإضافي

1. استورد الحزمة إلى مشروعك (أو ثبّتها عبر سير عمل الحزم لفريقك)
2. فعّل الامتداد / إدخال القائمة (تختلف الأسماء قليلاً حسب البناء—ابحث عن MCP أو AI Bridge)
3. أعد تحميل المحرر إذا طلب Unity ذلك

2. بدء جسر MCP المحلي

افتح لوحة المكون الإضافي وابدأ الخادم. تأكد من:

• تظهر الحالة قيد التشغيل
• المضيف هو localhost (لا تعرض المنفذ للعامة)
• مسار المشروع يطابق مشروع Unity الذي تنوي تعديله

3. تسجيل الخادم في عميل الذكاء الاصطناعي الخاص بك

في Cursor أو Claude Code، أضف إدخال خادم MCP يشير إلى جسر Unity المحلي (stdio أو HTTP/SSE—اتبع الوثائق الحالية للمكون الإضافي).

أعد تشغيل العميل إذا لم تظهر الأدوات. يجب أن ترى أدوات متعلقة بـ Unity مدرجة (قراءة المشهد، عمليات العقد، إلخ).

4. قم باختبار دخان للقراءة فقط

اسأل:

اذكر GameObjects الجذرية في المشهد النشط.

إذا كان الرد يطابق Hierarchy، فإن الجسر يعمل. عندها فقط جرب إجراءات الكتابة.

5. قم باختبار كتابة صغير

اسأل:

أنشئ GameObject فارغًا باسم MCP_SmokeTest تحت جذر المشهد.

ابحث عنه في Hierarchy، ثم احذفه. فضّل الاختبارات القابلة للعكس قبل إعادة هيكلة كبيرة.

أنماط الموجّهات التي تعمل بشكل جيد

البنية أولاً

اعرض أبناء Canvas/HUD ولخص أي منها هي LayoutGroups.

كتابات مركزة

تحت Canvas/Menu، أعد تسمية Button إلى Btn_Start واضبط نص تسمية TMP إلى Start.

حلقة التصحيح

بعد أن أضغط Play، لخص أخطاء Console المتعلقة بـ PlayerController واقترح أصغر إصلاح.

الاقتران مع واجهة مولدة

إذا استوردت شاشة من AI Studio، استخدم MCP لربط مستمعات onClick أو مواءمة التسمية مع اصطلاحات C# الخاصة بك—دون إعادة بناء البريفاب يدويًا.

عادات السلامة

• أبقِ الجسر على localhost فقط
• فضّل القراءة ← التخطيط ← الكتابة على موجه واحد ضخم “أعد بناء اللعبة”
• التزم قبل تعديلات الوكيل الكبيرة
• لا تضع أسرارًا في الموجّهات؛ MCP لا يحل محل التحكم في الوصول
• تعامل مع وضع التشغيل وتحديث قاعدة الأصول كنقاط تفتيش بشرية

يقلل MCP من النقر اليدوي على المحرر. لا يزيل مراجعة الكود.

كيف يرتبط هذا بمساعدي Unity المدمجين

يحل مساعدو Unity المدمجون ومكونات Unity MCP الإضافية من جهات خارجية مهامًا متداخلة. قم بتقييمها بنفس الطريقة:

1. هل يمكن للأداة رؤية المباشر Hierarchy / التحديد؟
2. هل يمكنها إجراء تعديلات قابلة للعكس يمكنك تدقيقها؟
3. هل تعمل مع عميل الذكاء الاصطناعي الذي يستخدمه فريقك بالفعل (Claude Code، Cursor، …)؟

Unity MCP هو الأقوى عندما يعيش فريقك بالفعل في هؤلاء العملاء ويريد بروتوكولًا واحدًا عبر المحركات (تشغل العديد من الاستوديوهات أيضًا Godot أو Cocos MCP بنفس العادة).

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

هل ما زلت أكتب C#؟
نعم. MCP هو الأفضل في عمليات المحرر والهيكلة. لا تزال أنظمة اللعب والشبكات والأداء بحاجة إلى مهندسين.

Claude Code مقابل Cursor؟
كلاهما يعمل إذا كانا يدعمان MCP وقمت بتوجيههما إلى نفس خادم Unity المحلي. اختر العميل الذي يستخدمه مستودعك بالفعل؛ الجسر هو القطعة المشتركة.

هل هذا للواجهة فقط؟
لا. تنطبق عمليات Hierarchy والمكونات والمشهد على كائنات اللعب أيضًا. الواجهة هي مجرد عرض توضيحي أول سهل.

أين الفيديو التعليمي؟
انظر Unity Game Engine MCP Plugin (video guide) على مسار قناة VberAI لإعداد مسجل.

الخطوات التالية

1. ثبّت Unity MCP في مشهد تجريبي
2. اربط Claude Code أو Cursor واجتاز اختبار الدخان للقراءة فقط
3. أتمتة مهمة تكرهها (إعادة تسمية دفعة، تكرار لوحة، إرفاق سكربت)

عندما يكون التصميم إلى بريفاب هو عنق الزجاجة بدلاً من عمليات المحرر، اقرن هذا بسير عمل Figma → Unity AI Studio.