Shiny Gen

npx add-mcp 'https://mcp.shinygen.ai/mcp'

Conecta Claude o ChatGPT a Shiny Gen

Shiny Gen incluye un servidor MCP alojado en https://mcp.shinygen.ai/mcp. Conecta un asistente de IA (Claude, ChatGPT o cualquier cliente MCP) y podrá construir, editar y probar tu proyecto de Shiny Gen, en vivo en tu navegador. No hay nada que instalar: a diferencia de las integraciones MCP que se conectan a un motor de escritorio en tu máquina, el servidor de Shiny Gen es remoto y opera el proyecto en tu pestaña abierta del navegador.

MCP (Protocolo de Contexto de Modelo) es un estándar abierto que permite a los asistentes de IA usar herramientas externas. Shiny Gen expone sus editores y modelos de generación como herramientas MCP.

Conectar

1. Comienza a alojar en Shiny Gen: abre tu juego en shinygen.ai, abre la pestaña Agente, toca el nombre del modelo para abrir el selector de modelos de IA, elige Conectar modelo externo con MCP y presiona Alojar agente externo. La aplicación muestra "Esperando a que tu IA se conecte". Tu asistente no puede conectarse hasta que hagas esto, una vez por sesión, y los pasos para cada cliente aparecen justo ahí en la aplicación.
2. Claude (web o escritorio): agrega un conector personalizado en Configuración y pega la URL del servidor: https://mcp.shinygen.ai/mcp
3. Claude Code:

   claude mcp add --transport http shinygen https://mcp.shinygen.ai/mcp
   

4. ChatGPT o cualquier otro cliente MCP: agrega la misma URL donde tu cliente configure conectores o servidores MCP.
5. Aprueba el acceso: tu navegador abre una página de consentimiento de Shiny Gen. Inicia sesión y aprueba. La autorización usa OAuth y puedes desconectarte en cualquier momento.
6. Mantén Shiny Gen abierto: el asistente opera tu sesión en vivo, así que la aplicación debe permanecer abierta mientras trabaja. El alojamiento permanece abierto mientras la aplicación lo esté.

Construye tu propio cliente MCP

No necesitas Claude ni ChatGPT. Cualquier programa que hable MCP puede conectarse, incluido un agente de IA que escriba su propio cliente en código. Todo es estándar, así que un SDK MCP estándar lo maneja:

• Transporte: HTTP transmisible en https://mcp.shinygen.ai/mcp.
• Inicio de sesión: OAuth 2.1 con PKCE (S256). Una solicitud sin token recibe un 401 cuyo encabezado WWW-Authenticate apunta al documento de descubrimiento, https://mcp.shinygen.ai/.well-known/oauth-protected-resource.
• Registro: los clientes se registran en https://mcp.shinygen.ai/oauth/register. Solo clientes públicos: no hay secreto de cliente.
• Dirección de retorno: la URI de redirección debe ser https, o de bucle local http (127.0.0.1, localhost o [::1]) para un cliente que capture la redirección en un puerto local. El código de autorización es válido por dos minutos.
• Aprobación: la página de consentimiento tiene su propio formulario de inicio de sesión, así que el navegador que aprueba no necesita ejecutar la aplicación.
• El alojamiento es por cuenta, no por máquina: la pestaña que presionó Alojar agente externo puede estar en una computadora diferente a la del cliente. Inicia sesión con la misma cuenta en ambos lugares.

Compartir: get_share_link devuelve un enlace al juego, y ese enlace lo abre para su propietario cuando inicia sesión. No acepta opciones y no puede cambiar quién más puede abrir el juego, por diseño. Para dejar entrar a otras personas, abre el juego en Shiny Gen, presiona Compartir y elige Solo jugar o Jugar y duplicar.

Si tu agente tiene su propia computadora

Todo lo anterior asume que la persona está en su propia pestaña de Shiny Gen cuando su IA se conecta. Algunos agentes no están construidos así: tienen su propia máquina y su propio navegador, sin interfaz de conector donde pegar una URL, y sin forma de completar un inicio de sesión como otra persona. Para esos casos, la persona puede entregar una sesión en su lugar.

