Como conectar Claude, Cursor ou ChatGPT ao Roblox Studio com MCP

O que o servidor MCP do Studio faz

MCP (Model Context Protocol) é um padrão aberto que deixa ferramentas de IA conversarem com outros aplicativos. A Roblox integra um servidor MCP ao Studio. Quando ele está ligado, um cliente de IA no seu computador pode explorar o jogo que você tem aberto, ler e escrever scripts, rodar Luau e testar o jogo no modo Play, tudo pelas ferramentas que o servidor expõe.

O servidor roda como um processo local na sua máquina e fala com o cliente por stdio (entrada e saída padrão). Nada acontece sozinho: toda ação começa como um pedido do seu cliente, e o cliente decide qual ferramenta chamar. Você precisa da versão mais recente do Roblox Studio e do cliente MCP que quer usar, os dois instalados no mesmo computador.

Dois jeitos de usar Claude ou GPT com o Studio

Este guia é sobre o primeiro caminho. Se você só quer um modelo do Claude ou da OpenAI respondendo dentro do Studio, o segundo é mais curto: pegue uma chave de API do provedor, abra o Assistant, clique em … > Manage API Keys, escolha o provedor, cole a chave e selecione o modelo no menu Model.

Passo 1: Ative o servidor MCP no Studio

1. Abra o Roblox Studio e abra um jogo. Se o Studio oferecer uma atualização, instale antes: o servidor precisa da versão mais recente.
2. Clique em Assistant no canto superior direito do Studio (o lado direito da barra superior) para abrir a janela do Assistant.
3. Clique em … e escolha Manage MCP Servers.
4. Ative Enable Studio as MCP server.

O painel agora mostra uma opção de Quick connect e instruções de configuração para clientes diferentes. Deixe-o aberto. Você precisa dele no próximo passo, e é ali que aparece o indicador de conexão.

Se o botão do Assistant não aparecer ou a janela não abrir, veja como abrir ou reabrir o painel do Assistant (em inglês).

Passo 2: Conecte o seu cliente de IA

A Roblox dá três jeitos de conectar, nesta ordem: Quick connect se o seu cliente está na lista, uma configuração JSON se o cliente lê arquivos de configuração MCP, e um comando de CLI para clientes que precisam de um.

Quick connect

O Quick connect suporta sete clientes (na lista de 30 de setembro de 2026): Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI e Visual Studio Code.

1. No painel do Passo 1 (Assistant Settings > MCP Servers), abra o menu Quick connect. Ele lista os clientes suportados que estão instalados no seu computador.
2. Ative o cliente que você quer.
3. Se o seu cliente não estiver na lista, instale-o e reinicie o Roblox Studio. Se você instalou com o Studio aberto, talvez precise reiniciar o Studio, o cliente ou os dois.

Configuração por cliente

O guia de coding harness da Roblox junta a conexão MCP com um editor: o Cursor, ou o Visual Studio Code com uma extensão como o Claude Code. Se você quer que o agente também escreva código como arquivos, além de controlar o Studio, veja Script Sync e Git abaixo.

Outros clientes: configuração JSON ou comando de CLI

O servidor funciona com qualquer cliente que suporte o transporte stdio. Se o seu não tem Quick connect, adicione o Roblox Studio à configuração MCP dele. Estas são as configurações completas que a Roblox documenta. Se o Roblox Studio é o seu único servidor MCP, use exatamente assim.

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

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

Onde fica o arquivo de configuração depende do cliente (o exemplo da Roblox o chama de mcp.json). As instruções da Roblox dizem para terminar a configuração com a documentação do seu cliente e reiniciar o cliente para ele pegar a mudança.

Comando de CLI

Alguns clientes recebem um comando em vez de um arquivo de configuração. Este é o comando que inicia o servidor, para você registrar do jeito que a documentação do seu cliente descreve:

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

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

Os dois apontam para um arquivo que o Studio instala. No Windows, %LOCALAPPDATA% é a pasta de dados locais de aplicativos do seu usuário. No macOS, o caminho fica dentro de RobloxStudio.app em /Applications. Se o arquivo não estiver lá, o cliente não consegue iniciar o servidor: veja Problemas comuns.

Passo 3: Confira a conexão

1. No Studio, abra o Assistant e clique em … > Manage MCP Servers.
2. Em Enable Studio as MCP server, procure o indicador verde. Ele mostra o número de clientes conectados.
3. No seu cliente, comece com um pedido que só lê, para que uma configuração errada não mude nada. Por exemplo: Usando as ferramentas MCP do Roblox Studio, liste o que tem no Workspace. Não mude nada.

Em uma Baseplate nova, a resposta deve listar os padrões Camera, Terrain, Baseplate e SpawnLocation. O cliente pode pedir que você aprove a chamada da ferramenta, ou oferecer adicioná-la a uma lista de permitidas. Aprovar uma vez basta para este teste.

O ChatGPT consegue se conectar ao Roblox Studio?

