Conectar ao servidor MCP do Roblox Studio

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

Este guia mostra como conectar o servidor MCP do Studio a clientes de IA 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 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 é executado como um processo local em sua máquina e se comunica com o cliente de IA usando transporte stdio, que utiliza fluxos de entrada/saída padrão. Todas as ações são iniciadas através do seu cliente de IA, que então envia uma solicitação através deste canal para realizar 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 Assistente.
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 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 CLI.

O servidor MCP do Studio funciona com qualquer cliente que suporte transporte stdio. Após adicionar a configuração, siga a documentação do seu cliente para concluir a configuração e, em seguida, 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 Assistente ⟩ Servidores MCP.
2. Expanda o dropdown Conexão rápida para visualizar os clientes suportados instalados em seu computador.
3. Ative o 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 vários servidores MCP, copie a entrada Roblox_Studio e adicione-a ao seu dicionário mcpServers existente.

As configurações variam de acordo com o sistema operacional:

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

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

Comando CLI

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

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

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

Usar várias instâncias do Studio

Você pode conectar um único cliente MCP a várias instâncias em execução do Studio ao mesmo tempo. Cada chamada de ferramenta inclui um studio_id que identifica a instância do Studio a ser alvo, o que torna os fluxos de trabalho com várias instâncias do Studio e vários agentes ou clientes confiáveis.

Use list_roblox_studios para listar as instâncias conectadas com seus nomes, IDs de instância do Studio e IDs de lugar. Em seguida, passe o ID da instância que você deseja como studio_id em chamadas subsequentes.

Verifique sua conexão

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

1. Abra Assistente.
2. Clique em … ⟩ Gerenciar Servidores MCP.
3. Sob Habilitar Studio como servidor MCP, verifique o indicador verde para confirmar 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.