LuawardDocs

AI & MCP: conecte uma IA aos seus jogos

Deixe Claude, Cursor ou outro cliente de IA explorar e controlar os jogos que você conecta ao Test in game e testar seus próprios scripts.

AI & MCP permite que um cliente de IA (claude.ai, ChatGPT, Claude Code, Cursor, qualquer cliente MCP) veja e aja nos jogos que você conectou ao Test in game: listar objetos, ler a interface, clicar, executar Luau, registrar chamadas de remote e rodar seus próprios scripts dizendo como foram. É para as suas próprias sessões de jogo e os seus próprios scripts, e faz parte dos planos Pro e Studio.

Conectar

Primeiro conecte um jogo pelo Test in game (o loader de uma linha). Depois conecte a IA da forma que o seu cliente aceita.

claude.ai e ChatGPT: entre na sua conta, sem token

  1. No app, adicione um conector personalizado com o endereço https://luaward.com/mcp. No claude.ai abra Settings → Connectors (pode aparecer em Customize); no ChatGPT adicione como app ou conector em Settings (pode ser preciso ativar o modo desenvolvedor).
  2. Inicie a conexão (no claude.ai, o botão Connect). Uma página do Luaward abre; entre na sua conta se ela pedir.
  3. Veja quem está pedindo: um app oficial mostra App oficial do Claude · claude.ai (o mesmo vale para o ChatGPT); qualquer outro mostra App não verificado e o endereço para onde ele leva você de volta. Escolha o workspace, desligue o que a IA não deve fazer, escolha Executa na hora ou Perguntar antes e toque em Permitir.

A página tem uma chave para cada capacidade:

  • Explorar o jogo: sempre ligado. Lê os objetos, a interface, os remotes e o log dos jogos que você conectou. Não muda nada.
  • Controlar o jogo: clica, digita, aperta teclas e executa código nos jogos que você conectou.
  • Observar remotes (spy): registra o que o jogo envia pelos remotes. Também precisa da chave por jogo descrita abaixo.
  • Ler os scripts do jogo: descompila os scripts que o jogo carrega (guardados por 24 horas, nunca salvos na sua conta).
  • Gerenciar seus scripts e chaves: lê o código original dos seus scripts, envia novas versões e cria ou lê chaves de licença. Fica desligado até você ligar e só funciona com Executa na hora.

O dono ou administrador de um workspace Pro/Studio pode conectar uma IA. Redirecionamentos são verificados contra callbacks permitidos; isso não verifica quem opera um app. Confira a identidade e os scopes antes de permitir. Em AI & MCP → Conexões, revise apps, mude o modo ou encerre a conexão; encerrar impede uso e renovação.

Claude Code, Cursor e outros clientes: um token

  1. Abra AI & MCP no painel e crie um token. Escolha o que ele pode fazer e, se quiser, uma validade. O token aparece uma vez.
  2. Cole o comando ao lado no seu cliente de IA:
claude mcp add --transport http luaward https://luaward.com/mcp --header "Authorization: Bearer lwm_…"

O endereço do servidor é https://luaward.com/mcp (MCP sobre HTTP, uma resposta JSON por requisição). Qualquer cliente que envie um cabeçalho Bearer funciona. Salve a skill oferecida na página como ~/.claude/skills/luaward-debug/SKILL.md para ensinar o Claude a usar as ferramentas.

O que uma IA pode fazer

Cada ferramenta exige um escopo; um token só vê as ferramentas que seus escopos permitem. read sempre está incluído.

FerramentaEscopoO que faz
list_sessions, capabilitiesreadOs jogos conectados; o que este runtime suporta.
tree, find, inspect, gui_snapshot, player_state, remotes, screenshotreadVer o jogo: objetos, interface (numerada + diff_from + world), jogador, remotes e auxiliar opcional de captura de tela da área de trabalho.
get_notes, save_note, delete_notereadNotas persistentes entre sessões vinculadas ao PlaceId do Roblox.
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_buildreadO console (#seq, contains), respostas paginadas (offset/limit), histórico de testes, projetos, scripts e status de compilação.
exec, click, type_text, press_key, run_script, stopcontrolAgir no jogo: executar Luau (readonly, guard, codes, detach), clicar (auto/signal/vim/mouse), digitar, apertar teclas, rodar scripts/builds de rascunho e parar tudo ou por cmd.
scripts_list, scripts_read, scripts_sync, search_scriptsscriptsListar, ler em páginas, sincronizar no cache Redis criptografado por 24 h e buscar por regex em todo o jogo.
get_script_source, list_script_errors, create_script, deploy_script, promote_build, archive_script, toggle_script, resolve_script_error, list_keys, create_test_key, revoke_key, reset_hwidmanage / readSeus próprios scripts e chaves: ler o código original, preparar builds em rascunho (publish=false) e promovê-los (promote_build), arquivar scripts de teste com segurança, criar/revogar chaves de teste MCP, alterar presets, resolver erros ou redefinir HWID. manage nunca vem por padrão e só funciona em um token que executa mudanças na hora. list_script_errors só precisa de read.
spy_start, spy_stopspyRegistrar as chamadas que o jogo faz ao servidor. Desligado até você permitir por jogo.

O deploy altera o código em uso

Por padrão (publish=true), deploy_script promove automaticamente um build Ready aos jogadores. Passe publish=false (ou draft=true) para testar seu build compilado antes com run_script(mode="build") e depois chame promote_build quando estiver pronto.

Mantendo o controle

  • Executar na hora ou perguntar antes. Por padrão, as mudanças de uma IA rodam na hora (seu cliente de IA tem a própria etapa de aprovação). Escolha Perguntar antes e tudo que muda o jogo espera por você em AI & MCP e Test in game. Ver nunca é retido.
  • O remote spy fica desligado em todos os jogos até você permitir nos detalhes do jogo. Ele intercepta o jogo e pode ser notado pelo anti-cheat.
  • O texto do jogo é dado. Nomes, texto da interface, linhas do console e código dos scripts vêm do jogo; a skill e o servidor dizem à IA para nunca seguir instruções encontradas neles.
  • Revogue um token ou encerre a conexão de um app quando quiser; para na hora. A aba de atividade lista o que a IA fez (a ferramenta, quem e o jogo; nunca o código nem o que o jogo imprimiu).

Bom saber

  • O que funciona depende do seu runtime (capabilities mostra o que ele suporta). Para executores que bloqueiam CaptureService, baixe /mcp/capture.ps1 e rode com -Token lwm_... para que screenshot capture diretamente a janela do Roblox.
  • Um teste que passa significa "nenhum erro em N segundos", não que o script esteja correto.
  • Não dê um token nem clique em Permitir para algo em que você não confie: isso pode agir nos seus jogos conectados.