Conectar ao servidor MCP do Roblox Studio

O servidor MCP do Roblox Studio está embutido no Roblox Studio. Ele implementa o Modelo de Contexto de Protocolo (MCP), um padrão aberto que permite que ferramentas de AI se comuniquem de forma segura com aplicativos externos. Assim que conectado, seu cliente AI pode interagir diretamente com sua sessão do Studio aberta, explorando o modelo de dados, escrevendo scripts, executando código Luau e testando sua experiência em modo de jogo.

Este guia mostra como conectar o servidor MCP do Studio a clientes de AI populares. Embora a configuração varie de cliente para cliente, a ideia central é a mesma: você configura seu cliente para se conectar ao servidor MCP e, em seguida, envia comandos do cliente para sua sessão ativa do Studio.

Pré-requisitos

Antes de você poder se conectar ao servidor, certifique-se de ter a versão mais recente do Roblox Studio e seu cliente MCP preferido instalado em seu computador.

Como o servidor MCP do Studio funciona

O servidor roda como um processo local em sua máquina e se comunica com o cliente AI usando transporte stdio, que utiliza streams de entrada/saída padrão. Todas as ações são iniciadas através do seu cliente AI, que então envia uma solicitação através desse canal para executar ações dentro da sua sessão do Studio.

O servidor fornece as seguintes ferramentas:

Ativar o servidor MCP no Studio

Para ativar o servidor MCP no Studio:

1. Abra Assistant.
2. Clique em … ⟩ Gerenciar Servidores MCP.
3. Ative Habilitar Studio como servidor MCP.

Uma vez ativado, o painel de configurações exibe a opção de conexão rápida e instruções de configuração para diferentes clientes. Quando um cliente se conecta com sucesso, um indicador verde mostra o número de clientes conectados.

Conectar seu cliente

Você pode conectar seu cliente ao servidor MCP do Studio usando conexão rápida, uma configuração JSON ou um comando de CLI.

• Use conexão rápida se seu cliente for suportado.
• Se não, use uma configuração JSON se seu cliente suportar arquivos de configuração MCP.
• Caso contrário, use um comando de CLI.

O servidor MCP do Studio funciona com qualquer cliente que suporta transporte stdio. Após adicionar a configuração, siga a documentação do seu cliente para completar a configuração, e então reinicie o cliente para aplicar suas alterações.

Conexão rápida

A conexão rápida suporta os seguintes clientes:

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

Para conectar usando a conexão rápida:

1. Vá para Configurações do Assistant ⟩ Servidores MCP.
2. Expanda o dropdown Conexão rápida para visualizar os clientes suportados instalados em seu computador.
3. Ative seu cliente escolhido.

Se o cliente que você deseja não aparecer na lista de Conexão rápida, instale-o e reinicie o Roblox Studio.

Configuração JSON

A maioria dos clientes MCP suporta arquivos de configuração JSON. Os seguintes exemplos mostram configurações completas que você pode usar.

Se o Roblox Studio for seu único servidor MCP, use essas configurações como estão. Se você estiver usando múltiplos servidores MCP, copie a entrada Roblox_Studio e adicione-a ao seu dicionário mcpServers existente.

As configurações variam conforme o sistema operacional:

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

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

Comando de CLI

Alguns clientes MCP exigem um comando de CLI em vez de uma configuração JSON. Use o comando apropriado para seu sistema operacional:

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

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

Usar múltiplas instâncias do Studio

Você pode conectar um único cliente MCP a várias instâncias em execução do Studio ao mesmo tempo. O servidor determina automaticamente qual instância usar com base no contexto (por exemplo, se você referir uma experiência específica ou um objeto que existe apenas naquela instância).

Você pode alternar manualmente entre as instâncias usando list_roblox_studios e set_active_studio.

Verifique sua conexão

Após configurar seu cliente, verifique se a conexão está funcionando no Roblox Studio:

1. Abra Assistant.
2. Clique em … ⟩ Gerenciar Servidores MCP.
3. Sob Habilitar Studio como servidor MCP, verifique se o indicador verde confirma que o cliente se conectou com sucesso.

Solução de problemas

Se o servidor não estiver aparecendo ou as ferramentas não estiverem disponíveis:

• Reinicie tanto o Roblox Studio quanto seu cliente MCP.
• Verifique se o comando ou caminho do binário está correto e se o arquivo existe.
• Verifique sua sintaxe JSON. Mesmo uma vírgula ou colchete ausente pode impedir o carregamento da configuração.