خادم Unity MCP: إعداد Claude Code والتكلفة والخيارات المجانية

كتابة "add a spawn point and fix the null reference in my inventory script" في الطرفية، ثم مشاهدة محرر Unity ينفذ ذلك، يبدو كحيلة عرض. لكنها ليست كذلك. يمنح خادم Unity MCP برنامج Claude Code القدرة على التصرف داخل المحرر: يمكنه قراءة وحدة التحكم، وإنشاء GameObjects، وتعديل نصوص C#، وتشغيل الاختبارات دون أن تنسخ شيئًا وتلصقه ذهابًا وإيابًا. ما تغفله معظم الدروس التعليمية هو أن الوضع قد تغيّر. أعلنت Unity إيقاف خادم MCP المدمج في حزمة AI Assistant الخاصة بها، وتزايدت الخوادم المجتمعية المجانية، وتعتمد الفاتورة الفعلية على النموذج الذي تربطه بالخادم أكثر بكثير مما تعتمد على الخادم نفسه.

تشرح هذه الصفحة خطوات الإعداد لكل مسار، والتكلفة الفعلية بالدولار وبالتوكنات، والخيارات المجانية التي تصمد في الاستخدام اليومي. تم التحقق من الأوامر والإصدارات والأسعار في أكتوبر 2026 بمقارنتها مع وثائق Unity والمستودعات الخاصة بالمشاريع وصفحة أسعار Claude.

💡 الإجابة المختصرة: كل خوادم Unity MCP المذكورة هنا مجانية. أما Claude Code فليس مجانيًا، لأنه يحتاج إلى خطة Claude مدفوعة أو رصيد API. أرخص إعداد متين هو خادم مجتمعي مجاني مع خطة Claude التي قد تملكها أصلًا.

أي خادم Unity MCP تختار

تظهر أربعة أسماء في شبه كل بحث. أحدها رسمي وأُعلن إيقافه. ثلاثة منها مفتوحة المصدر ولم يطلها ذلك الإشعار. يعتمد الاختيار بينها على إصدار Unity لديك، وهل تفضّل Python أو Node على جهازك، ومدى رغبتك في البقاء قريبًا من خارطة طريق Unity الخاصة.

الخادم الرسمي وإيقافه

تشحن Unity خادم MCP داخل حزمة com.unity.ai.assistant. يحتاج إلى Unity 6 (6000.0) أو أحدث، ويقع تحت Edit > Project Settings > AI > Unity MCP. تبدأ الوثائق الحالية بسطر صريح: "Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead." أي أن خادم Unity MCP مُهمَل، واستخدم واجهة سطر أوامر Unity (CLI) بدلًا منه.

اقرأ النطاق بعناية، فهو أضيق مما يبدو:

يأتي Unity CLI مع خادم MCP خاص به، مبني على حزمة Unity Pipeline، ويتحدث البروتوكول نفسه، لذا يتصل عميلك به بالطريقة نفسها التي يتصل بها اليوم. تقول Unity إن وضع MCP هذا ليس جزءًا من الإيقاف، وإنه "يبقى مدعومًا بالكامل".

مقارنة ثلاثة خوادم مجتمعية

يعرض MCP for Unity 48 نقطة دخول للأدوات تشمل المشاهد وGameObjects ونصوص C# والأصول والاختبارات والتحليل والبناء. كما يعمل مع Claude Desktop وVS Code وCursor وWindsurf وCline وGemini CLI، فتكفي عملية تثبيت واحدة لأي عميل تجربه لاحقًا. يعلن Unity-MCP عن أكثر من 70 أداة مدمجة تغطي المشروع والأصول، والمشهد والتسلسل الهرمي، والبرمجة والمحرر، والتحليل. أما mcp-unity فيضيف عمليات دفعية مع إمكانية التراجع، وهي مفيدة عندما يلمس الوكيل كثيرًا من الكائنات دفعة واحدة.

قاعدة سريعة: على Unity 2021 أو 2022 اختر MCP for Unity. على Unity 6 مع Node مثبت من قبل، يكون mcp-unity الأنسب والأبسط. وإذا أردت أكبر عدد من الأدوات جاهزة منذ البداية، فانظر إلى Unity-MCP.

إعداد Claude Code خطوة بخطوة

ثبّت Claude Code أولًا إن لم تكن قد فعلت: npm install -g @anthropic-ai/claude-code، ثم شغّل claude --version للتأكد من أنه يستجيب.