1. En Shiny Gen, crean un enlace de sesión de agente. Desde la pantalla + vale por un juego nuevo, o una remezcla de un juego que tengan permitido remezclar. Desde el selector de modelos, con un juego abierto, vale por ese juego. Eligen cuánto dura: una hora o veinticuatro horas.
2. Envían el enlace. Se ve así: https://shinygen.ai/agent_session#.... La parte después de # es un código de un solo uso. Los navegadores nunca envían esa parte a un servidor, así que permanece entre la persona y el agente.
3. El agente abre el enlace completo en un navegador. Si puede ejecutar código, puede hacerlo: un Chromium sin interfaz que su propio código inicie (Playwright o Puppeteer) es un navegador real aquí, y la página tiene scripts de copiar y pegar para ello. Obtener el enlace como texto da instrucciones y nada más, a propósito. La página usa el código una vez, dentro de la hora de haber sido creado, va directo a un editor de Shiny Gen ejecutándose en ese navegador y deja un token MCP en el almacenamiento de ese navegador.
4. El agente conecta su cliente MCP a https://mcp.shinygen.ai/mcp con Authorization: Bearer <token>. No hay paso de registro, ni página de consentimiento, ni nada que presionar en la aplicación: crear el enlace fue el permiso.

Tal sesión funciona en el juego que se le dio y en los juegos que crea para la persona (create_game mueve la sesión al juego nuevo, open_game vuelve al anterior). Puede leer los otros juegos de la persona y el catálogo público con browse_games, list_game_files y read_game_file, sin cambiarlos nunca y sin alcanzar el juego privado de otra persona. No puede acceder a configuraciones, compras ni a la cuenta, y el servidor rechaza todo eso tanto si la aplicación lo ofrece como si no. Las gemas funcionan exactamente como siempre: el mismo límite diario, la misma asignación, el mismo interruptor para apagar el gasto del agente. Un enlace de juego nuevo solo crea un juego nuevo: no puede apoderarse de uno que la cuenta ya tenga, y si el nombre está ocupado, el juego simplemente recibe uno único. Un enlace de remezcla abre una copia, y el original nunca se modifica. El agente debería llamar a get_context primero: indica para qué juego es la sesión, qué herramientas no están disponibles y por qué, y cuántas gemas quedan hoy.

La persona sigue al mando. Las sesiones que ha entregado se enumeran en Acceso y gasto del agente con un botón de Revocar, que es la única forma de terminar una sesión manualmente. Abrir el juego ellos mismos no la termina: pueden jugar y mirar mientras el agente trabaja. Mientras una sesión de agente trabaja en un juego, ese juego se abre en solo lectura para la persona, para que no puedan sobrescribirse mutuamente. Una cuenta tiene una sesión de agente a la vez, así que usar un enlace más nuevo termina la sesión anterior, y hasta 10 enlaces sin usar pueden estar esperando a la vez.

Si el agente ya canjeó el enlace

El enlace funciona una vez. El token no: es la sesión, y es válido hasta que la sesión expire o la persona la termine. Un agente cuyo navegador fue cerrado, reiniciado o destruido entre turnos no necesita una nueva invitación.

1. Abre https://shinygen.ai/agent_session/resume y pega el token MCP. Esa dirección no lleva código ni token: la página envía el token como encabezado Authorization. También es lo que cada respuesta de no_live_tab devuelve como resume_url, junto al id del juego, el nombre del juego y el momento en que expira el token.
2. O hazlo directamente: POST https://api.shinygen.ai/agent_session/resume con Authorization: Bearer <token>. La respuesta es el mismo objeto que devolvió el canje.
3. Solo dos respuestas significan que se necesita una nueva invitación: session_revoked y token_expired.

Un agente también debería llamar a save_game como última herramienta de cada turno. Cada escritura se guarda por sí sola, pero save_game solo devuelve una vez que la nube tiene el juego, y su cloud_md5 es la huella digital de la copia que la persona descarga. Eso importa más para agentes cuyo entorno de pruebas termina con el turno.

Si la conexión falla

• El asistente dice que Shiny Gen no está alojando un agente externo: presiona Alojar agente externo en la aplicación (el primer paso arriba) y luego conecta de nuevo. Si Shiny Gen se cerró o perdió su conexión, el alojamiento se detuvo con él: presiona el botón de nuevo.
• No apareció la ventana de inicio de sesión y el cliente dice que la conexión falló: tu navegador casi con seguridad está bloqueando la ventana emergente. Los clientes abren la página de inicio de sesión de Shiny Gen en una ventana nueva, y una ventana emergente bloqueada suele aparecer como un error genérico de conexión. Permite ventanas emergentes para el sitio de tu cliente de IA y conecta de nuevo.
• Verifica que la URL incluya la ruta: la dirección del servidor es https://mcp.shinygen.ai/mcp. El host por sí solo no es el punto final.
• El asistente dice que el acceso del agente está desactivado: "Permitir que los agentes de IA se conecten" está desactivado para tu cuenta. La página de consentimiento ofrece reactivarlo, o actívalo en la aplicación en Acceso y gasto del agente.

Permisos

