← العودة إلى المدونة

ربط Codex أو ChatGPT بـ Unity MCP

اربط Codex أو ChatGPT بـ Unity MCP: خطوات Unity تطابق دليل التثبيت. Codex Open/Copy. ChatGPT STDIO: relay و--port وجذر Assets. تحقق من Hierarchy. VberAI.

نُشر في
  • unity
  • mcp
  • codex
  • chatgpt
  • tutorial
  • unity-mcp
  • ai

ما يغطيه هذا الدليل

كيف تربط Codex أو ChatGPT بـ Unity MCP؟ خطوات جانب Unity (الاستيراد، والتفعيل، وتشغيل الخادم) تطابق تثبيت Unity MCP وClaude Code + Unity MCP. هذا الدليل مخصص لإعداد عميل MCP فقط—Codex عبر Open/Copy وChatGPT عبر إعداد STDIO.

مسارَان:

  1. Codex CLI — في One-click Configuration، اختر Codex CLI، ثم Open (تلقائي) أو Copy لمقتطف config.toml
  2. ChatGPT سطح المكتب أو الويب — لا يوجد Open؛ قم بتعيين إعدادات relay المنسوخة في نموذج STDIO MCP (الأمر، والوسائط، ودليل عمل مشروع Unity)

عند الانتهاء، يجب أن يكون لديك:

  • Unity MCP Server بحالة Running في المحرر، مع ظهور المنفذ في اللوحة
  • unity-mcp (أو ما يعادله) مسجَّل في العميل مع ظهور الأدوات
  • أمر قراءة فقط يسرد كائنات اللعبة الجذرية في Hierarchy للمشهد النشط

المنتج: Unity MCP

المتطلبات المسبقة

العنصرملاحظات
Unityيُوصى بـ 2022.3+ / Unity 6 (راجع ملاحظات دعم المورّد الحالية)
Unity MCPمستورد ومفعَّل (دليل التثبيت)
الخادم يعملتعرض اللوحة Running؛ دوِّن المنفذ (6589 هو الافتراضي الشائع—استخدم ما تعرضه لوحتك)
Codex CLI أو ChatGPTدعم MCP مع خادم STDIO مخصص
مشروع Unityالمشروع الذي تريد أن يستخدمه الوكيل مفتوح في Unity
الشبكة المحليةعادةً يستمع الجسر على 127.0.0.1—لا تعرِّض المنفذ على الإنترنت العام

يجب أن تطابق قيمة --port لوحة Unity MCP، وليس رقمًا ثابتًا من مدونة أو لقطة شاشة.

الجزء 1: Unity (مطابق لدليل التثبيت)

إذا لم يكن Unity MCP مُعدًّا بعد، فاتبع تثبيت Unity MCP: Add package from disk ← التفعيل في لوحة MCP ← Start service حتى تصبح الحالة Running ← تفعيل الأدوات ضمن Tool management.

تفترض الخطوات أدناه أن Unity في حالة Running بالفعل.

الجزء 2: Codex CLI

  1. لوحة Unity MCP ← One-click Configuration ← Codex CLI
  2. Open لكتابة إعداد MCP، أو Copy لـ config.toml يدويًا
  3. الشكل أدناه مثال فقط—استخدم المسارات والمنفذ الخاصين بك من النسخ (مسارات Windows تختلف عن macOS):
[mcp_servers.unity-mcp]
command = "/Users/<you>/.unitymcp/relay/<relay-id>/unity-mcp-relay"
args = ["--stdio", "--port", "<panel-port>"]
  1. أعد تشغيل Codex CLI أو أعد تحميل MCP وفق وثائق Codex
  2. تأكد من ظهور unity-mcp وأدواته

للسياق الكامل لـ Unity + CLI، راجع Claude Code + Unity MCP (نفس خطوات Unity، لكن بعميل مختلف).

الجزء 3: ChatGPT سطح المكتب أو الويب

في لوحة Unity MCP، استخدم Codex CLI ← Copy لإعدادات relay، ثم عيِّن حقول TOML في ChatGPT. عند إضافة خادم يمكنك تعيين Name وType (STDIO). عند تحديث إدخال Unity-mcp موجود، تطابق الحقول أدناه لقطة الشاشة.