المسار 1: Unity CLI، المسار الذي توصي به Unity

هذا هو المسار الذي توجه Unity الجميع إليه الآن، وهو مجاني. تقول Unity إن CLI "مجاني ومنفصل عن Unity AI"، ولا يحتاج إلى اشتراك في Unity AI. لتشغيل محرر قيد التشغيل، يجب أن يستخدم المشروع Unity 6.0 LTS أو أحدث.

1. ثبّت Unity CLI من وثائق Unity.
2. شغّل unity pipeline install لإضافة حزمة Unity Pipeline.
3. شغّل unity mcp configure claude لكتابة إعدادات Claude Code.
4. شغّل unity mcp configure --list لعرض كل عميل مدعوم وحالته.
5. شغّل unity skill install <agent-name> لإضافة مهارات Unity إلى وكيلك.

يقبل خادم خط الأنابيب المحلي الاتصالات على localhost فقط، ويشغّل CLI محرر محليًا دون اتصال بالإنترنت.

💡 يستطيع Claude Code تشغيل أوامر الصدفة، لذا قد لا تحتاج إلى MCP أصلًا. unity command وunity eval يشغلان المحرر مباشرة، وبحسب Unity فهما أسرع ويستهلكان توكنات أقل من MCP. احتفظ بوضع MCP للأنظمة التي لا تستطيع تشغيل أوامر الصدفة.

ما زلت على خادم المحرر القديم؟ افتح Edit > Project Settings > AI > Unity MCP، وتأكد من أن Unity Bridge يُظهر Running، ووسّع Integrations، واختر Claude Code واضغط Configure. لإدخال يدوي، وجّه Claude Code إلى الملف الثنائي للمرحل (relay) باستخدام الوسيط --mcp: %USERPROFILE%\.unity\relay\relay_win.exe على Windows. يظهر في Unity عند الاتصال الأول طلب معلّق، فتضغط Accept مرة واحدة. تذكر صفحة Unity الخاصة بهذا الخادم أيضًا أن الاشتراك النشط أو النسخة التجريبية في أدوات الذكاء الاصطناعي الخاصة بها شرط مسبق.

المسار 2: MCP for Unity

1. في Unity افتح Window > Package Manager، واضغط +، واختر Add package from git URL والصق https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main. البديل من OpenUPM هو openupm add com.coplaydev.unity-mcp.
2. ثبّت Python 3.10 أو أحدث وuv.
3. في المحرر، انتقل إلى Window > MCP for Unity واختر Configure All Detected Clients.
4. افتح Claude Code في مجلد المشروع وشغّل claude mcp list للتأكد من الاتصال.

المسار 3: Coplay MCP عبر uvx

يقدّم Coplay شرحًا منفصلًا لاستخدام Claude Code. يطلب Unity 2022 أو أحدث، وNode.js مع npm، وPython 3.11 أو أحدث. أضف حزمة Unity من https://github.com/CoplayDev/unity-plugin.git#beta، ثم سجّل الخادم بسطر واحد:

claude mcp add --scope user --transport stdio coplay-mcp --env MCP_TOOL_TIMEOUT=720000 -- uvx --python ">=3.11" coplay-mcp-server@latest

نسخ الأمر النصي

تمنح القيمة MCP_TOOL_TIMEOUT=720000 كل استدعاء أداة اثنتي عشرة دقيقة، وهذا مهم في البناء الطويل وتشغيل الاختبارات. لا يذكر ذلك الشرح أي أسعار، لذا تحقق من موقع Coplay قبل أن تعتمد عليه في فريق.

إعدادات يدوية للخوادم الأخرى

Unity-MCP يُسجَّل بأمر واحد، حيث يقع الملف الثنائي داخل مجلد Library في مشروعك:

claude mcp add ai-game-developer "<unityProjectPath>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> client-transport=stdio

نسخ الأمر النصي

mcp-unity يُثبَّت من https://github.com/CoderGamester/mcp-unity.git، ويبدأ من Tools > MCP Unity > Server Window، ويقرأ ملف .mcp.json في جذر المشروع:

{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": ["Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"]
    }
  }
}

نسخ الأمر النصي

استبدل <hash> باسم المجلد الفعلي من ذاكرة الحزم لديك.

تحقق من أن الإعداد يعمل

