# إعداد MCP في Unreal 5.8 مع Claude Code · Dola AI

المدونة

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

فعّل Unreal MCP التجريبي من Epic في Unreal Engine 5.8، واربط Claude Code أو Cursor، وأصلح الأخطاء الشائعة، واعرف ما يستطيعه وما لا يستطيعه.

آخر تحديث: 11 نوفمبر 2026

بطاقة عنوان المقال حول إعداد MCP في Unreal 5.8 مع Claude Code أو Cursor، مع تميمة Dola
نُشر في 11 نوفمبر 2026

تم التحقق في 11 نوفمبر 2026 من [وثائق Unreal MCP](https://dev.epicgames.com/documentation/unreal-engine/unreal-mcp-in-unreal-editor) لدى Epic ومن ملفات الإضافة في إصدار الشيفرة المصدرية لـ Unreal Engine 5.8.0. الإضافة موسومة بأنها Experimental، لذا قد تتغير التفاصيل.

## [ما هو Unreal MCP من Epic](#what)

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

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

## [فعّله خطوة بخطوة](#enable)

- افتح مشروعك في Unreal Engine 5.8. اذهب إلى **Edit > Plugins** وابحث عن **Unreal MCP**. تقول صفحة Epic إنه مفعّل افتراضيًا، بينما يضعه إصدار الشيفرة المصدرية 5.8.0 معطّلًا، لذا ضع علامة الاختيار بنفسك.

- ابحث عن **All Toolsets** وفعّله لتحميل كل مجموعات الأدوات الافتراضية. ويمكنك أيضًا تفعيل إضافات مجموعات الأدوات واحدة تلو الأخرى إن أردت أدوات أقل.

- أعد تشغيل المحرر.

- افتح **Edit > Editor Preferences > Agentic Workflows > Model Context Protocol**. خيار **Auto Start Server** مفعّل، والمنفذ 8000، ومسار العنوان /mcp، لذا يستمع الخادم على http://127.0.0.1:8000/mcp.

- في اللوحة نفسها، اختر عميلك من **Client Selection** (القيمة الافتراضية Claude Code) واضغط **Generate Client Config**.

## [ربط Claude Code](#claude-code)

مع 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 مفتوحًا من قبل، فأعد توصيله.

## [ربط Cursor](#cursor)

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

## [النقل والأمان](#transport)

- Streamable HTTP وSSE فقط. لا يُدعم stdio ولا WebSocket.

- يستمع الخادم على 127.0.0.1 فقط، ويتحقق من ترويسة Origin مقابل قائمة سماح، ولا يملك أي مصادقة. تنصح Epic بعدم إتاحته خارج جهازك.

- تُنفَّذ استدعاءات الأدوات واحدًا تلو الآخر على خيط اللعبة، لذا يحجب الاستدعاء الطويل الاستدعاء التالي.

## [أوامر كونسول مفيدة](#commands)

- 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) وأضف إدخالًا ثانيًا يدويًا في إعدادات العميل.

## [ما الذي يستطيعه وما الذي لا يستطيعه](#limits)

يستطيع:

- منح عميل الذكاء الاصطناعي أدوات المحرر من كل مجموعة أدوات تفعّلها.

- إبقاء قائمة الأدوات قصيرة: مع تفعيل Enable Tool Search يرى العميل مجموعة صغيرة من الأدوات الوصفية (مثل list_toolsets وcall_tool) ويبحث عن البقية عند الحاجة.

- استخدام دوال C++ الخاصة بك كأدوات، موسومة بالسمة AICallable.

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

- تقديم MCP Resources من مجموعات أدوات المحرك، ولا MCP Prompts.

- تقديم أكثر من أدوات AIRuntimeCallable في لعبة مطبوخة (محزّمة).

- التقاط أداة C++ جديدة عبر Live Coding. أعد تشغيل المحرر لإضافتها.

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

## [أخطاء شائعة](#errors)

- **الخادم لا يبدأ:** ابحث في Output Log عن منفذ مستخدم أو إضافة مفقودة. جرّب منفذًا آخر.

- **العميل لا يجد الخادم:** افتح المحرر أولًا وانتظر الخادم، ثم شغّل العميل من مجلد الإعدادات وأعد الاتصال.

- **أدوات مفقودة:** فعّل إضافة مجموعة الأدوات، ونفّذ ModelContextProtocol.RefreshTools، ثم أعد توصيل العميل.

- **انتهاء مهلة الاستدعاءات الطويلة:** يتوقف Claude Code عن الانتظار بعد نحو 120 ثانية. قسّم العمل إلى استدعاءات أصغر.

- **لا تعرف أي محرر يجيب:** اربط MCP Inspector (npx @modelcontextprotocol/inspector) بالعنوان نفسه واقرأ النسخة في نتيجة initialize.