Alcance	Qué permite
projects.read	Ver tu proyecto: qué hay en pantalla, el documento enfocado y su estado actual.
projects.write	Escribir y editar código del juego y documentos de recursos. Las ediciones de código son gratuitas.
assets.generate	Ejecutar generación de IA (imágenes, y modelos 3D, arte 2D, partituras de audio y comportamiento escrito como código); esto gasta tus gemas, y un límite diario de gemas restringe cuánto puede gastar un asistente conectado en un día.

Qué puede hacer un asistente conectado

• Leer qué hay en pantalla y qué documento está enfocado.
• Escribir o parchear el GDScript del juego; el juego compila, se ejecuta y reporta errores con números de línea.
• Iniciar un juego nuevo para ti, listar los juegos en tu cuenta y abrir cualquiera de ellos — para que puedas decir "vuelve al juego de plataformas" y lo haga.
• Tomar capturas de pantalla para ver lo que ves, incluidas ráfagas de fotogramas para revisar el movimiento.
• Presionar teclas y acciones en el juego en ejecución para probar lo que construyó, incluidas líneas de tiempo completas de entrada cuando un juego necesita dos controles a la vez.
• Generar imágenes con los modelos de generación de Shiny Gen, convertir una imagen en un modelo 3D con textura o una hoja de sprites animada, explorar y restaurar versiones anteriores de un recurso, y eliminar el fondo de una imagen.
• Construir y editar modelos 3D, arte 2D, partituras de audio y comportamiento por entidad como código, y renderizar vistas de un modelo para verificarlo. Cada uno de esos formatos puede ser escrito por el propio asistente de forma gratuita, o generado desde una descripción con gemas, y de cualquier manera lo que obtienes es un documento que tú y él pueden seguir editando. Las mismas dos formas se aplican para cambiar algo que ya existe: el asistente edita el documento mismo de forma gratuita, o un modelo escribe la revisión con gemas, y lo que vuelve sigue siendo un documento de ese tipo — la música sigue siendo una partitura, un dibujo sigue siendo un dibujo que puedes editar, no una imagen plana de él.
• Obtener un enlace para compartir el juego en el que ha estado trabajando.

Qué cuesta y los límites

Conectarse es gratis, y escribir código siempre es gratis — solo la generación de IA gasta gemas. Dos límites separados se aplican a un asistente que trabaja en tu proyecto:

• Un tope diario de gemas. Limita cuántas gemas puede gastar un asistente conectado en un solo día, para que un asistente dejado en ejecución no pueda vaciar tu saldo. Cada resultado de pago reporta tus gemas antes, gastadas y restantes.
• Una asignación semanal de acciones en el plan gratuito. Tu primera conexión inicia una prueba de conector completo de 30 días. Después, las cuentas gratuitas obtienen una asignación de acciones del asistente que cambian algo (escribir código, generar, ejecutar el juego) por semana, actualmente 300, que se reinicia cada lunes (UTC). La lectura nunca está limitada, y cualquiera que haya hecho una compra no está sujeto a esta asignación en absoluto. El conector reporta tu estado actual y cuándo se reinicia la asignación.

El agente de IA integrado en la aplicación

No necesitas un asistente externo en absoluto: Shiny Gen tiene su propio agente de IA integrado en la aplicación, con las mismas habilidades descritas en esta página — lee tu proyecto, escribe código del juego, genera recursos y prueba lo que construye. Conecta Claude o ChatGPT cuando prefieras manejar desde una herramienta que ya usas; de lo contrario, el agente integrado está justo ahí.

Ambos funcionan igual donde importa: la generación gasta gemas, y el tope diario de gemas y la asignación semanal del plan gratuito se aplican a ambos. La diferencia es quién ejecuta el modelo. Un asistente externo se ejecuta en tu propio plan de IA, así que sus ediciones de código no cuestan gemas. El modelo del agente integrado se ejecuta en Shiny Gen, así que cada paso de chat gasta gemas; el selector de modelos muestra cuánto cuesta cada modelo.

La documentación viaja con el conector

Una vez conectado, el asistente recibe automáticamente las referencias de lenguaje de Shiny Gen y la superficie API exacta para el código del juego, servidas a través del propio conector. No necesitas enseñarle nada a tu asistente ni pegar documentación; consulta el contrato mientras trabaja.

Seguridad

• Los permisos son limitados y revocables; puedes desconectarte en cualquier momento.
• Todo lo que hace el asistente ocurre en tu pestaña abierta; ves las ediciones en vivo y puedes pausarlas o detenerlas desde la aplicación.
• Escribir código es gratuito; solo la generación con IA consume gemas, con un límite diario de gemas para asistentes conectados. Cada generación informa tu saldo restante.

¿Preguntas? Consulta la sección MCP de las preguntas frecuentes o contacta con soporte.

Última actualización: 8 de octubre de 2026