Godot MCP kurulumu

MCP'nin hangi bağlantıyı sağladığını anlayın

Coding-Solo/godot-mcp, Godot projelerini çalıştırmak, hata ayıklama çıktısını almak ve sahneler üzerinde işlem yapmak için araçları belgeler. Bu, proje tarafından sürdürülen bir köprüdür; model hizmeti veya resmî Godot dağıtımı değildir. Ajanın hâlâ kendi model erişimine ve uygun yerel izinlere ihtiyacı vardır.

Kurulum kaydınızda üç kimliği ayrı tutun: istemci, MCP sunucu revizyonu ve Godot çalıştırılabilir dosyası. Birindeki arıza diğerlerinin kullanılamadığını kanıtlamaz. Sorunu nerede inceleyeceğinize karar vermek için bağlantı şemasını kullanın: sağlayıcı kimlik doğrulaması, istemci yapılandırması, yerel araç işlemi veya motor projesi.

Önkoşulları sessizce değiştirmeden envanterleyin

Kurulumdan önce üst akış gereksinimlerini inceleyin ve incelenmek üzere belirli bir sunucu sürümü veya revizyon seçin. Mevcut motor ve çalışma zamanının yalnızca etkileşimli shell'den değil, istemci işleminden de bulunabildiğini doğrulayın. İşletim sistemini ve hedef proje dizinini kaydedin.

Bağımlılık değişikliğine izin vermeden önce üst akış kurulum yöntemini inceleyin. Çalışma zamanını, sunucu revizyonunu ve kurulum konumunu adlandırın; önceki ortamı geri yükleyecek bir yol bırakın. Kurulumdan sonra hareketli kaynak URL'sini değil, çözümlenmiş sürümleri kaydedin. İstemci veya motor yükseltildiğinde çalışan bağlantıyı yeniden üretmenize bu yardımcı olur.

Belgelenmiş yerel derleme giriş noktasını kullanın

Üst akış README'si, istemci giriş noktası olarak build/index.js ile kaynak derlemeyi ve açık çalıştırılabilir geçersiz kılması olarak GODOT_PATH'i destekler. Aşağıdaki JSON, yer tutucuları olan bu önceden derlenmiş yolu gösterir. Her yolu incelenmiş yerel kurulumla değiştirin ve istemci işleminin okuyabildiğini kontrol edin.

İstemcinizin gerçekten desteklediği şemayı kullanın. Genel bir mcpServers nesnesi otomatik olarak Codex yapılandırma dosyası değildir. Yalnızca o istemcinin belgelenmiş ayarları üzerinden çevirin ve model kimlik bilgilerini bu motor-aracı bloğunun dışında tutun. GUI istemcisinin ortamı terminalden farklıysa mutlak bir Node yolu yararlı olabilir.

{
  "mcpServers": {
    "godot": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/reviewed-godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/absolute/path/to/godot"
      }
    }
  }
}

Önce salt okunur araç yolunu doğrulayın

Hatırlanan bir listeye güvenmek yerine yapılandırılmış sunucunun döndürdüğü araçları inceleyin. README, yararlı inceleme işlemleri olarak get_godot_version ve get_project_info adlarını verir. Keşfedilen parametre şemalarını kontrol edin, ardından yalnızca onaylanmış proje dizinini hedefleyin.

Dönen motor ve proje bilgisini kurulum kaydıyla karşılaştırın. Yapısal sonuçları ve hataları koruyun. Gözlem hedeflenen çalışma alanını tanımlamadan sahne oluşturmaya onay vermeyin. İstemci bağlı rozeti gösteriyor fakat bu okumayı tamamlayamıyorsa oyun deneyi için hazır değildir. Rozet hangi işlem veya projeye ulaşıldığını göstermez.

Geri alınabilir tek bir sahne mini akışına izin verin

Okuma erişimi doğrulandıktan sonra ilk yazma için geçici, sahibi olduğunuz bir sahne kullanın. Özgün durumunu kaydedin, görünür bir değişiklik isteyin, kaydedilmiş sahneyi inceleyin, çalıştırın, çıktıyı alın ve projeyi durdurun. Ortaya çıkan dosya farkını ve gözlemleri birlikte tutun.

Kabul koşulu, istenen değişiklikten kaydedilmiş kaynağa ve görünür çalışma zamanı davranışına uzanan bir zincirdir. Bir araç başarı bildirdiği hâlde sahne değişmiyorsa ikinci bir değişiklik denemeden önce proje hedefini ve kayıt yollarını inceleyin. Kontrolün kalıcılığın yanı sıra bellekteki durumu da kapsaması için sahneyi kaydettikten sonra yeniden açın.

Arızaları doğru sınırda teşhis edin

İşlem başlangıcı başarısızsa çalışma zamanını ve giriş noktası yollarını inceleyin. Godot bulunamıyorsa istemcinin ortamından çalıştırılabilir geçersiz kılmasını doğrulayın. Proje incelenemiyorsa yolun project.godot içeren dizini tanımladığını ve işlemin okuyabildiğini kontrol edin.

Proje çalıştıktan sonra sahne veya oynanış hatalarını yeniden üretim bağlamıyla motor sorunu olarak ele alın. Yerel yol sorununu düzeltmek için sağlayıcı kimlik bilgilerini değiştirmeyin. Sunucu günlüklerini dikkatle yakalayın: paylaşmadan önce hassas dosya sistemi ayrıntılarını temizleyin ve ayrıntılı hata ayıklamayı her proje işlemini ayrım gözetmeden kaydetmek yerine geçici tutun.

Onay ve ağ sınırlarını dar tutun

Bir motor aracı çalışan projeyi değiştirebilir veya kod başlatabilir. Erişimi en küçük uygun dizine verin ve davranış anlaşılana kadar değişiklik isteklerini inceleyin. Örnek yapılandırmada göründüğü için geniş otomatik onay listelerini kopyalamayın.

İçe aktarılmış komut dosyalarını, eklentileri ve araç çıktısını yetkiyi genişletecek talimatlar olarak değil, incelenecek materyal olarak değerlendirin. Paket indirmeleri, sahibi olunan sahne dışındaki dosya silme, kimlik bilgisi değişikliği ve yayım açık karar gerektirir. İlk başarılı mini akış bir politikayı inceleme temelidir; gelecekteki her araç işlemine izin verme sebebi değildir.

Doğrulanmış kurulumun sınırlarını kaydedin

Tamamlanmış bir kurulum kaydı sunucu revizyonunu, istemciyi, motor sürümünü, proje yolunu, keşfedilen araçları, tamamlanan okumayı, geri alınabilir değişikliği ve çalışma zamanı sonucunu tanımlamalıdır. Hangi işlemlerin hâlâ test edilmediğini belirtin. Evrensel uyumluluk garantisi sunmak yerine kaydı oyun kanıtıyla birlikte tutun.

Sonraki katman üretim döngüsüdür: bir özellik uygulayın, davranışını yeniden üretin, dışa aktarın ve hedef platformda test edin. Buradaki yapılandırma üst akış dokümantasyonunu izler ve seçtiğiniz istemci ile sürümlerde doğrulanmalıdır. Bu sınırlı sonucu projeyle saklayın ve sunucu, motor veya istemci değiştiğinde aynı inceleme kapısını yeniden kullanın.

Sık sorulan sorular