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
- 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). - 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.
- 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
- 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.
- 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 | Ámbito | Qué hace |
|---|---|---|
list_sessions, capabilities | read | Los juegos conectados; lo que admite este runtime. |
tree, find, inspect, gui_snapshot, player_state, remotes, screenshot | read | Mirar el juego: objetos, interfaz (numerada + diff_from + world), jugador, remotes y asistente opcional de captura de pantalla de escritorio. |
get_notes, save_note, delete_note | read | Notas persistentes entre sesiones asociadas al PlaceId de Roblox. |
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_build | read | La 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, stop | control | Actuar 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_scripts | scripts | Listar, 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_hwid | manage / read | Tus 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_stop | spy | Registrar 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 (
capabilitiesindica qué admite). Para runtimes que bloqueanCaptureService, descarga/mcp/capture.ps1y ejecútalo con-Token lwm_...para quescreenshotcapture 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.