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 uygulamaktadır. Bağlandığınızda, AI istemciniz açık Studio oturumunuzla doğrudan etkileşime girebilir, veri modelini keşfedebilir, script yazabilir, Luau kodunu çalıştırabilir ve deneyiminizi 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şkenlik gösterse de, temel fikir aynıdır: istemcinizi MCP sunucusuna bağlarsınız ve ardından istemciden aktif Studio oturumunuza komutlar gönderirsiniz.
Gereksinimler
Sunucuya bağlanmadan önce, bilgisayarınızda en son Roblox Studio sürümünün ve tercih edilen MCP istemcinizin yüklü olduğundan emin olun.
Studio MCP sunucusunun çalışma şekli
Sunucu, bilgisayarınızda yerel bir işlem olarak çalışır ve AI istemcisi ile stdio iletimi kullanarak iletişim kurar. Bu, standart girdi/çıktı akışlarını kullanır. Tüm işlemler AI istemciniz aracılığıyla başlatılır ve bu kanal üzerinden Studio oturumunuzda eylemleri gerçekleştirmek için bir istekte bulunur.
Sunucu aşağıdaki araçları sağlar:
| Scriptler | |
|---|---|
| script_read | Oyun içinden bir script okumak için nokta notasyonu yollarını kullanır (örneğin, game.ServerScriptService.MyScript). Tüm scriptleri veya belirli satır aralıklarını okumayı destekler. |
| multi_edit | Bir işlemin içinde bir scriptte çoklu düzenlemeler uygular. Hedef yol mevcut değilse yeni bir script oluşturur. Bir datamodel_type (Düzenle) belirtmenizi gerektirir. |
| script_search | İsimle bulmak için scriptleri bulan karmaşık eşleşme sağlar. En fazla 10 sonuç döner. |
| script_grep | Oyun içindeki tüm scriptlerde bir dize desenini arar. En fazla 50 eşleşme döner. |
| Varlık ve içerik oluşturma | |
| generate_mesh | AI kullanarak metin isteminden dokulu 3D bir ağ oluşturur. |
| generate_material | Özel bir malzeme varyantı oluşturur. Parçalar üzerine uygulamak için temel malzeme ve malzeme varyantı adını döner. |
| generate_procedural_model | Temel parçalar (bloklar, küreler, silindirikler, eğikler) ile oluşturulan 3D nesneleri, yapılandırılabilir özellikler ile ProceduralModel olarak oluşturur. Referans resimleri ve özel parça şemalarını destekler. |
| wait_job_finished | Bir prosedürel model oluşturma işinin bitmesini bekler ve nihai durumu döner. |
| search_asset | Creator Store (kamusal pazar yeri) ve Creator Inventory (üye, grup veya evren) üzerinden varlıkları arar. Varlık türü, fiyat, etiketler ve kapsam ile filtreleme desteği verir. |
| insert_asset | Bir varlığı oyun içine sayısal Roblox varlık ID'si ile ekler. Modeller, ağlar, resimler, sesler, videolar, animasyonlar ve paketleri destekler. |
| upload_image | HTTP URL'lerinden bir dizi resmi Roblox varlık sunucusuna yükler ve bir resim yolu ile varlık ID'si haritası döner. |
| store_image | Yerel bir dosya yolundan bir resmi yükler ve diğer araçlara geçirilebilecek bir resim URI'si döner (örneğin, generate_procedural_model için bir referans resmi olarak). |
| Veri modeli keşfi | |
| subagent | Karmaşık, çok adımlı görevleri otonom olarak gerçekleştirmek için bir alt acente başlatır. Mevcut türler arasında explore (kod tabanı araştırması ve oyun durumu sorgulamaları için) ve playtest (oyun senaryolarını çalıştırmak ve sonuçları doğrulamak için) vardır. |
| search_game_tree | Örnek hiyerarşisini düz bir JSON dizisi olarak keşfeder. Yol, örnek türü ve anahtar kelime filtrelemelerini destekler; derinlik sınırlaması yapılandırılabilir. |
| inspect_instance | Belli bir örnek hakkında, tüm okunabilir özellikler, özel nitelikler ve çocukları ile torunlarının bir özetini içeren ayrıntılı bilgi döner. |
| Luau yürütme | |
| execute_luau | Studio'da Luau kodunu çalıştırır. Sonucu veya bir hatayı döner. Bir datamodel_type (Düzenle, İstemci veya Sunucu) belirtmenizi gerektirir. |
| Oyun testi | |
| get_studio_state | Studio'nun mevcut durumunu, oyun durumunu ve mevcut veri modeli türlerini alır. |
| start_stop_play | Oyun testini başlatır veya durdurur. |
| get_console_output | Studio çıkış kaydından çıktıyı alır. |
| screen_capture | Mevcut Studio görüntüleme penceresini yakalar ve görüntü verilerini döner. Opsiyonel olarak özel bir kamera pozisyonu ve bakış hedefi alır. |
| Oyuncu girişi simülasyonu | |
| character_navigation | Oyuncu karakterini belirli bir konum veya örnek yoluna taşır. Yapılandırılabilir bir hız çarpanını destekler. |
| user_keyboard_input | Bir veya daha fazla klavye eylemini sırayla gönderir: tuş basma, tuş bırakma, tuşa basma, metin girişi veya bekleme. Belirli UI örneklerini hedeflemeye destek verir. |
| user_mouse_input | Bir veya daha fazla fare eylemini sırayla gönderir: hareket, tıklama, düğme aşağı / yukarı, kaydırma veya bekleme. Belirli örnekleri veya ekran koordinatlarını hedeflemeye destek verir. |
| Belge ve beceriler | |
| http_get | İzin verilen Roblox belge URL'lerinden içerik alır (Motor API referansı, Yaratıcı belgeleri, Bulut API'si, performans optimizasyon kılavuzları). Elde edilen içerikte anahtar kelime araması yapmağa destek verir. |
| skill | Ayrıntılı bilgi, en iyi uygulamalar veya hata ayıklama, cihaz simülasyonu ve belge arama gibi belirli beceriler için referans materyali alır. |
| Oturum yönetimi | |
| list_roblox_studios | Tüm bağlı Studio örneklerini, isimleri, ID'leri ve aktif durumları ile listeler. Birden fazla Studio penceresi açıkken faydalıdır. |
| set_active_studio | Tüm ardışık araç çağrılarının bu örneğe hedeflenmesi için bir Studio örneğini aktif olarak ayarlar. |
Studio'da MCP sunucusunu etkinleştirin
Studio'da MCP sunucusunu etkinleştirmek için:
- Yardımcı'yı açın.
- … ⟩ MCP Sunucularını Yönet'e tıklayın.
- Studio'yu MCP sunucusu olarak etkinleştir seçeneğini açın.
Etkinleştirildikten sonra, 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.
- Desteklemiyorsa, MCP yapılandırma dosyalarını destekliyorsa JSON yapılandırması kullanın.
- Aksi takdirde, CLI komutu kullanın.
Studio MCP sunucusu stdio iletimini destekleyen herhangi bir istemci ile çalışır. Yapılandırmayı ekledikten sonra, kurulum işlemini tamamlamak için istemcinizin belgelerini takip edin, ardından değişikliklerinizi uygulamak için istemciyi yeniden başlatın.
MCP istemcileri, açık Roblox mekanlarınızda içerik okuyabilir ve değiştirebilir. Yalnızca güvendiğiniz istemcileri bağladığınızdan emin olun.
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:
- Yardımcı Ayarları ⟩ MCP Sunucuları bölümüne gidin.
- Bilgisayarınıza yüklenmiş desteklenen istemcileri görüntülemek için Hızlı bağlantı açılır menüsünü genişletin.
- Seçtiğiniz istemciyi açın.
İstediğiniz istemci Hızlı bağlantı listesini görünmüyorsa, 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. Eğer birden fazla MCP sunucusu kullanıyorsanız, Roblox_Studio girişini kopyalayıp mevcut mcpServers sözlüğünüze ekleyin.
mcp.json dosyanız başka girişler içerebilir. Roblox_Studio yapılandırmasını eklerken her girişin bir virgülle ayrıldığından emin olun. Eksik virgüller geçersiz JSON'a neden olur ve yapılandırmanın yüklenimini engelleyebilir.
Yapılandırmalar işletim sistemine göre değişir:
Windows
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
macOS
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
CLI komutu
Bazı MCP istemcileri, bir JSON yapılandırması yerine bir CLI komutu gerektirir. İşletim sisteminize uygun komutu kullanın:
Windows
macOS
Birden fazla Studio örneği kullanın
Tek bir MCP istemcisini aynı anda birden fazla çalışan Studio örneğine bağlayabilirsiniz. Sunucu, belirli bir deneyim ya da yalnızca o örnekte bulunan bir nesneye referans verdiğinizde hangi örneği kullanacağına otomatik olarak karar verir.
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:
- Yardımcı'yı açın.
- … ⟩ MCP Sunucularını Yönet'e tıklayın.
- 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 kullanılamıyorsa:
- Hem Roblox Studio'yu hem de MCP istemcinizi yeniden başlatın.
- Komutun veya ikili yolun doğru ve dosyanın mevcut olup olmadığını doğrulayın.
- JSON söz diziminizi kontrol edin. Hatta kaybolmuş bir virgül ya da parantez, yapılandırmanın yüklenmesini engelleyebilir.