הגדרת Unity MCP

הבינו את גשר העורך

CoplayDev/unity-mcp מחבר לקוח MCP לשרת ולחבילה בצד העורך. שירות המודל הוא תלות נפרדת. הפרויקט מתעד כלים לעבודה עם סצנות, סקריפטים, נכסים ובדיקות, אך יכולת שמופיעה ברשימה אינה ראיה שהיא עובדת בפרויקט שלכם.

תעדו איזה תהליך אחראי לכל חלק בחיבור. הדבר חשוב כאשר לקוח יכול להגיע לשרת אך אינו יכול להפעיל את העורך. שמרו פרטי חשבון, רישוי עורך, תאימות חבילות וזמינות מודל כבדיקות הגדרה נפרדות. שינוי מודל לא יתקן אי-התאמה של מופע עורך.

בדקו את נתיב ההתקנה ואת מדיניות הקיבוע

מדריך התקנת הפרויקט מתעד הוספת החבילה דרך Unity Package Manager ושימוש בממשק ההגדרה להגדרת השרת והלקוח. בדקו את דרישות הקדם המוצהרות של Unity, Python ו-uv עבור ה-revision שנבחר לפני התקנת דבר.

לשחזוריות שמרו לאחר ההגדרה את ה-revision שנפתר של החבילה, גרסת העורך, גרסת השרת ורשומות התלויות. URL של ענף משתנה הוא נתיב גילוי, לא זהות ניסוי בלתי משתנה. בדקו הורדות ושינויי חבילות לפני החלתם על משחק קיים, ושמרו את מצב הפרויקט העובד הקודם כדי שניסוי החיבור יישאר הפיך.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

התאימו את נקודת הקצה המקומית של HTTP ללקוח

מדריך ההתקנה המתוחזק מתעד את דוגמת HTTP המקומית שלהלן. היא מניחה שהשרת כבר רץ בכתובת הזו. אשרו את התעבורה והכתובת שהוגדרו בפועל בממשק הגדרת העורך לפני שימוש. כתובת ה-MCP אינה כתובת בסיס של LLM API.

השתמשו בפורמט התצורה המתועד של הלקוח שלכם. חלק מהלקוחות משתמשים במפתחות שורש או בהצהרות תעבורה שונים, לכן דוגמת mcpServers הכללית הזו אינה קובץ אוניברסלי להדבקה בכל סוכן. השאירו את השרת מקומי אלא אם נדרשת הגדרה מרוחקת שנבדקה בנפרד, ואל תוסיפו פרטי גישה למודל לחיבור עורך שאינו קשור.

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

הוכיחו איזה מופע עורך מקבל את העבודה

פתחו את הפרויקט המיועד ובדקו את מצב החיבור דרך ממשק החבילה. לאחר מכן השתמשו בפעולות הקריאה שהתגלו אצל הלקוח כדי לקבל הקשר פרויקט וסצנה. התאימו את המידע לפרויקט המקומי לפני אישור עריכה. מספר פרויקטים פתוחים הופך שער זה לחשוב במיוחד.

תעדו משאבים בפועל וסכמות כלים מהגרסה המותקנת. אל תמציאו קריאת כלי משם שזכור מגרסה אחרת. תוצאה ראשונה שימושית מזהה את הסצנה הצפויה ואת האובייקטים הקיימים בה בלי לשנות אותם. אם המצב המוחזר ישן או עמום, עצרו ופתרו את הניתוב במקום לנסות שינוי נראה כדי לגלות את היעד.

השתמשו בעריכה הפיכה כ-miniflow ראשון

בחרו סצנה disposable בבעלותכם, תעדו את מצבה ההתחלתי ובקשו שינוי פשוט אחד עם תוצאה נראית. בדקו את הסצנה שנשמרה ואת ה-diff של הקובץ, המתינו שהעורך יהיה מוכן והפעילו את הסצנה. שמרו התנהגות שנצפתה ושגיאות console.

לאחר מכן פתחו מחדש את הסצנה כדי לאשר שהשינוי המיועד נשמר. כך מבחינים בין אפקט עורך שבזיכרון לבין שינוי פרויקט שנשמר. שמרו על התהליך קטן מספיק כדי לאבחן כשל בגבול אחד: ניתוב, שינוי, קומפילציה, ביצוע או התמדה. שחזרו את הסצנה disposable לאחר הבדיקה והשתמשו בתצורה העובדת שתועדה למשימה הבאה.

פתרו את התעבורה לפני המשחק

כאשר הלקוח אינו יכול להתחבר, אמתו את ה-URL שהוגדר ואם השרת המקומי פועל. כאשר השרת מתחיל אך העורך אינו קיים, בדקו את חיבור החבילה ואת יומני העורך. כאשר העורך המיועד מחובר אך כלי חסר, בדקו את קבוצות הכלים שהגרסה המותקנת חושפת.

רק לאחר שהגבול הזה עובד יש לאבחן קומפילציה או משחק. שמרו קטעי יומן נפרדים להפעלת לקוח, ניתוב שרת, מוכנות עורך ופעולת הסצנה שנכשלה. כך הדוח יכול להסביר היכן הביצוע נעצר במקום לייחס כל כשל למודל או להתקין רכיבים שוב ושוב בלי ראיות.

הגנו על הפרויקט מפני אוטומציה רחבה

חיבור עורך עשוי לשנות סצנות, סקריפטים ונכסים. הגבילו את הניסוי הראשוני לספרייה ידועה ודרשו בדיקה לפעולות שמוחקות משאבים, משנות תלויות או נוגעות בסצנות לא קשורות. שמרו מצב עבודה שניתן לשחזור לפני השינוי הראשון.

אל תחשפו שירות פיתוח מקומי לציבור רק כדי לפתור בעיית תצורת לקוח. התייחסו לתוכן נכס צד שלישי ולתוצאות כלים כאל קלטים שאינם מהימנים ושמרו פרטי גישה מחוץ ליומנים משותפים. חיבור מוצלח אינו הרשאה להעלות builds או לשנות רשומות חנות. פרסום נשאר תהליך נפרד עם גבול אישור נפרד.

מסרו רשומת חיבור שניתנת לשחזור

תעדו את גרסאות העורך, הפרויקט, החבילה והשרת, גרסת הלקוח, התעבורה, משטח הכלים שנצפה וה-miniflow שהושלם. שמרו את ה-diff המדויק של הסצנה ואת תוצאת הריצה. ציינו אם קומפילציה, התנהגות PlayMode, בדיקות וייצוא יעד נבדקו או עדיין ממתינים.

ההגדרה הזו עוקבת אחר תיעוד הפרויקט המתוחזק; אמתו אותה מול החבילה והלקוח המותקנים שלכם. לייצור משחקים המשיכו למדריך תהליך Unity ובדקו את הלולאה המלאה. שמרו מגבלות ידועות במסירה כדי שמפתח אחר יוכל להבחין בין בעיית חיבור לבעיית פרויקט ולשחזר את אותה הגדרה עובדת.

שאלות נפוצות