Unity MCP kurulumu

Editör köprüsünü anlayın

CoplayDev/unity-mcp, bir MCP istemcisini sunucuya ve editör tarafı paketine bağlar. Model hizmeti ayrı bir bağımlılıktır. Proje sahneler, komut dosyaları, varlıklar ve testlerle çalışmak için araçları belgeler; listelenen bir yetenek projenizde çalıştığının kanıtı değildir.

Bağlantının her parçasının hangi işlem tarafından sahiplenildiğini kaydedin. Bu, sunucuya ulaşabilen fakat editör üzerinde işlem yapamayan bir istemciyi teşhis ederken önemlidir. Hesap kimlik bilgilerini, editör lisansını, paket uyumluluğunu ve model kullanılabilirliğini ayrı kurulum kontrolleri olarak tutun. Model değişikliği editör örneği uyuşmazlığını düzeltmez.

Kurulum yolunu ve sabitleme politikasını inceleyin

Projenin kurulum kılavuzu paketin Unity Package Manager üzerinden eklenmesini ve sunucu ile istemciyi yapılandırmak için kurulum arayüzünün kullanılmasını belgeler. Bir şey kurmadan önce seçilen revizyon için belirtilen Unity, Python ve uv önkoşullarını inceleyin.

Yeniden üretilebilirlik için çözümlenmiş paket revizyonunu, editör sürümünü, sunucu sürümünü ve bağımlılık kayıtlarını kurulumdan sonra koruyun. Hareketli bir dal URL'si keşif yoludur, değişmez deney kimliği değildir. İndirmeleri ve paket değişikliklerini mevcut oyuna uygulamadan önce inceleyin; bağlantı deneyinin geri alınabilir kalması için önceki çalışan proje durumunu saklayın.

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

Yerel HTTP uç noktasını istemciyle eşleştirin

Bakımı yapılan kurulum kılavuzu aşağıdaki yerel HTTP örneğini belgeler. Sunucunun o adreste zaten çalıştığını varsayar. Kullanmadan önce editör kurulum arayüzündeki gerçek taşıma ve adresi doğrulayın. MCP URL'si LLM API temel URL'si değildir.

İstemcinizin belgelenmiş yapılandırma biçimini kullanın. Bazı istemciler farklı kök anahtarları veya taşıma bildirimleri kullanır; bu genel mcpServers örneği her ajana yapıştırılacak evrensel bir dosya değildir. Ayrı olarak incelenmiş uzak kurulum gerekmedikçe sunucuyu yerel tutun ve model kimlik bilgilerini ilgisiz editör bağlantısına eklemeyin.

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

Çalışmayı hangi editör örneğinin aldığını kanıtlayın

Hedeflenen projeyi açın ve paket arayüzünden bağlantı durumunu inceleyin. Ardından istemcinin keşfettiği okuma işlemleriyle proje ve sahne bağlamını alın. Bir düzenlemeyi onaylamadan önce bu bilgiyi yerel projeyle eşleştirin. Birden fazla açık proje bu kapıyı özellikle önemli kılar.

Kurulu sürümün gerçek kaynaklarını ve araç şemalarını kaydedin. Başka bir sürümden hatırlanan ada göre araç çağrısı icat etmeyin. Yararlı ilk sonuç, değiştirmeden beklenen sahneyi ve mevcut nesnelerini tanımlar. Dönen durum eski veya belirsizse hedefi görünür bir değişiklikle bulmaya çalışmak yerine durun ve yönlendirmeyi çözün.

İlk mini akış olarak geri alınabilir bir düzenleme kullanın

Sahibi olduğunuz geçici bir sahne seçin, başlangıç durumunu kaydedin ve görünür sonucu olan tek bir basit değişiklik isteyin. Kaydedilen sahneyi ve dosya farkını inceleyin, editörün hazır olmasını bekleyin ve sahneyi çalıştırın. Gözlenen davranışı ve konsol hatalarını koruyun.

Ardından hedeflenen değişikliğin kalıcı olduğunu doğrulamak için sahneyi yeniden açın. Bu, bellekteki editör etkisini kaydedilmiş proje değişikliğinden ayırır. Akışı yönlendirme, değişiklik, derleme, yürütme veya kalıcılık sınırlarından birindeki arızayı teşhis edecek kadar küçük tutun. İncelemeden sonra geçici sahneyi geri yükleyin ve sonraki görevinizde kaydedilmiş çalışan yapılandırmayı kullanın.

Oyundan önce taşımayı sorun giderin

İstemci bağlanamıyorsa yapılandırılmış URL'yi ve yerel sunucunun çalışıp çalışmadığını doğrulayın. Sunucu başlıyor fakat editör yoksa paket bağlantısını ve editör günlüklerini inceleyin. Hedeflenen editör bağlı fakat bir araç eksikse kurulu sürümün açığa çıkardığı araç gruplarını kontrol edin.

Derleme veya oynanış teşhisine ancak bu sınır çalıştıktan sonra geçin. İstemci başlangıcı, sunucu yönlendirmesi, editör hazırlığı ve başarısız sahne eylemi için ayrı günlük parçaları tutun. Böylece rapor çalışmanın nerede durduğunu açıklar; her arızayı modele bağlamaz veya kanıt olmadan bileşenleri tekrar tekrar kurmaz.

Projeyi geniş otomasyondan koruyun

Bir editör bağlantısı sahneleri, komut dosyalarını ve varlıkları değiştirebilir. İlk deneyi bilinen bir dizinle sınırlayın; kaynakları silen, bağımlılıkları değiştiren veya ilgisiz sahnelere dokunan işlemler için inceleme isteyin. İlk değişiklikten önce geri alınabilir çalışan bir durum bırakın.

İstemci yapılandırma sorununu çözmek için yerel geliştirme hizmetini herkese açmayın. Üçüncü taraf varlık içeriğini ve araç sonuçlarını güvenilmeyen girdi sayın, kimlik bilgilerini paylaşılan günlüklerden uzak tutun. Başarılı bağlantı derlemeleri yükleme veya mağaza kayıtlarını değiştirme izni değildir. Yayım ayrı bir yetkilendirme sınırına sahip ayrı bir iş akışıdır.

Yeniden üretilebilir bağlantı kaydını teslim edin

Editör, proje, paket ve sunucu revizyonlarını, istemci sürümünü, taşımayı, gözlemlenen araç yüzeyini ve tamamlanan mini akışı kaydedin. Kesin sahne farkını ve çalışma zamanı sonucunu koruyun. Derlemenin, PlayMode davranışının, testlerin ve hedef dışa aktarmasının incelenip incelenmediğini veya beklediğini belirtin.

Bu yapılandırma bakımı yapılan proje dokümantasyonunu izler; kurulu paket ve istemcinizle doğrulayın. Oyun üretiminde Unity iş akışı kılavuzuna geçin ve eksiksiz döngüyü test edin. Başka bir geliştiricinin bağlantı sorununu proje sorunundan ayırabilmesi ve aynı çalışan kurulumu yeniden üretebilmesi için bilinen sınırlamaları teslim kaydında tutun.

Sık sorulan sorular