Não o ChatGPT no navegador: o servidor MCP do Studio é um programa local, e a OpenAI diz que o ChatGPT na web não lê arquivos de configuração locais do Codex. O caminho que a Roblox documenta é o Codex CLI, em que você pode entrar com a sua conta do ChatGPT. Em 11 de outubro de 2026, a página de MCP da Roblox não descreve nenhuma configuração para o ChatGPT, e ele não está na lista de Quick connect. Isto é o que cada caminho cobre.

• Documentado pela Roblox: o Codex CLI, o agente de programação de linha de comando da OpenAI, é um cliente de Quick connect. Configure como os outros no Passo 2. A documentação do Codex da OpenAI oferece Sign in with ChatGPT na primeira vez que você roda, então esse é o jeito documentado mais próximo de levar uma conta do ChatGPT ao Studio. O lado do Codex, incluindo a configuração de aprovação que faz o Codex perguntar antes de usar as ferramentas do Studio, está em como usar o OpenAI Codex com o Roblox Studio (em inglês).
• Documentado pela Roblox: o Assistant aceita uma chave de API da OpenAI. Abra o Assistant, clique em … > Manage API Keys, escolha OpenAI, cole a chave e escolha um modelo. O Assistant passa a usar esse modelo dentro do Studio.
• Documentado pela OpenAI, não pela Roblox: o app de computador do ChatGPT no modo Codex. A página de MCP da OpenAI diz que o app de computador pode adicionar um servidor STDIO local em Settings > MCP servers > Add server, e compartilha essa configuração com o Codex CLI. A OpenAI não diz se conversas comuns do ChatGPT podem usar o servidor. A Roblox não lista o app de computador no Quick connect, e nós não testamos, então trate como não confirmado. O comando de que ele precisa é o de Comando de CLI.

Copiar código de uma conversa do ChatGPT para um Script ainda funciona, mas nada nesse caminho lê o seu jogo nem confere o resultado no Studio. O guia de como usar IA no Roblox Studio compara as opções lado a lado.

Que ferramentas o servidor dá ao seu cliente

A Roblox lista 26 ferramentas em oito grupos (em 30 de setembro de 2026). O seu cliente escolhe quais chamar; você não as chama à mão. Toda chamada leva um studio_id que diz qual janela do Studio é o alvo.

Dois tipos de ferramenta merecem atenção. Primeiro, as que mudam coisas: multi_edit e execute_luau mudam o seu jogo diretamente, insert_asset traz conteúdo de fora pelo ID do asset, e upload_image envia imagens ao servidor de assets do Roblox. Segundo, as ferramentas de teste, que deixam um agente conferir o próprio trabalho: a referência de StudioTestService da Roblox diz que start_stop_play inicia uma única sessão Play Client, e as ferramentas de entrada controlam o personagem enquanto ela roda.

A Roblox também passa outros recursos do Studio pelo servidor: dados de Scene Analysis pelo SceneAnalysisService, análise do MicroProfiler, controle do Device Simulator e uma skill de IA que converte um jogo para streaming.

Trabalhando com mais de uma janela do Studio

Um cliente pode se conectar a várias janelas do Studio abertas ao mesmo tempo. Como toda chamada de ferramenta indica o alvo com studio_id, o agente precisa saber qual janela você quer. Ele pode chamar list_roblox_studios para ver o nome, o ID de instância do Studio e o ID de place de cada janela. Places locais sem ID de place aparecem só pelo nome, e quando duas janelas têm o mesmo nome, o ID de place as diferencia.

Na prática: cite o jogo no seu prompt e feche qualquer jogo que você não quer que seja mexido. O servidor alcança todos os jogos abertos, não só o que você está olhando.

Trabalhe com segurança: backup, aprovação, revisão

O aviso da própria Roblox é curto: clientes MCP podem ler e modificar o conteúdo dos seus jogos abertos, então conecte só clientes em que você confia. Com ferramentas que rodam código, inserem assets e iniciam testes, uma instrução mal entendida pode causar estrago de verdade. Estes hábitos mantêm tudo recuperável.

• Salve uma versão antes de cada sessão. File > Save to Roblox with Notes (Ctrl+Alt+S, ou Cmd+Option+S no Mac) cria um ponto de restauração com nome. Para voltar, abra Window > Version History, clique em ⋮ ao lado da versão, escolha Open Local Copy e use File > Save to Roblox As na cópia para restaurá-la sobre o jogo. File > Save to File também guarda uma cópia no seu computador.
• Não conte com o Ctrl+Z. A página de MCP da Roblox não diz se as edições de um cliente entram no histórico de desfazer do Studio, então trate a versão salva como o caminho de volta.
• Trabalhe em uma cópia de teste, não no jogo ao vivo. Com Enable Studio Access to API Services ligado (File > Experience Settings > Security), o Studio lê e escreve nos mesmos data stores do seu jogo ao vivo, e a Roblox recomenda ligar isso só em uma versão de teste separada. Isso inclui código que um agente roda e testes que ele inicia.
• Mantenha a aprovação ligada para ferramentas que mudam coisas. Permitir de vez ferramentas de leitura como script_read e search_game_tree tem pouco risco. Continue aprovando multi_edit, execute_luau, insert_asset e upload_image uma chamada por vez até confiar no fluxo.
• Revise antes de manter. Leia os scripts que ele mudou, confira o Explorer em busca de objetos novos ou sumidos e teste você mesmo. O teste de um agente mostra o que ele escolheu conferir, não tudo o que um jogador vai fazer.