## [أين يقع Dola](#dola)

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: تشغيل Blueprint جعل BP_Lamp يومض، مع فحص PIE من وكيل QA والتعديل المعلّق في لوحة Changes
التشغيل: خطط Director (Sonnet)، وعدّل Blueprint (Haiku)، وقرأ QA (Sonnet) المخطط وشغّله في PIE ووجد 0 أخطاء تصريف. 2.34 دولار على Auto.

لوحة Changes في Dola تسرد BP_Lamp.uasset كملف معدَّل، مع Accept all وReject all وزر يفتح الفرق في Unreal
تحتفظ لوحة Changes بالتعديل للمراجعة قبل أن تبقيه.

تطبيق Dola هو أيضًا عميل MCP للخوادم التي تضيفها ([Unreal Engine MCP وDola](https://dolaai.pro/ar/unreal-engine-mcp)). التشغيل كاملًا خطوة بخطوة: [شاهد Dola وهو يعمل](https://dolaai.pro/ar/see-it-work).

## [الأسئلة الشائعة](#faq)

###

تقول وثائق Epic إنه مفعّل. لكن ملف الإضافة في إصدار الشيفرة المصدرية 5.8.0 يضعه معطّلًا افتراضيًا. افتح Edit > Plugins وابحث عن Unreal MCP وفعّله إن لم يكن مفعّلًا.

###

افتراضيًا يقدّم المحرر MCP على http://127.0.0.1:8000/mcp عبر Streamable HTTP. يمكنك تغيير المنفذ والمسار في Editor Preferences ضمن Agentic Workflows > Model Context Protocol.

###

لا. صفحة Epic تذكر Streamable HTTP وSSE فقط. لا يُدعم stdio ولا WebSocket، لذلك يجب أن يكون إدخال العميل من نوع HTTP.

###

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

## [مقالات ذات صلة](#related)

- [Claude Code لـ Unreal Engine مقابل الذكاء الاصطناعي الأصلي لـ UE](https://dolaai.pro/ar/blog/claude-code-unreal-engine)
ما الذي يجيده Claude Code في مشروع Unreal Engine، وما الذي لا يستطيع الوصول إليه دون جسر MCP، وكيف يُقارن بـ Dola، وهو مساعد أصلي لـ UE.

- [إضافة الذكاء الاصطناعي لـ Unreal Engine: ما الذي تبحث عنه](https://dolaai.pro/ar/blog/unreal-engine-ai-plugin)
لماذا يحتاج مساعد الذكاء الاصطناعي لـ Unreal Engine إلى إضافة للمحرر، وكيف تعمل إضافة Dola وجسرها المحلي، وقائمة تحقق لاختيار إضافة ذكاء اصطناعي لـ Unreal.

- [أدوات الذكاء الاصطناعي لـ Unreal Engine: أيها يناسب المهمة](https://dolaai.pro/ar/blog/unreal-engine-ai-tools)
أنواع أدوات الذكاء الاصطناعي الأربعة لـ Unreal Engine (مساعدو المحرر، وأدوات البرمجة بالذكاء الاصطناعي، ومولّدات الأصول، والذكاء الاصطناعي داخل اللعبة)، وما الذي يجيده كل منها، وكيف تختار.

- [شرح AI Assistant المدمج في Unreal Engine](https://dolaai.pro/ar/blog/unreal-engine-5-7-ai-assistant)
ماذا يفعل AI Assistant من Epic في Unreal Engine 5.7، وكيف تفتحه، وما الذي ليس موثّقًا، ومتى تحتاج إلى وكيل يعدّل مشروعك ويختبره.

- [مهارات Claude Code لـ Unreal Engine](https://dolaai.pro/ar/blog/claude-code-unreal-engine-skills)
ماذا تحتوي إضافة مهارات Claude Code من Epic لـ Unreal Engine، وكيف تثبّتها، وكيف تعمل مع Unreal MCP، وحدودها، وأين يقع Dola.

- [الذكاء الاصطناعي لـ Blueprints في Unreal Engine: مقارنة الأدوات](https://dolaai.pro/ar/blog/best-ai-for-unreal-engine-blueprints)
ما الذي تفعله كل أداة ذكاء اصطناعي لـ Blueprints في Unreal Engine: AI Assistant وUnreal MCP من Epic، وAura، وLudus AI، وVibeUE، وUnrealGenAISupport، وDola. دون ترتيب.

- [الذكاء الاصطناعي لـ Unreal Engine مجانًا: ما الذي تحصل عليه](https://dolaai.pro/ar/blog/unreal-engine-ai-free)
كيف تبدأ مع مساعد Dola للذكاء الاصطناعي في Unreal Engine دون مقابل، وما الذي يستهلك أرصدة الذكاء الاصطناعي، وكيف تُبقي الاستهلاك منخفضًا، ومتى تكون الخطة المدفوعة مفيدة.

- [مولّد الذكاء الاصطناعي لـ Unreal Engine: ما الذي ينتجه](https://dolaai.pro/ar/blog/unreal-engine-ai-generator)
ما الذي يمكن لمولّد الذكاء الاصطناعي لـ Unreal Engine إنتاجه اليوم: مخططات Blueprint والمستويات والمواد والواجهات وC++‎ ونماذج ثلاثية الأبعاد، وكيف تحصل على نتائج جيدة منه.

- [دردشة الذكاء الاصطناعي لـ Unreal Engine التي تعدّل مشروعك](https://dolaai.pro/ar/blog/unreal-engine-ai-chat)
تحدّث مع ذكاء اصطناعي يُجري تغييرات في مشروع Unreal Engine المفتوح لديك: كيف يعمل، وماذا تسأل، وكيف يختلف عن روبوت المحادثة العام.

- [وكيل الذكاء الاصطناعي لـ Unreal Engine: ماذا يفعل داخل المحرر](https://dolaai.pro/ar/blog/unreal-engine-ai-agent)
ما هو وكيل الذكاء الاصطناعي لـ Unreal Engine، وكيف يقرأ ويخطط وينفّذ ويتحقق داخل Unreal Editor، وكيف تُبقيك وكلاء Dola المتخصصون في موقع التحكم.

- [صانع الألعاب بالذكاء الاصطناعي لـ Unreal Engine: ما الذي يعمل اليوم](https://dolaai.pro/ar/blog/unreal-engine-ai-game-maker)
هل يستطيع الذكاء الاصطناعي صنع لعبة في Unreal Engine؟ ما الذي يمكن لصانع ألعاب بالذكاء الاصطناعي بناؤه فعلًا اليوم، ميزةً ميزةً داخل مشروعك، وما الذي يبقى من مسؤوليتك.

- [ما هو Dola AI؟ مساعد الذكاء الاصطناعي لـ Unreal Engine](https://dolaai.pro/ar/blog/what-is-dola-ai)
Dola AI مساعد ذكاء اصطناعي لـ Unreal Engine: تطبيق Dola للسطح المكتبي مع إضافة للمحرر لمخططات Blueprint وC++‎. وليس له صلة بتطبيقات أخرى تحمل اسم Dola.

- [تنزيل تطبيق Dola لنظامي Windows وLinux](https://dolaai.pro/ar/blog/dola-app-download)
كيف تنزّل تطبيق Dola AI للسطح المكتبي على Windows أو Linux، وتثبّته، وتسجّل الدخول، وتربط إضافة Unreal Engine 5.7 بمشروعك.

- [تسجيل الدخول إلى Dola: الدخول، وإعادة تعيين كلمة المرور، وإصلاح الأخطاء](https://dolaai.pro/ar/blog/dola-login)
كيف تسجّل الدخول إلى Dola AI على dolaai.pro وفي تطبيق السطح المكتبي، وتنشئ حسابًا، وتعيد تعيين كلمة المرور، وتصلح مشكلات تسجيل الدخول الشائعة في Dola.

- [مساعد Dola للذكاء الاصطناعي: الدردشة والوكلاء لـ Unreal](https://dolaai.pro/ar/blog/dola-ai-assistant-unreal-engine)
كيف تعمل دردشة Dola ووكلاؤها المتخصصون في Unreal Engine: دردشة واحدة، مع متخصصين في Blueprint وC++‎ والمواد يعدّلون مشروعك المفتوح.

- [Unreal Engine AI: ذكاء الشخصيات غير اللاعبة مقابل مساعدي المطورين](https://dolaai.pro/ar/blog/unreal-engine-ai-npc-vs-assistant)
“Unreal Engine AI” قد يعني ذكاء الشخصيات غير اللاعبة في اللعب، أو Epic Developer Assistant، أو إضافات المحرر من جهات خارجية. وDola هو الأخير: ليس أشجار السلوك، وليس لوحة Epic.

- [وضع النمذجة استوديو Babylon، وليس Unreal](https://dolaai.pro/ar/blog/modeling-mode-babylon-studio)
كيف يحوّل وضع النمذجة في Dola المحادثة إلى شبكة Babylon حية، ويفحص الأجزاء المسماة، ويصدّر GLB، منفصلًا عن مسار Blueprint وC++‎ في Unreal.

- [ما فائدة Dola لمطوّري Unreal Engine](https://dolaai.pro/ar/blog/what-dola-is-for-unreal-developers)
Dola AI (dolaai.pro) مساعد محلي لـ Unreal Engine لمخططات Blueprint وC++‎: تطبيق Dola للسطح المكتبي وإضافة لمحرر Unreal.

[المزيد في مدونة Dola](https://dolaai.pro/ar/blog)

[جرّبني في مشروعك!](https://dolaai.pro/signup)

[شاهده في العمل](https://dolaai.pro/ar/see-it-work)[سجّل مجانًا](https://dolaai.pro/signup)