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
- 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). - Inicie a conexão (no claude.ai, o botão Connect). Uma página do Luaward abre; entre na sua conta se ela pedir.
- 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
- 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.
- 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.
| Ferramenta | Escopo | O que faz |
|---|---|---|
list_sessions, capabilities | read | Os jogos conectados; o que este runtime suporta. |
tree, find, inspect, gui_snapshot, player_state, remotes, screenshot | read | Ver 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_note | read | Notas persistentes entre sessões vinculadas ao PlaceId do Roblox. |
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_build | read | O 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, stop | control | Agir 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_scripts | scripts | Listar, 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_hwid | manage / read | Seus 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_stop | spy | Registrar 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 (
capabilitiesmostra o que ele suporta). Para executores que bloqueiamCaptureService, baixe/mcp/capture.ps1e rode com-Token lwm_...para quescreenshotcapture 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.