إعداد MCP في Unreal 5.8 مع Claude Code أو Cursor

يشغّل Unreal MCP (اسم الإضافة ModelContextProtocol) خادم MCP داخل محرر Unreal. يتصل به عميل ذكاء اصطناعي مثل Claude Code أو Cursor ويستدعي أدوات المحرر. تأتي الأدوات من مجموعات أدوات (toolsets) مسجّلة في Toolset Registry الخاص بـ Unreal، وتوفّر Epic الكثير منها: الممثلات (actors)، وBlueprints، وWidget Blueprints، والمواد، وMetaSounds، وPCG، وNiagara، وSequencer، وفحص Slate، والتحليل الأدائي، واختبارات الأتمتة.

تَسِم Epic الإضافة بأنها Experimental. توقّع تغييرات بين إصدارات المحرك.

1. افتح مشروعك في Unreal Engine 5.8. اذهب إلى Edit > Plugins وابحث عن Unreal MCP. تقول صفحة Epic إنه مفعّل افتراضيًا، بينما يضعه إصدار الشيفرة المصدرية 5.8.0 معطّلًا، لذا ضع علامة الاختيار بنفسك.
2. ابحث عن All Toolsets وفعّله لتحميل كل مجموعات الأدوات الافتراضية. ويمكنك أيضًا تفعيل إضافات مجموعات الأدوات واحدة تلو الأخرى إن أردت أدوات أقل.
3. أعد تشغيل المحرر.
4. افتح Edit > Editor Preferences > Agentic Workflows > Model Context Protocol. خيار Auto Start Server مفعّل، والمنفذ 8000، ومسار العنوان /mcp، لذا يستمع الخادم على http://127.0.0.1:8000/mcp.
5. في اللوحة نفسها، اختر عميلك من Client Selection (القيمة الافتراضية Claude Code) واضغط Generate Client Config.

مع Claude Code يكتب Generate Client Config ملف .mcp.json: في مجلد المشروع عند استخدام محرك مثبّت من Launcher، وفي مجلد المحرك عند البناء من الشيفرة المصدرية. في الحالة الثانية قد تحتاج إلى نسخ الإدخال إلى إعدادات مشروعك. يبدو الإدخال هكذا:

{
  "mcpServers": {
    "unreal-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

شغّل Claude Code من المجلد الذي يحتوي الإعدادات بعد فتح المحرر وتشغيل الخادم. إن كان Claude Code مفتوحًا من قبل، فأعد توصيله.

لا تحتوي صفحة Epic على مقتطف جاهز لـ Cursor. نفّذ في المحرر أمر الكونسول ModelContextProtocol.GenerateClientConfig Cursor، وانسخ الإدخال الذي يظهر في Output Log، وأضفه حيث تشير وثائق MCP الخاصة بـ Cursor. الخادم هو نقطة HTTP نفسها المذكورة أعلاه.

• Streamable HTTP وSSE فقط. لا يُدعم stdio ولا WebSocket.
• يستمع الخادم على 127.0.0.1 فقط، ويتحقق من ترويسة Origin مقابل قائمة سماح، ولا يملك أي مصادقة. تنصح Epic بعدم إتاحته خارج جهازك.
• تُنفَّذ استدعاءات الأدوات واحدًا تلو الآخر على خيط اللعبة، لذا يحجب الاستدعاء الطويل الاستدعاء التالي.

• ModelContextProtocol.StartServer [port] وModelContextProtocol.StopServer
• ModelContextProtocol.RefreshTools بعد إضافة أدوات أو تغييرها
• ModelContextProtocol.GenerateClientConfig مع اسم عميل مثل ClaudeCode أو Cursor أو Codex أو Gemini
• -ModelContextProtocolPort=8001 في سطر الأوامر لاختيار منفذ آخر
• Log LogModelContextProtocol Verbose لمزيد من التفاصيل في Output Log

محرران في الوقت نفسه

يكتب Generate Client Config إدخالًا واحدًا فقط باسم unreal-mcp. لمحرر ثانٍ، شغّله على منفذ آخر (مثل 8001) وأضف إدخالًا ثانيًا يدويًا في إعدادات العميل.

يستطيع:

• منح عميل الذكاء الاصطناعي أدوات المحرر من كل مجموعة أدوات تفعّلها.
• إبقاء قائمة الأدوات قصيرة: مع تفعيل Enable Tool Search يرى العميل مجموعة صغيرة من الأدوات الوصفية (مثل list_toolsets وcall_tool) ويبحث عن البقية عند الحاجة.
• استخدام دوال C++ الخاصة بك كأدوات، موسومة بالسمة AICallable.

وبحسب صفحة Epic، لا يستطيع:

• تقديم MCP Resources من مجموعات أدوات المحرك، ولا MCP Prompts.
• تقديم أكثر من أدوات AIRuntimeCallable في لعبة مطبوخة (محزّمة).
• التقاط أداة C++ جديدة عبر Live Coding. أعد تشغيل المحرر لإضافتها.

ولا يراجع أو يختبر التغييرات التي يجريها عميلك. هذا الجزء يبقى عليك وعلى عميلك.

• الخادم لا يبدأ: ابحث في Output Log عن منفذ مستخدم أو إضافة مفقودة. جرّب منفذًا آخر.
• العميل لا يجد الخادم: افتح المحرر أولًا وانتظر الخادم، ثم شغّل العميل من مجلد الإعدادات وأعد الاتصال.
• أدوات مفقودة: فعّل إضافة مجموعة الأدوات، ونفّذ ModelContextProtocol.RefreshTools، ثم أعد توصيل العميل.
• انتهاء مهلة الاستدعاءات الطويلة: يتوقف Claude Code عن الانتظار بعد نحو 120 ثانية. قسّم العمل إلى استدعاءات أصغر.
• لا تعرف أي محرر يجيب: اربط MCP Inspector (npx @modelcontextprotocol/inspector) بالعنوان نفسه واقرأ النسخة في نتيجة initialize.

Dola ليس إضافة MCP من Epic ولا يحتاج إليها. إنه تطبيق سطح مكتب مع إضافة خاصة به لمحرر Unreal، يربط بينهما جسر محلي. إصدارات الإضافة المنشورة مخصّصة لـ Unreal Engine 5.7 على Windows وLinux، لذا فإن MCP من Epic خيار متاح اليوم لمشروع 5.8.

• جاهز للاستخدام: ثبّت التطبيق، وأضف الإضافة إلى مشروعك، وسجّل الدخول. لا إعدادات عميل لتكتبها.
• راجع قبل أن تحتفظ: ينتظر كل تعديل في لوحة Changes. افتح الفرق في Unreal، ثم اقبله أو ارفضه لاستعادة الأصل القديم.
• ضمان الجودة باللعب: يقرأ وكيل QA المخطط ويجرب التغيير في Play in Editor قبل أن يعلن انتهاء التشغيل.

تشغيل حقيقي لـ Dola في 9 نوفمبر 2026: طلب واحد، "make BP_Lamp blink"، فُحص في PIE ثم احتُجز للمراجعة.

تطبيق Dola هو أيضًا عميل MCP للخوادم التي تضيفها (Unreal Engine MCP وDola). التشغيل كاملًا خطوة بخطوة: شاهد Dola وهو يعمل.