LuawardDocs

AI & MCP: conecta una IA a tus juegos

Deja que Claude, Cursor u otro cliente de IA explore y controle los juegos que conectas a Test in game y pruebe tus propios scripts.

AI & MCP permite que un cliente de IA (claude.ai, ChatGPT, Claude Code, Cursor, cualquier cliente MCP) mire y actúe en los juegos que conectaste a Test in game: listar objetos, leer la interfaz, hacer clic, ejecutar Luau, registrar llamadas de remote y ejecutar tus propios scripts diciéndote cómo fueron. Es para tus propias sesiones de juego y tus propios scripts, y forma parte de los planes Pro y Studio.

Conectar

Primero conecta un juego desde Test in game (el loader de una línea). Luego conecta la IA de la forma que admita tu cliente.

claude.ai y ChatGPT: inicia sesión, sin token

  1. En la app, añade un conector personalizado con la dirección https://luaward.com/mcp. En claude.ai abre Settings → Connectors (puede aparecer en Customize); en ChatGPT añádelo como app o conector en Settings (puede hacer falta el modo desarrollador).
  2. Inicia la conexión (en claude.ai, el botón Connect). Se abre una página de Luaward; inicia sesión si te la pide.
  3. Fíjate en quién lo pide: una app oficial muestra App oficial de Claude · claude.ai (lo mismo con ChatGPT); cualquier otra muestra App no verificada y la dirección a la que te devuelve. Elige el workspace, apaga lo que la IA no deba hacer, elige Se ejecuta al instante o Preguntarme antes y pulsa Permitir.

La página tiene un interruptor por cada capacidad:

  • Explorar el juego: siempre activado. Lee los objetos, la interfaz, los remotes y el registro de los juegos que conectaste. No cambia nada.
  • Controlar el juego: hace clic, escribe, pulsa teclas y ejecuta código en los juegos que conectaste.
  • Vigilar remotes (spy): registra lo que el juego envía por los remotes. También necesita el interruptor por juego que se describe abajo.
  • Leer los scripts del juego: descompila los scripts que carga el juego (se guardan 24 horas y nunca en tu cuenta).
  • Gestionar tus scripts y claves: lee el código original de tus scripts, sube versiones nuevas y crea o lee claves de licencia. Está apagado hasta que lo actives y solo funciona con Se ejecuta al instante.

El propietario o administrador de un workspace Pro/Studio puede conectar una IA. Los redirects se validan con callbacks permitidos; esto no verifica quién opera una app. Comprueba identidad y scopes antes de autorizar. En AI & MCP → Conexiones, revisa apps, cambia el modo o termina la conexión; terminarla impide su uso y renovación.

Claude Code, Cursor y otros clientes: un token

  1. Abre AI & MCP en el panel y crea un token. Elige qué puede hacer y, si quieres, una caducidad. El token se muestra una sola vez.
  2. Pega el comando de al lado en tu cliente de IA:
claude mcp add --transport http luaward https://luaward.com/mcp --header "Authorization: Bearer lwm_…"

La dirección del servidor es https://luaward.com/mcp (MCP sobre HTTP, una respuesta JSON por petición). Sirve cualquier cliente que envíe una cabecera Bearer. Guarda la skill que ofrece la página como ~/.claude/skills/luaward-debug/SKILL.md para enseñar a Claude a usar las herramientas.

Qué puede hacer una IA

Cada herramienta necesita un ámbito; un token solo ve las herramientas que sus ámbitos permiten. read siempre está incluido.

HerramientaÁmbitoQué hace
list_sessions, capabilitiesreadLos juegos conectados; lo que admite este runtime.
tree, find, inspect, gui_snapshot, player_state, remotes, screenshotreadMirar el juego: objetos, interfaz (numerada + diff_from + world), jugador, remotes y asistente opcional de captura de pantalla de escritorio.
get_notes, save_note, delete_notereadNotas persistentes entre sesiones asociadas al PlaceId de Roblox.
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_buildreadLa consola (#seq, contains), respuestas paginadas (offset/limit), historial de pruebas, proyectos, scripts y estado de compilación.
exec, click, type_text, press_key, run_script, stopcontrolActuar en el juego: ejecutar Luau (readonly, guard, codes, detach), hacer clic (auto/signal/vim/mouse), escribir, pulsar teclas, ejecutar scripts/builds borrador y detener todo o por cmd.
scripts_list, scripts_read, scripts_sync, search_scriptsscriptsListar, leer por páginas, sincronizar en la caché cifrada de Redis (24 h) y buscar por regex en todo el juego.
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 / readTus propios scripts y claves: leer el código original, preparar builds borrador (publish=false) y promoverlos (promote_build), archivar scripts de prueba de forma segura, crear/revocar claves de prueba MCP, cambiar presets, marcar errores resueltos o restablecer HWID. manage nunca se da por defecto y solo funciona en un token que ejecuta cambios al instante. list_script_errors solo necesita read.
spy_start, spy_stopspyRegistrar las llamadas que el juego hace al servidor. Apagado hasta que lo permitas por juego.

El deploy cambia el código en uso

Por defecto (publish=true), deploy_script promueve automáticamente un build Ready a los jugadores. Pasa publish=false (o draft=true) para probar primero tu build compilado con run_script(mode="build") y luego llama a promote_build cuando esté listo.

Mantener el control

  • Ejecutar al instante o preguntar antes. Por defecto, los cambios de una IA se ejecutan al instante (tu cliente de IA tiene su propio paso de aprobación). Elige Preguntar antes y todo lo que cambie el juego espera por ti en AI & MCP y Test in game. Mirar nunca se retiene.
  • El remote spy está apagado en todos los juegos hasta que lo permitas en los detalles del juego. Intercepta el juego y su anti-cheat podría detectarlo.
  • El texto del juego son datos. Nombres, texto de la interfaz, líneas de consola y código de scripts vienen del juego; la skill y el servidor indican a la IA que nunca siga instrucciones que encuentre en ellos.
  • Revoca un token o termina la conexión de una app cuando quieras; se detiene al instante. La pestaña de actividad lista lo que hizo la IA (la herramienta, quién y el juego; nunca el código ni lo que imprimió el juego).

Conviene saber

  • Lo que funciona depende de tu runtime (capabilities indica qué admite). Para runtimes que bloquean CaptureService, descarga /mcp/capture.ps1 y ejecútalo con -Token lwm_... para que screenshot capture directamente tu ventana de Roblox.
  • Una prueba que pasa significa "ningún error en N segundos", no que el script sea correcto.
  • No des un token ni pulses Permitir a nada en lo que no confíes: puede actuar en tus juegos conectados.