واجهة ChatGPT (بالإنجليزية)القيمة
Name (عند الإضافة)unity-mcp (مطابق لاسم قسم TOML)
Type (عند الإضافة)STDIO (وليس HTTP/SSE)
Start commandالمسار الكامل من command = "..." إلى unity-mcp-relay (استخدم مخرجات Copy على Windows أو Linux أو macOS)
Parametersثلاثة أسطر: --stdio ← --port ← رقم المنفذ من اللوحة
Environment variablesاتركها فارغة
Environment variable inheritanceاتركها فارغة
Working directoryجذر مشروع Unity (المجلد الذي يحتوي على Assets). تجنَّب القيم الافتراضية العامة مثل ~/code

مرجع واجهة ChatGPT لسطح المكتب

ChatGPT سطح المكتب: Plug-ins ← MCP ← Update Unity-mcp — أمر البدء، وثلاثة وسائط (--stdio، --port، رقم المنفذ)، ودليل العمل كما في الجدول

مسار relay والمنفذ ومجلد المشروع في لقطة الشاشة أمثلة فقط—استخدم مخرجات Copy من لوحتك ومسار المجلد الأب لـ Assets لديك.

انقر Save، ثم أغلق تطبيق ChatGPT لسطح المكتب بالكامل وأعد تشغيله (على الويب، حدِّث الصفحة وابدأ جلسة جديدة قبل اختبار MCP).

لماذا يهم دليل العمل

يتواصل relay مع ChatGPT عبر STDIO لكنه لا يزال بحاجة إلى جذر مشروع Unity للمحرر المفتوح لديك. غيِّر هذا المسار عند تبديل المشاريع.

ماذا تعني الإعدادات المنسوخة

  • unity-mcp-relay — جسر محلي بين عميل MCP وUnity MCP Server في المحرر
  • --stdio — تشغيل relay كعملية فرعية عبر الإدخال/الإخراج القياسي
  • --port — يجب أن يطابق منفذ الخدمة Running؛ المنفذ الخاطئ أو الخادم المتوقف يؤدي إلى إخفاقات أو مهل زمنية

تحقق من الاتصال

أرسل أمر قراءة فقط أولًا، على سبيل المثال:

اسرد كائنات اللعبة الجذرية للمشهد النشط في Unity عبر MCP.

إذا طابق الرد Hierarchy في Unity، جرِّب كتابة صغيرة (مثلًا إنشاء GameObject فارغ باسم MCP_SmokeTest، ثم حذفه). أجرِ commit إلى نظام التحكم بالإصدارات قبل التغييرات الكبيرة.

إذا كان الخادم Running لكن المحرر غير ظاهر ضمن النسخ النشطة، راجع الأسئلة الشائعة لتثبيت Unity MCP.

ورقة مرجعية سريعة للعملاء

العميلإجراء اللوحة المعتاد
Cursorauto configure بنقرة واحدة
Claude Code / Gemini CLICopy CLI command ← شغِّله في الطرفية
Codex CLIOpen أو Copy ← config.toml
ChatGPT سطح المكتب / الويبCopy لإعدادات relay ← نموذج STDIO + دليل العمل

نظرة عامة: أي عملاء AI يدعمهم Unity MCP

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

هل يعمل Copy في Codex مع ChatGPT؟
نعم—نفس command وarguments؛ لكن ChatGPT يحتاج أيضًا إلى دليل العمل الصحيح.

فشل اتصال MCP في ChatGPT؟
تحقق من: Unity Running؛ تطابق --port مع اللوحة؛ وجود مسار relay وقابليته للتنفيذ؛ كون دليل العمل هو المجلد الأب لـ Assets؛ ثم Save وإعادة تشغيل العميل.

لا توجد أدوات Unity في Codex؟
جرِّب Open من اللوحة مجددًا، أو أعد لصق Copy في config.toml وأعد تشغيل Codex. ما زلت متعثرًا ← النسخ النشطة.

هل ما زلت أكتب كل C# يدويًا؟
للنصوص اليومية، يمكن لـ AI إنشاء المكوّنات وإرفاقها عبر MCP—أنت تراجع التغييرات وتُجمِّع وتختبر في Play mode. احتفظ بملكية الإنسان للبنية المعمارية والشبكات والمسارات الحرجة (الأسئلة الشائعة للعملاء).

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

أدلة أخرى قد تعجبك

تصميم واجهة اللعبة: سير العمل التقليدي مقابل فن الذكاء الاصطناعي + تقسيم VberAI Studio

قارن التقطيع اليدوي في PS/Figma مع VberAI Studio: استيراد أو توليد الواجهة بالذكاء الاصطناعي، تقسيم الطبقات تلقائياً، تصدير PSD طبقية أو مجموعات صور. التأثيرات…

  • game-ui-design
  • game-ui-designer-flow
  • ui-slicing
  • AIGC
اقرأ المزيد