Claude, Cursor ya da ChatGPT MCP ile Roblox Studio'ya nasıl bağlanır

Studio MCP sunucusu ne yapar

MCP (Model Context Protocol), yapay zeka araçlarının başka uygulamalarla konuşmasını sağlayan açık bir standarttır. Roblox, Studio'ya bir MCP sunucusu yerleştiriyor. Açık olduğunda bilgisayarındaki bir yapay zeka istemcisi açık olan oyunu keşfedebilir, script okuyup yazabilir, Luau çalıştırabilir ve oyunu Play modunda test edebilir, hepsini sunucunun sunduğu araçlarla.

Sunucu makinende yerel bir süreç olarak çalışır ve istemciyle stdio (standart girdi ve çıktı) üzerinden konuşur. Hiçbir şey kendiliğinden olmaz: her eylem istemcinden gelen bir istekle başlar ve hangi aracın çağrılacağına istemci karar verir. Roblox Studio'nun en son sürümüne ve kullanmak istediğin MCP istemcisine ihtiyacın var, ikisi de aynı bilgisayarda kurulu olmalı.

Claude ya da GPT'yi Studio ile kullanmanın iki yolu

Bu rehber birinci yolu anlatıyor. Tek istediğin Studio içinde yanıt veren bir Claude ya da OpenAI modeliyse ikincisi daha kısa: sağlayıcıdan bir API anahtarı al, Assistant'ı aç, … > Manage API Keys'e tıkla, sağlayıcıyı seç, anahtarı yapıştır ve Model açılır menüsünden modeli seç.

Adım 1: Studio'da MCP sunucusunu aç

1. Roblox Studio'yu aç ve bir oyun aç. Studio bir güncelleme öneriyorsa önce onu kur: sunucu en son sürümü ister.
2. Assistant penceresini açmak için Studio'nun sağ üstündeki (üst çubuğun sağ tarafı) Assistant'a tıkla.
3. …'ya tıkla ve Manage MCP Servers'ı seç.
4. Enable Studio as MCP server'ı aç.

Panel artık bir Quick connect seçeneği ve farklı istemciler için kurulum talimatları gösteriyor. Açık bırak. Bir sonraki adım için ona ihtiyacın var ve bağlantı göstergesi de orada çıkıyor.

Assistant butonu yoksa ya da pencere açılmıyorsa Assistant panelini açma ya da yeniden açma (İngilizce) sayfasına bak.

Adım 2: yapay zeka istemcini bağla

Roblox bağlanmak için şu sırayla üç yol veriyor: istemcin listedeyse Quick connect, istemci MCP yapılandırma dosyalarını okuyorsa bir JSON yapılandırması, buna ihtiyaç duyan istemciler için de bir CLI komutu.

Quick connect

Quick connect yedi istemciyi destekliyor (30 Eylül 2026 tarihli listeye göre): Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI ve Visual Studio Code.

1. Adım 1'deki panelde (Assistant Settings > MCP Servers) Quick connect'i aç. Kurulu olan uyumlu istemcileri gösterir.
2. İstediğin istemciyi aç.
3. İstemcin listede yoksa onu kur ve Roblox Studio'yu yeniden başlat. Studio açıkken kurduysan Studio'yu, istemciyi ya da ikisini birden yeniden başlatman gerekebilir.

İstemciye göre kurulum

Roblox'un coding harness rehberi MCP bağlantısını bir editörle birleştiriyor: Cursor ya da Claude Code gibi bir eklentiyle Visual Studio Code. Ajanın Studio'yu yönetmenin yanında kodu dosya olarak da yazmasını istiyorsan aşağıdaki Script Sync ve Git bölümüne bak.

Diğer istemciler: JSON yapılandırması ya da CLI komutu

Sunucu, stdio aktarımını destekleyen her istemciyle çalışır. Seninkinde Quick connect yoksa Roblox Studio'yu MCP yapılandırmasına ekle. Roblox'un belgelediği tam yapılandırmalar bunlar. Tek MCP sunucun Roblox Studio ise olduğu gibi kullan.

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

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