شغّل claude mcp list. يبدو السطر السليم هكذا: coplay-mcp: ✓ Connected. ثم اختبر السلسلة كلها بالأمر الذي تقترحه Unity نفسها: "Read the Unity console messages and summarize any warnings or errors." أي: "اقرأ رسائل وحدة التحكم في Unity ولخّص أي تحذيرات أو أخطاء." إذا أعاد Claude محتوى وحدة التحكم الفعلي لديك، فالجسر يعمل.

ما التكلفة الفعلية

الخادم هو الجزء الرخيص. النموذج الذي يقف خلفه هو من يحدد حجم الفاتورة.

الخادم مجاني

يستخدم MCP for Unity وmcp-unity ترخيص MIT، ويستخدم Unity-MCP ترخيص Apache-2.0. وUnity CLI مجاني أيضًا، ولا يتطلب تثبيته اشتراكًا في Unity AI. لا يفرض أي منها رسومًا على كل استدعاء أو على كل مقعد أو على كل مشهد.

خطة Claude Code أو واجهة API

يُدرج Claude Code في جميع خطط Claude المدفوعة، ويشارك حدود الاستخدام الخاصة بالخطة، باستثناء خطة Free.

حساب واجهة API سهل التحقق منه. جلسة تقرأ 400,000 توكن إدخال وتكتب 40,000 توكن إخراج على Sonnet 5.5 تكلّف $0.80 زائد $0.40، أي $1.20. تُضخّم هياكل المشاهد ومخرجات وحدة التحكم جانب الإدخال، لذا اطلب قراءات ضيقة، مثل مشهد واحد أو نص واحد في كل مرة.

أرصدة Unity AI على المسار الرسمي

منتج Unity للذكاء الاصطناعي عملية شراء منفصلة. يحصل المستخدمون الشخصيون على تجربة مجانية لمدة 14 يومًا مع 1,000 نقطة، ثم $10 شهريًا ما لم يلغوا. وتتضمن مقاعد Pro وEnterprise وIndustry حصة شهرية من الأرصدة لا تُرحَّل إلى الشهر التالي. تسمح بوابة الذكاء الاصطناعي في Unity بربط Claude Code باشتراكك الحالي في Anthropic دون إنفاق أرصدة Unity AI، لذا تتجنب خطة Claude مع CLI دفع المبلغ مرتين.

خيارات مجانية تعمل فعلًا

يحتاج لفظ "مجاني" هنا إلى تعريف. الخوادم مجانية. النموذج هو الجزء الذي تدفع ثمنه، ما لم تكن تدفعه أصلًا.

خادم مجاني، وخطة تملكها أصلًا

لأن MCP for Unity يعمل مع Claude Desktop وVS Code وCursor وWindsurf وCline وGemini CLI، يمكنك ربطه بأي مساعد تدفع ثمنه بالفعل. طبقة MCP تضيف $0. إذا كانت لديك خطة Claude Pro، فإن Claude Code مدرج فيها، ويكلّفك المجموع كله مبلغ $20 الذي كنت تنفقه أصلًا.

نماذج مفتوحة مع تحفظات

بعض عملاء MCP يستطيعون توجيه الطلبات إلى نموذج مفتوح الأوزان مستضاف ذاتيًا. تعامل مع ذلك كمشروع عطلة نهاية أسبوع، لا كإعداد جاهز للتشغيل: استدعاء الأدوات هو المكان الذي تتعثر فيه النماذج المحلية الصغيرة، وتشير Unity نفسها إلى أن بعض النماذج لا تركّب أسطر الأوامر بموثوقية. اختبر بأمر تلخيص وحدة التحكم أعلاه قبل أن تثق بنموذج كهذا في مشهد.

يعمل Unity CLI أيضًا دون أي وكيل. يثبّت إصدارات المحرر ويديرها، ويدير المشاريع، ويشغّل عمليات البناء دون واجهة رسومية، ويشغّل مجموعات الاختبار، مما يجعله أداة تكامل مستمر مجانية بذاته.

أما في جانب التفكير فقط، مثل صياغة نص C# أو قراءة نص الخطأ، فيمكن لنماذج الدردشة المستضافة على PicassoIA، مثل GPT OSS 20B أو Granite 8B Code Instruct 128K، أن تؤدي هذا الدور. لا تلمس هذه النماذج المحرر أبدًا، لذلك ستنسخ الكود يدويًا.

إصلاح أخطاء الاتصال الشائعة

معظم الأعطال تأتي من عدم تطابق الإصدارات أو من مسار خاطئ، لا من Claude. اعمل على هذه القائمة بالترتيب.