Para projetos maiores: Script Sync e Git

O guia de coding harness da Roblox junta a conexão MCP com mais duas peças. O Script Sync liga serviços do Studio a pastas no disco, para que um editor e um agente trabalhem em arquivos .luau que aparecem no Studio como scripts, e o Git dá a esse código um histórico que você pode reverter. Faça um commit de um estado limpo antes de pedir algo grande a um agente.

O Script Sync cobre scripts nos serviços que você liga; a conexão MCP continua cobrindo o que ele não alcança, como StarterGui, testes e o Output. A configuração passo a passo, com o Rojo como alternativa, está em como usar Cursor ou VS Code com o Roblox Studio, e a versão para Claude Code em como usar o Claude Code com o Roblox Studio (em inglês).

Problemas comuns: quando o cliente não conecta

A lista de verificação da própria Roblox tem três itens: reinicie o Studio e o cliente, confira se o caminho do comando ou do binário está certo e se o arquivo existe, e confira a sintaxe do JSON. Estas são as situações por trás disso.

Ou pule a configuração do MCP: RoCode

O RoCode (RoCode.app) é outro caminho, e não é um produto MCP. É um agente de IA independente para Roblox Studio: você descreve uma alteração em um chat na web em rocode.app, e um plugin grátis do RoCode da Creator Store executa os passos no jogo que você tem aberto. Não há arquivo de configuração, linha de comando nem servidor MCP para configurar. Você permite as permissões de HTTP e Script Injection do plugin no Studio. O plugin então se conecta sozinho quando o Studio está na mesma conta do Roblox que você usa no RoCode; se não, você pareia o chat e o plugin uma vez com o código de 8 caracteres mostrado no painel do plugin.

As contrapartidas, sem rodeios. O RoCode não conecta assinaturas do Claude, Claude Code ou ChatGPT. Ele roda modelos de terceiros pela OpenRouter com os próprios nomes: DeepSeek V4 Flash em todos os planos, GLM 5.3 Flash e Claude Sonnet 5.5 a partir do Pro, Claude Opus 5.5 a partir do Studio e GPT-6 Astra a partir do Ultra. Com o plugin 3.9 ou mais recente ele pode rodar um teste curto e ler os erros, e com o 3.9.11 ou mais recente controlar um personagem de teste para conferir se o jogo funciona. Com o plugin 3.9.14 ou mais recente ele também tira capturas de tela do que construiu, no modo de edição, e pode corrigir o que parecer errado. Ele não roda código diretamente nem gera malhas, coisas que as ferramentas MCP do Studio acima fazem. Ele busca na Creator Store com as suas palavras modelos gratuitos (sem os scripts) ou insere um modelo, decal ou malha pelo ID do asset, e cria cenário, construções e objetos novos para cada jogo. O plano Starter grátis inclui 1 crédito por dia. Para comparar com outras ferramentas, veja as melhores IAs para Roblox Studio.

Com o plugin 3.9 ou mais recente, o RoCode pode rodar um teste curto e ler os erros, e com o 3.9.11 ou mais recente controlar um personagem de teste, mas ele só confere o que escolheu testar, então aperte Play e jogue uma rodada para confirmar a correção. Como funcionam o plugin e o pareamento. O RoCode é um produto independente, sem afiliação ou endosso da Roblox Corporation.

Perguntas frequentes

Fontes e leitura extra

• Roblox Creator Docs: Connect to the Roblox Studio MCP server (em inglês). ativar o servidor, Quick connect, configuração JSON e CLI, a lista de ferramentas, várias janelas do Studio e problemas comuns
• Roblox Developer Forum: Studio MCP Server Updates and External LLM Support for Assistant (em inglês). usar a sua própria chave de API da Anthropic, OpenAI ou Google no Assistant
• Roblox Creator Docs: Build with a coding harness (em inglês). Script Sync, MCP com Cursor ou Visual Studio Code, e Git
• Roblox Creator Docs: Version History (em inglês). salvar com notas e restaurar uma versão anterior
• Roblox Creator Docs: Data stores (em inglês). por que o acesso do Studio aos serviços de API fica em uma cópia de teste
• Roblox Engine API: StudioTestService (em inglês). como a ferramenta start_stop_play se compara a testes com vários clientes por script
• OpenAI: Codex CLI (em inglês). entrar no Codex CLI, inclusive com Sign in with ChatGPT
• OpenAI: Model Context Protocol (em inglês). servidores STDIO locais no app de computador do ChatGPT no modo Codex, e por que o ChatGPT na web não lê a configuração local do Codex
• Model Context Protocol: Introduction (em inglês). o padrão aberto que o servidor do Studio implementa