Yapılandırma dosyasının yeri istemciye bağlı (Roblox'un örneği ona mcp.json diyor). Roblox'un talimatları kurulumu istemcinin belgeleriyle bitirmeni ve değişikliği alması için sonra yeniden başlatmanı söylüyor.

CLI komutu

Bazı istemciler yapılandırma dosyası yerine bir komut kabul eder. İstemcinin belgelerinin anlattığı şekilde kaydetmen için sunucuyu başlatan komut bu:

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

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

İkisi de Studio'nun kurduğu bir dosyayı gösterir. Windows'ta %LOCALAPPDATA% kullanıcının yerel uygulama verileri klasörüdür. macOS'ta yol, /Applications içindeki RobloxStudio.app'in içinde. Dosya yoksa istemci sunucuyu başlatamaz: Sorun giderme bölümüne bak.

Adım 3: bağlantıyı kontrol et

1. Studio'da Assistant'ı aç ve … > Manage MCP Servers'a tıkla.
2. Enable Studio as MCP server'ın altında yeşil göstergeyi ara. Bağlı istemci sayısını gösterir.
3. İstemcinde, yanlış bir yapılandırma hiçbir şeyi değiştiremesin diye yalnızca okuyan bir istekle başla. Örneğin: Roblox Studio MCP araçlarını kullanarak Workspace'te ne olduğunu listele. Hiçbir şeyi değiştirme.

Yeni bir Baseplate'te yanıt varsayılan Camera, Terrain, Baseplate ve SpawnLocation nesnelerini içermeli. İstemcin araç çağrısını onaylamanı isteyebilir ya da onu izin listesine eklemeyi önerebilir. Bu test için bir kez onaylamak yeter.

ChatGPT Roblox Studio'ya bağlanabilir mi?

Web tarayıcısındaki ChatGPT bağlanamaz: Studio MCP sunucusu yerel bir programdır ve OpenAI, webdeki ChatGPT'nin yerel Codex yapılandırma dosyalarını okumadığını söylüyor. Roblox'un belgelediği yol, ChatGPT hesabınla giriş yapabildiğin Codex CLI. 11 Ekim 2026 itibarıyla Roblox'un MCP sayfası ChatGPT için hiçbir yapılandırma anlatmıyor ve ChatGPT Quick connect listesinde yok. Her yolun neyi kapsadığı şöyle.

• Roblox tarafından belgelenmiş: OpenAI'ın komut satırı programlama ajanı Codex CLI bir Quick connect istemcisidir. Adım 2'de diğerleri gibi kur. OpenAI'ın Codex belgeleri onu ilk çalıştırdığında Sign in with ChatGPT sunuyor, yani bir ChatGPT hesabını Studio'ya getirmenin belgelenmiş en yakın yolu bu. Codex'in Studio araçlarını kullanmadan önce sormasını sağlayan onay ayarı dahil Codex kısmı OpenAI Codex'i Roblox Studio ile kullanma (İngilizce) sayfasında.
• Roblox tarafından belgelenmiş: Assistant bir OpenAI API anahtarı kabul eder. Assistant'ı aç, … > Manage API Keys'e tıkla, OpenAI'ı seç, anahtarı yapıştır ve bir model seç. Assistant o zaman Studio içinde o modeli kullanır.
• Roblox değil OpenAI tarafından belgelenmiş: Codex modunda ChatGPT masaüstü uygulaması. OpenAI'ın MCP sayfası, masaüstü uygulamasının Settings > MCP servers > Add server ile yerel bir STDIO sunucusu ekleyebildiğini ve bu yapılandırmayı Codex CLI ile paylaştığını söylüyor. OpenAI normal ChatGPT sohbetlerinin sunucuyu kullanıp kullanamayacağını söylemiyor. Roblox masaüstü uygulamasını Quick connect'e dahil etmiyor ve biz de denemedik, yani onu doğrulanmamış say. Gereken komut CLI komutu bölümündeki.

Bir ChatGPT sohbetinden bir Script'e kod kopyalamak hâlâ işe yarar, ama bu yolda hiçbir şey oyununu okumaz ya da sonucu Studio'da kontrol etmez. Roblox Studio'da yapay zeka kullanma rehberi seçenekleri yan yana karşılaştırıyor.

Sunucu istemcine hangi araçları verir

Roblox sekiz grupta 26 araç listeliyor (30 Eylül 2026 itibarıyla). Hangilerini çağıracağını istemcin seçer; sen onları elle çağırmazsın. Her çağrı, hangi Studio penceresine gittiğini belirten bir studio_id taşır.

İki tür araç dikkat istiyor. Birincisi, bir şeyleri değiştirenler: multi_edit ve execute_luau oyununu doğrudan değiştirir, insert_asset asset ID ile dışarıdan içerik getirir, upload_image da görselleri Roblox'un asset sunucusuna gönderir. İkincisi, bir ajanın kendi işini kontrol etmesini sağlayan test araçları: Roblox'un StudioTestService referansı start_stop_play'in tek bir Play Client oturumu başlattığını söylüyor, girdi araçları da o çalışırken karakteri yönetiyor.

Roblox başka Studio işlevlerini de sunucu üzerinden veriyor: SceneAnalysisService aracılığıyla Scene Analysis verileri, MicroProfiler analizi, Device Simulator kontrolü ve bir oyunu streaming'e çeviren bir yapay zeka skill'i.

Birden fazla Studio penceresiyle çalışmak

Bir istemci aynı anda birkaç Studio penceresine bağlanabilir. Her çağrı hedefini studio_id ile belirttiği için ajanın hangi pencereyi kastettiğini bilmesi gerekir. Her pencerenin adını, Studio instance ID'sini ve oyun ID'sini görmek için list_roblox_studios'u çağırabilir. Oyun ID'si olmayan yerel oyunlar sadece adla görünür, iki pencere aynı adı paylaştığında da onları oyun ID'si ayırır.

Pratikte: prompt'unda oyunun adını söyle ve dokunmasını istemediğin oyunları kapat. Sunucu sadece baktığın oyuna değil, açık olan tüm oyunlara ulaşabilir.

Güvenli çalış: yedekle, onayla, gözden geçir

Roblox'un uyarısı kısa: MCP istemcileri açık oyunlarının içeriğini okuyup değiştirebilir, o yüzden yalnızca güvendiğin istemcileri bağla. Kod çalıştıran, asset ekleyen ve test başlatan araçlarla yanlış anlaşılmış bir talimat gerçek zarar verebilir. Bu alışkanlıklar durumu kurtarılabilir kılar.

• Her oturumdan önce bir sürüm kaydet. File > Save to Roblox with Notes (Ctrl+Alt+S, Mac'te Cmd+Option+S) adı olan bir kontrol noktası oluşturur. Geri dönmek için Window > Version History'yi aç, o sürümün yanındaki ⋮'ye tıkla, Open Local Copy'yi seç, sonra kopyada File > Save to Roblox As ile onu oyunun üzerine geri yükle. File > Save to File bilgisayarına da bir kopya kaydeder.
• Ctrl+Z'ye güvenme. Roblox'un MCP sayfası bir istemcinin düzenlemelerinin Studio'nun geri alma geçmişine girip girmediğini söylemiyor, o yüzden geri dönüş yolu olarak kaydettiğin sürümü esas al.
• Canlı oyunda değil, bir test kopyasında çalış. Enable Studio Access to API Services açıkken (File > Experience Settings > Security) Studio canlı oyununla aynı data store'ları okur ve yazar, Roblox da bunu yalnızca ayrı bir test sürümünde açmanı öneriyor. Buna bir ajanın çalıştırdığı kod ve başlattığı testler de dahil.
• Bir şeyleri değiştiren araçlarda onayları açık tut. script_read ve search_game_tree gibi okuma araçlarını izin listesine eklemek düşük risklidir. İş akışına güvenene kadar multi_edit, execute_luau, insert_asset ve upload_image'ı çağrı çağrı onaylamaya devam et.
• Tutmadan önce gözden geçir. Değiştirdiği script'leri oku, Explorer'da yeni ya da eksik nesnelere bak ve oyunu kendin test et. Bir ajanın testi, bir oyuncunun yapacağı her şeyi değil, kontrol etmeye karar verdiği şeyi gösterir.

Daha büyük projeler için: Script Sync ve Git

Roblox'un coding harness rehberi MCP bağlantısını iki parçayla daha birleştiriyor. Script Sync Studio servislerini diskteki klasörlere bağlar, böylece bir editör ve bir ajan Studio'da script olarak görünen .luau dosyaları üzerinde çalışır, Git de o koda geri dönebileceğin bir geçmiş verir. Bir ajandan büyük bir şey istemeden önce temiz bir durumu commit'le.

Script Sync bağladığın servislerdeki script'leri kapsar; StarterGui, testler ve Output gibi onun ulaşmadığı yerleri MCP bağlantısı kapsamaya devam eder. Alternatif olarak Rojo ile adım adım kurulum Cursor ya da VS Code'u Roblox Studio ile kullanma sayfasında, Claude Code sürümü de Claude Code'u Roblox Studio ile kullanma sayfasında (ikisi de İngilizce).

Sorun giderme: istemci bağlanmadığında

Roblox'un kontrol listesinde üç madde var: Studio'yu ve istemciyi yeniden başlat, komutun ya da binary'nin yolunun doğru olduğunu ve dosyanın var olduğunu kontrol et ve JSON sözdizimini gözden geçir. Bunların arkasındaki durumlar şunlar.

Ya da MCP kurulumunu atla: RoCode

RoCode (RoCode.app) başka bir yol ve bir MCP ürünü değil. Roblox Studio için bağımsız bir yapay zeka ajanı: rocode.app'teki bir web sohbetinde bir değişikliği anlatırsın, Creator Store'dan ücretsiz bir RoCode plugin'i de adımları açık olan oyununda uygular. Ayarlanacak yapılandırma dosyası, komut satırı ya da MCP sunucusu yok. Studio'da plugin'in HTTP ve Script Injection izinlerini kabul edersin. Sonra plugin, Studio'da RoCode'da kullandığın Roblox hesabıyla oturum açıksa kendiliğinden bağlanır; değilse sohbeti ve plugin'i, plugin panelinin gösterdiği 8 karakterlik kodla bir kez eşleştirirsin.

Ödünler, açıkça söylenmiş haliyle. RoCode bir Claude, Claude Code ya da ChatGPT aboneliği bağlayamaz. Üçüncü taraf modelleri OpenRouter üzerinden kendi adlarıyla çalıştırır: tüm planlarda DeepSeek V4 Flash, Pro'dan itibaren GLM 5.3 Flash ve Claude Sonnet 5.5, Studio'dan itibaren Claude Opus 5.5 ve Ultra'dan itibaren GPT-6 Astra. Plugin 3.9 veya sonrasıyla kısa bir test yapıp hataları okuyabilir, plugin 3.9.11 veya sonrasıyla da oyunun çalıştığını kontrol etmek için bir test karakterini yönetebilir. Plugin 3.9.14 veya sonrasıyla inşa ettiğinin görüntüsünü düzenleme modunda alır ve kötü görünen şeyi düzeltebilir. Doğrudan kod çalıştırmaz ve mesh üretmez, bunları yukarıdaki Studio MCP araçları yapabilir. Ama Creator Store'da senin kelimelerinle ücretsiz modeller arar (script'lerini temizler) ya da asset ID ile bir model, decal veya mesh ekler ve her oyun için yeni dekor, binalar ve prop'lar tasarlar. Ücretsiz Starter planı günde 1 kredi içerir. Diğer araçlarla nasıl karşılaştırıldığını görmek için Roblox Studio için en iyi yapay zeka araçlarının karşılaştırmasını oku.

Plugin 3.9 veya sonrasıyla RoCode kısa bir test yapıp hataları okuyabilir, plugin 3.9.11 veya sonrasıyla bir test karakterini yönetebilir, ama yalnızca test etmeye karar verdiği şeyi kontrol eder, o yüzden düzeltmeyi doğrulamak için Play'e kendin bas ve bir raunt oyna. Plugin ve eşleştirme nasıl çalışır. RoCode bağımsız bir üründür, Roblox Corporation ile bağlantılı değildir ve onun tarafından desteklenmez.

Sık sorulan sorular

Kaynaklar ve ek okumalar

• Roblox Creator Docs: Connect to the Roblox Studio MCP server (İngilizce). sunucuyu açma, Quick connect, JSON ve CLI yapılandırması, araç listesi, birden fazla Studio penceresi ve sorun giderme
• Roblox Developer Forum: Studio MCP Server Updates and External LLM Support for Assistant (İngilizce). Assistant'ta kendi Anthropic, OpenAI ya da Google API anahtarını kullanma
• Roblox Creator Docs: Build with a coding harness (İngilizce). Script Sync, Cursor ya da Visual Studio Code ile MCP ve Git
• Roblox Creator Docs: Version History (İngilizce). notlarla kaydetme ve önceki bir sürümü geri yükleme
• Roblox Creator Docs: Data stores (İngilizce). Studio'nun API Services erişiminin neden bir test kopyasında olması gerektiği
• Roblox Engine API: StudioTestService (İngilizce). start_stop_play aracının script ile yapılan çok istemcili testlerle nasıl karşılaştırıldığı
• OpenAI: Codex CLI (İngilizce). Sign in with ChatGPT dahil Codex CLI'a giriş
• OpenAI: Model Context Protocol (İngilizce). Codex modunda ChatGPT masaüstü uygulamasında yerel STDIO sunucuları ve webdeki ChatGPT'nin neden yerel Codex yapılandırmasını okumadığı
• Model Context Protocol: Introduction (İngilizce). Studio sunucusunun uyguladığı açık standart