💡 غيّر شيئًا واحدًا في كل مرة، وأعد تشغيل أمر تلخيص وحدة التحكم بعد كل تغيير. تخمين ثلاثة إعدادات معًا هو ما يحوّل إصلاحًا من عشر دقائق إلى مساء كامل.

فن الألعاب حول سير عمل MCP

يحرّك خادم MCP الكائنات داخل المحرر. لا يرسم الملمسات الخاصة بك ولا ينحت قطع الديكور، لذا تأتي تلك الأصول من مكان آخر.

فن المفاهيم والقوام بالذكاء الاصطناعي

تملأ نماذج الصور الفجوة بين "أحتاج إلى جدار حجري مغطى بالطحالب" وملف في مجلد Assets. أنشئ صورًا مرجعية أو خيارات قوام مسطحة أولية باستخدام Seedream 4.5 أو Qwen Image 3 أو GPT Image 2، ثم نظّف العيوب باستخدام PicassoIA Image Editor Pro، ثم استورد الملفات واطلب من Claude عبر MCP أن ينشئ مادة ويعيّنها للكائنات المناسبة.

تحقق من الوصلات قبل أن تبلّط أي شيء. لا يُضمن أن تتكرر صورة مولّدة واحدة بسلاسة، لذا اختبر المادة على سطح كبير أولًا.

أين تناسب النماذج ثلاثية الأبعاد

مكتبة PicassoIA مبنية حول نماذج الصور والفيديو والصوت واللغة، ولم يُرجع بحث في فئة ثلاثية الأبعاد لديها أي نماذج وقت كتابة هذا، لذا لن تمنحك شبكة مجسمات. لكنها تستطيع إنتاج المراجع التي يحتاجها فنان ثلاثي الأبعاد أو أداة شبكات، مثل المناظر الأمامية والجانبية وثلاثية الأرباع لقطعة ديكور. وفي الأثناء يستطيع Claude أن يرسم مخطط مرحلة بأشكال أساسية عبر MCP، وأنت تستبدلها بالشبكات الحقيقية عند وصولها.

كيف تستخدم Sonnet 5 على PicassoIA

Claude Sonnet 5 لن يشغّل محررك، لكنه طريقة سريعة لصياغة نص C# وتصحيحه قبل أن يصل أي نص إلى Unity.

1. افتح صفحة نموذج Claude Sonnet 5.
2. املأ System Prompt مرة واحدة: "تكتب بلغة C# لمحرك Unity 6. أعد نصًا واحدًا في كل كتلة شيفرة. بدون عناصر نائبة."
3. الصق خطأ وحدة التحكم والنص في Prompt. يمكنك أيضًا إرفاق لقطة شاشة لوحدة التحكم كإدخال Image اختياري.
4. اضبط Effort. القيمة الافتراضية هي low، وهي تتجاوز التفكير الموسّع لأسرع إجابة وأرخصها. استخدم high عندما يمتد الخطأ عبر عدة نصوص، وmax للحالات العنيدة.
5. اترك Max Tokens على القيمة الافتراضية 8,192 ما لم يُقطع نص طويل.
6. انسخ المخرجات إلى Unity، أو الصقها في Claude Code كمواصفات لما تريد بناءه.

💡 يصغّر إدخال الصورة الصور إلى 0.5 ميغابكسل بشكل افتراضي. إذا بدا نص وحدة التحكم غير واضح في الإجابة، فاقتطع لقطة الشاشة لتشمل سطور الخطأ فقط بدلًا من إرسال النافذة كاملة.

هل تفضّل نموذجًا آخر؟ Claude Opus 4.7 وClaude 4.5 Haiku وClaude Fable 5 كلها موجودة في مجموعة النماذج اللغوية الكبيرة نفسها.

أنشئ فن ألعابك بنفسك

لديك الآن مسار عملي من جملة في الطرفية إلى مشهد متغيّر، ورؤية واضحة لتكلفة كل جزء. الجزء الناقص هو الفن الذي يملأ المشهد.

افتح Picasso IA وجرّبه على مشروعك. ابدأ بقطعة ديكور واحدة تؤجل صنعها دائمًا، واكتب لها أمرًا نصيًا قصيرًا في Seedream 4.5، وقارنه بالأمر نفسه في Qwen Image 3، واحتفظ بالنتيجة التي تناسب مشهدك. ثم دع خادم Unity MCP لديك يضعها في مكانها. تصفّح القائمة الكاملة على picassoia.com/en/all-models وجرّب عدة تجارب قبل بنائك التالي.