Roblox Studio MCP sunucusuna bağlanma

Roblox Studio MCP sunucusu, Roblox Studio'ya entegre edilmiştir. AI araçlarının harici uygulamalarla güvenli bir şekilde iletişim kurmasını sağlayan açık bir standart olan Model Context Protocol (MCP)'yi uygular. Bağlandığınızda, AI istemciniz açık Studio oturumunuzla doğrudan etkileşimde bulunabilir, veri modelini keşfedebilir, betikler yazabilir, Luau kodu çalıştırabilir ve oyununuzu oyun modunda test edebilir.

Bu kılavuz, Studio MCP sunucusunu popüler AI istemcilerine nasıl bağlayacağınızı gösterir. Kurulum istemciye göre değişiklik gösterse de, temel fikir aynıdır: istemcinizi MCP sunucusuna bağlayacak şekilde yapılandırırsınız ve ardından istemciden aktif Studio oturumunuza komutlar gönderirsiniz.

Ön koşullar

Sunucuya bağlanmadan önce, bilgisayarınızda en son Roblox Studio sürümüne ve tercih ettiğiniz MCP istemcisine sahip olduğunuzdan emin olun.

Studio MCP sunucusu nasıl çalışır

Sunucu, makinenizde yerel bir işlem olarak çalışır ve AI istemcisiyle stdio taşıma kullanarak iletişim kurar; bu, standart giriş/çıkış akışlarını kullanır. Tüm eylemler, AI istemciniz aracılığıyla başlatılır ve ardından bu kanal üzerinden Studio oturumunuzda eylemleri gerçekleştirmek için bir istek gönderilir.

Sunucu aşağıdaki araçları sağlar:

Studio'da MCP sunucusunu etkinleştirin

Studio'da MCP sunucusunu etkinleştirmek için:

1. Yardımcı'yı açın.
2. … ⟩ MCP Sunucularını Yönet'e tıklayın.
3. Studio'yu MCP sunucusu olarak etkinleştir'i açın.

Etkinleştirildiğinde, ayarlar paneli hızlı bağlantı seçeneğini ve farklı istemciler için kurulum talimatlarını gösterir. Bir istemci başarıyla bağlandığında, bağlı istemcilerin sayısını gösteren yeşil bir gösterge görünür.

İstemcinizi bağlayın

İstemcinizi Studio MCP sunucusuna hızlı bağlantı, bir JSON yapılandırması veya bir CLI komutu kullanarak bağlayabilirsiniz.

• İstemciniz destekleniyorsa hızlı bağlantı kullanın.
• Değilse, istemciniz MCP yapılandırma dosyalarını destekliyorsa JSON yapılandırması kullanın.
• Aksi takdirde, bir CLI komutu kullanın.

Studio MCP sunucusu, stdio taşımasını destekleyen herhangi bir istemciyle çalışır. Yapılandırmayı ekledikten sonra, istemcinizin belgelerini takip ederek kurulumu tamamlayın, ardından değişikliklerinizi uygulamak için istemciyi yeniden başlatın.

Hızlı bağlantı

Hızlı bağlantı aşağıdaki istemcileri destekler:

• Antigravity
• Codex CLI
• Claude Code
• Claude Desktop
• Cursor
• Gemini CLI
• Visual Studio Code

Hızlı bağlantı kullanarak bağlanmak için:

1. Yardımcı Ayarları ⟩ MCP Sunucuları'na gidin.
2. Bilgisayarınıza kurulu desteklenen istemcileri görüntülemek için Hızlı bağlantı açılır menüsünü genişletin.
3. Seçtiğiniz istemciyi açın.

İstediğiniz istemci Hızlı bağlantı listesinde görünmüyorsa, onu yükleyin ve Roblox Studio'yu yeniden başlatın.

JSON yapılandırması

Çoğu MCP istemcisi JSON yapılandırma dosyalarını destekler. Aşağıdaki örnekler kullanabileceğiniz tam yapılandırmaları göstermektedir.

Eğer Roblox Studio tek MCP sunucunuzsa, bu yapılandırmaları olduğu gibi kullanın. Birden fazla MCP sunucusu kullanıyorsanız, Roblox_Studio girişini kopyalayın ve mevcut mcpServers sözlüğünüze ekleyin.

Yapılandırmalar işletim sistemine göre değişiklik gösterir:

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

CLI komutu

Bazı MCP istemcileri JSON yapılandırması yerine bir CLI komutu gerektirir. İşletim sisteminize uygun komutu kullanın:

cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat

/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Birden fazla Studio örneği kullanma

Tek bir MCP istemcisini aynı anda birden fazla çalışan Studio örneğine bağlayabilirsiniz. Sunucu, bağlam temelinde hangi örneği kullanacağını otomatik olarak belirler (örneğin, belirli bir oyunu veya yalnızca o örnekte bulunan bir nesneyi referans alıyorsanız).

list_roblox_studios ve set_active_studio kullanarak örnekleri manuel olarak değiştirebilirsiniz.

Bağlantınızı doğrulayın

İstemcinizi kurduktan sonra, bağlantının Roblox Studio'da çalıştığını doğrulayın:

1. Yardımcı'yı açın.
2. … ⟩ MCP Sunucularını Yönet'e tıklayın.
3. Studio'yu MCP sunucusu olarak etkinleştir altında, istemcinin başarıyla bağlandığını doğrulamak için yeşil göstergenin olup olmadığını kontrol edin.

Sorun Giderme

Eğer sunucu görünmüyorsa veya araçlar mevcut değilse:

• Hem Roblox Studio'yu hem de MCP istemcinizi yeniden başlatın.
• Komutun veya ikili dosya yolunun doğru olduğunu ve dosyanın mevcut olduğunu doğrulayın.
• JSON sözdiziminizi kontrol edin. Eksik bir virgül veya parantez bile yapılandırmanın yüklenmesini engelleyebilir.