Deja que tu asistente de IA configure Studio
Un asistente de programación con IA instalado en tu ordenador, como Claude Code, Codex o Cursor, puede poner Studio en línea por ti. Tú pegas unas instrucciones ya preparadas. Tu asistente lee la guía de configuración que viene con el propio Studio, averigua contigo si te encaja mejor tu alojamiento web o una cuenta de Cloudflare, y pregunta antes de cambiar nada.
- Mejor para
- Personas que ya usan un asistente de programación con IA capaz de ejecutar comandos en su ordenador, para cualquiera de los dos tipos de Studio: en un alojamiento web o en Cloudflare.
- Lo que necesitas
- Maxisnap para Windows o Mac, con la sesión iniciada en la cuenta que tiene Studio; un asistente de programación con IA en tu ordenador; y tu acceso al alojamiento o una cuenta de Cloudflare.
- Tiempo
- Casi sin intervención: respondes a las preguntas de tu asistente y apruebas cada cambio.
- Lo que obtienes
- El mismo Studio que con las otras opciones de configuración, en tu alojamiento web o en tu propia cuenta de Cloudflare.
Lo que sigue tu asistente
Cada descarga de Studio contiene instrucciones escritas para asistentes de IA. Explican las dos ediciones de Studio, los pasos exactos de instalación, lo que debe mantenerse en privado y cómo comprobar el resultado. También le indican a tu asistente que:
- Te pregunte antes de cada subida, despliegue o cambio en un servidor o en una cuenta, y te diga exactamente qué va a cambiar.
- Nunca elimine, sobrescriba ni cambie el nombre de lo que ya existe: archivos del sitio web, registros DNS, Workers, buckets o bases de datos. Studio solo añade cosas nuevas.
- Mantenga las claves y las contraseñas fuera de los archivos que crea.
- Te dé la dirección de Studio y la clave de administrador al final, para que puedas conectar Maxisnap.
Consigue Studio en tu ordenador
- En Windows: en Maxisnap, abre Configuración → Cuenta → Asistente de configuración, haz clic en «Empieza» y luego en «Descargar panel». Maxisnap guarda el ZIP de Studio en tu carpeta Descargas y abre esa carpeta.
- En un Mac: en Maxisnap, abre Settings → Welcome & Help → Studio Setup Guide, haz clic en «Get Started» y luego en «Download Dashboard». Maxisnap guarda el ZIP de Studio en tu carpeta Descargas.
Extrae el ZIP. En Windows, haz clic con el botón derecho en él y elige «Extraer todo». En un Mac, haz doble clic en él.
Copia la ubicación de la carpeta extraída; la pegarás en el paso 3. En Windows, haz clic con el botón derecho en la carpeta y elige «Copiar como ruta de acceso». En un Mac, selecciona la carpeta y pulsa Option+Command+C.
El archivo de instrucciones para asistentes de IA está en esa carpeta:
AGENTS.md
Fija tu marca, si quieres
Haz doble clic en «Maxisnap Studio - Start Here.html», diseña tu logotipo, tus colores y tus fuentes, y haz clic en «Lock in my branding». Tu asistente usa esa marca. También puedes saltarte este paso y cambiar la marca más tarde en tu panel, en Branding.
Copia las instrucciones
Copia estas instrucciones, sustituye la línea entre corchetes angulares por tu carpeta de Studio y pégalas en tu asistente.
Set up Maxisnap Studio for me. Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1. Everything is in this folder on my computer: <the folder where I extracted the Studio download> Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result. If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing. Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it. Rules: - Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change. - Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things. - Keep keys and passwords out of files you create and out of chat transcripts where you can. - When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).Copiar Copiado Copiado. Pégalo en tu asistente. Tu navegador ha bloqueado la copia. Selecciona el texto y cópialo manualmente.
Responde a las preguntas de tu asistente
- Dile dónde está tu sitio web: en un alojamiento web (cPanel, hPanel, Plesk, etc.), en Cloudflare o todavía en ninguna parte. Si no tienes sitio web, la edición de Cloudflare es la opción segura.
- Para un alojamiento web, te dice qué subir y dónde, o lo sube por ti si le das acceso a tu alojamiento.
- Para Cloudflare, te pide un token de API de Cloudflare. Crea el token en Cloudflare, en My Profile → API Tokens, con los permisos que te indique tu asistente, y pégalo tú en la terminal.
Revisa su plan antes de decir que sí
Antes de un despliegue en Cloudflare, tu asistente te muestra el plan. «Will create» enumera un Worker, un bucket de R2 y una base de datos D1, y «Will not touch» enumera todo lo demás de la cuenta. En un alojamiento web, te dice qué carpeta va a añadir. Di que sí solo cuando la lista te parezca correcta.
Conecta Maxisnap y pruébalo
Cuando funciona, tu asistente te da la dirección de tu Studio y su clave de administrador. Guarda la clave en un lugar seguro, como tu gestor de contraseñas.
- Maxisnap para Windows: abre Configuración → Cuenta → Asistente de configuración, haz clic en «Empieza» y luego en «Siguiente» hasta llegar al paso 4, «Conecta Maxisnap». Pega la dirección y la clave de tu Studio, haz clic en «Probar conexión», después en «Siguiente» y, en la última página, en «Terminar y guardar». Sirven tanto la clave de administrador de la configuración como un código de subida de People & access de tu panel.
- Maxisnap para Mac: abre Settings → Welcome & Help → Studio Setup Guide y elige «I already have a dashboard». Pega la dirección y la clave de tu Studio, haz clic en «Test Connection», luego en «Next» y después en «Finish & Save».
Haz una captura y, en el editor, haz clic en «Subir». En Windows, Ctrl+Alt+7 captura una región y la sube de inmediato. El enlace para compartir se copia en tu portapapeles.
Próximos pasos: añade a tu equipo en el panel, en People & access (cada persona recibe su propio código y rol), y cambia tu logotipo o tus colores cuando quieras en Branding.
Si algo sale mal
Tu asistente dice que no puede abrir archivos ni ejecutar comandos
Usa un asistente de programación que se ejecute en tu ordenador y pueda trabajar en una carpeta, como Claude Code, Codex o Cursor. Un chat en una pestaña del navegador no puede ver tu carpeta de Studio ni ejecutar la herramienta de despliegue.
Tu asistente no encuentra el archivo de instrucciones
Revisa la carpeta que has pegado en las instrucciones. Debe ser la carpeta de Studio extraída, no el archivo ZIP, y contiene el archivo de instrucciones para asistentes de IA.
Tu asistente dice que falta Node.js o que es demasiado antiguo
La herramienta de despliegue de Cloudflare necesita Node.js 20 o posterior. Instala la versión LTS actual desde nodejs.org, o deja que tu asistente la instale después de explicarte lo que va a hacer, y vuelve a empezar. Studio en un alojamiento web no necesita Node.js.
Tu asistente te pide que pegues un token o una contraseña en el chat
Pégalo mejor en la terminal, cuando el comando te lo pida, para que no quede en el historial del chat. Si ya has pegado un token de Cloudflare en el chat, bórralo en Cloudflare, en My Profile → API Tokens, cuando tu Studio esté en marcha, y crea uno nuevo la próxima vez que lo necesites.
Tu asistente quiere eliminar, reemplazar o renombrar algo
Di que no. Studio solo añade cosas nuevas, y sus instrucciones le dicen a tu asistente que nunca elimine, sobrescriba ni cambie el nombre de archivos del sitio web, registros DNS, Workers, buckets o bases de datos que ya existan. Pídele que elija un nombre nuevo.
Tu asistente dice que falta tu archivo de marca
Todavía no has fijado tu marca. Abre «Maxisnap Studio - Start Here.html», diseña tu marca y haz clic en «Lock in my branding», o dile a tu asistente que siga adelante con el aspecto de Maxisnap. Puedes cambiarlo más tarde en tu panel, en Branding.
La comprobación final de tu asistente responde 401 o 404
{"error":"unauthorized"}
401 significa que la clave no es correcta: usa la clave de administrador exactamente como la mostró la configuración. 404, o una página web en lugar de una respuesta breve, significa que la dirección o la carpeta no son correctas o, en un alojamiento web, que se están ignorando las reglas .htaccess de Studio.
El despliegue en Cloudflare se detuvo a medias
Pide a tu asistente que vuelva a ejecutar el mismo comando de despliegue desde la misma carpeta. El comando lee deployment.json y continúa desde donde se detuvo sin crear nada dos veces.
Maxisnap no se conecta con la dirección y la clave de tu asistente
La dirección es aquella en la que abres el panel de tu Studio; empieza por https://, como https://yourcompany.com/snaps. Copia la clave sin espacios delante ni detrás. La guía para conectar un Studio existente explica qué significa cada mensaje.
¿Sigues necesitando ayuda?
Escríbenos y una persona te responderá, normalmente en un día hábil. Estos datos nos ayudan a responderte a la primera:
- La opción de configuración que has elegido y el paso en el que estás.
- Una captura de pantalla con el mensaje de error completo, si lo hay.
- Dónde vas a poner tu Studio: una cuenta de Cloudflare nueva o ya existente, o el nombre de tu empresa de alojamiento web.
- Tu versión de Maxisnap: en Windows, en Configuración y luego en Acerca de; en un Mac, en el menú Maxisnap y luego en About Maxisnap.
Por favor, no nos envíes tu clave de administrador, una clave de Cloudflare ni una contraseña. No las necesitamos para ayudarte.
Otras guías de configuración
- No tengo un sitio web
Pon Studio en una cuenta gratuita de Cloudflare
- Mi empresa ya usa Cloudflare
Añade Studio a la cuenta de Cloudflare de tu empresa
- Tengo alojamiento web
Instala Studio en tu alojamiento web
- Soy desarrollador web
Configuración de Studio para desarrolladores web
- Ya tengo un Studio
Conecta Maxisnap a tu Studio