Laissez votre assistant IA configurer Studio
Un assistant de codage IA sur votre ordinateur, comme Claude Code, Codex ou Cursor, peut mettre Studio en ligne pour vous. Vous collez des instructions toutes prêtes. Votre assistant lit le guide de configuration fourni avec Studio, détermine avec vous si votre hébergement web ou un compte Cloudflare convient le mieux, et demande votre accord avant de modifier quoi que ce soit.
- Meilleur pour
- Les personnes qui utilisent déjà un assistant de codage IA capable d'exécuter des commandes sur leur ordinateur, pour l'un ou l'autre type de Studio : sur un hébergement web ou dans Cloudflare.
- Ce qu'il vous faut
- Maxisnap pour Windows ou Mac, connecté avec le compte qui dispose de Studio ; un assistant de codage IA sur votre ordinateur ; et vos identifiants d'hébergement ou un compte Cloudflare.
- Durée
- Peu d'intervention de votre part : vous répondez aux questions de votre assistant et vous approuvez chaque modification.
- Ce que vous obtenez
- Le même Studio que pour les autres options de configuration, sur votre hébergement web ou dans votre propre compte Cloudflare.
Ce que suit votre assistant
Chaque téléchargement de Studio contient des instructions rédigées pour les assistants IA. Elles expliquent les deux éditions de Studio, les étapes d'installation exactes, ce qui doit rester privé et comment vérifier le résultat. Elles indiquent aussi à votre assistant de :
- Vous demander votre accord avant tout envoi, déploiement ou changement sur un serveur ou un compte, et dire exactement ce qu'il va modifier.
- Ne jamais supprimer, écraser ni renommer ce qui existe déjà : fichiers du site web, enregistrements DNS, Workers, buckets ou bases de données. Studio n'ajoute que de nouveaux éléments.
- Garder les clés et les mots de passe en dehors des fichiers qu'il crée.
- Vous donner l'adresse de Studio et la clé d'administration à la fin, pour que vous puissiez connecter Maxisnap.
Récupérez Studio sur votre ordinateur
- Sous Windows : dans Maxisnap, ouvrez Paramètres → Compte → Assistant de configuration, cliquez sur « Commencer », puis sur « Télécharger le tableau de bord ». Maxisnap enregistre le ZIP de Studio dans votre dossier Téléchargements et ouvre ce dossier.
- Sur Mac : dans Maxisnap, ouvrez Settings → Welcome & Help → Studio Setup Guide, cliquez sur « Get Started », puis sur « Download Dashboard ». Maxisnap enregistre le ZIP de Studio dans votre dossier Téléchargements.
Extrayez le ZIP. Sous Windows, faites un clic droit dessus et choisissez « Extraire tout ». Sur Mac, double-cliquez dessus.
Copiez l'emplacement du dossier extrait ; vous le collerez à l'étape 3. Sous Windows, faites un clic droit sur le dossier et choisissez « Copier en tant que chemin d'accès ». Sur Mac, sélectionnez le dossier et appuyez sur Option+Command+C.
Le fichier d'instructions pour les assistants IA se trouve dans ce dossier :
AGENTS.md
Validez votre personnalisation, si vous le souhaitez
Double-cliquez sur « Maxisnap Studio - Start Here.html », personnalisez votre logo, vos couleurs et vos polices, puis cliquez sur « Lock in my branding ». Votre assistant s'en sert. Vous pouvez aussi passer cette étape et modifier la personnalisation plus tard dans votre tableau de bord, sous Branding.
Copiez les instructions
Copiez ces instructions, remplacez la ligne entre chevrons par votre dossier Studio, puis collez-les dans votre assistant.
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”).Copier Copié Copié. Collez-le dans votre assistant. Votre navigateur a bloqué la copie. Sélectionnez plutôt le texte et copiez-le.
Répondez aux questions de votre assistant
- Dites-lui où se trouve votre site web : sur un hébergement web (cPanel, hPanel, Plesk, etc.), sur Cloudflare, ou nulle part pour l'instant. Si vous n'avez pas de site web, l'édition Cloudflare est le choix sûr.
- Pour un hébergement web, il vous indique quoi envoyer et où, ou l'envoie pour vous si vous lui donnez accès à votre hébergement.
- Pour Cloudflare, il vous demande un jeton d'API Cloudflare. Créez le jeton dans Cloudflare sous My Profile → API Tokens avec les permissions que votre assistant indique, et collez-le vous-même dans le terminal.
Vérifiez son plan avant de dire oui
Avant un déploiement sur Cloudflare, votre assistant vous montre le plan. « Will create » répertorie un Worker, un bucket R2 et une base de données D1, et « Will not touch » répertorie tout le reste du compte. Sur un hébergement web, il vous indique quel dossier il va ajouter. Ne dites oui que lorsque la liste vous semble correcte.
Connectez Maxisnap et essayez
Quand tout fonctionne, votre assistant vous donne l'adresse de votre Studio et sa clé d'administration. Conservez la clé en lieu sûr, par exemple dans votre gestionnaire de mots de passe.
- Maxisnap pour Windows : ouvrez Paramètres → Compte → Assistant de configuration, cliquez sur « Commencer », puis sur « Suivant » jusqu'à l'étape 4, « Connecter Maxisnap ». Collez l'adresse et la clé de votre Studio, cliquez sur « Tester la connexion », puis sur « Suivant », puis, sur la dernière page, sur « Terminer et enregistrer ». La clé d'administration fournie lors de la configuration fonctionne, tout comme un code d'envoi issu de People & access dans votre tableau de bord.
- Maxisnap pour Mac : ouvrez Settings → Welcome & Help → Studio Setup Guide et choisissez « I already have a dashboard ». Collez l'adresse et la clé de votre Studio, cliquez sur « Test Connection », puis sur « Next », puis sur « Finish & Save ».
Faites une capture, puis cliquez sur « Envoyer » dans l'éditeur. Sous Windows, Ctrl+Alt+7 capture une zone et l'envoie aussitôt. Le lien de partage arrive dans votre presse-papiers.
Étapes suivantes : ajoutez votre équipe dans le tableau de bord, sous People & access (chacun reçoit son propre code et son propre rôle), et modifiez votre logo ou vos couleurs à tout moment, sous Branding.
En cas de problème
Votre assistant dit qu'il ne peut pas ouvrir de fichiers ni exécuter de commandes
Utilisez un assistant de codage qui fonctionne sur votre ordinateur et peut travailler dans un dossier, comme Claude Code, Codex ou Cursor. Une conversation dans un onglet de navigateur ne peut pas voir votre dossier Studio ni exécuter l'outil de déploiement.
Votre assistant ne trouve pas le fichier d'instructions
Vérifiez le dossier que vous avez collé dans les instructions. Il doit s'agir du dossier Studio extrait, et non du fichier ZIP ; ce dossier contient le fichier d'instructions pour les assistants IA.
Votre assistant dit que Node.js est absent ou trop ancien
L'outil de déploiement Cloudflare a besoin de Node.js 20 ou d'une version plus récente. Installez la version LTS actuelle depuis nodejs.org, ou laissez votre assistant l'installer après qu'il vous a dit ce qu'il va faire, puis recommencez. Studio sur un hébergement web n'a pas besoin de Node.js.
Votre assistant vous demande de coller un jeton ou un mot de passe dans la conversation
Collez-le plutôt dans le terminal, quand la commande vous le demande, pour qu'il ne reste pas dans l'historique de la conversation. Si vous avez déjà collé un jeton Cloudflare dans la conversation, supprimez-le dans Cloudflare sous My Profile → API Tokens une fois que votre Studio fonctionne, et créez-en un nouveau la prochaine fois que vous en aurez besoin.
Votre assistant veut supprimer, remplacer ou renommer quelque chose
Dites non. Studio n'ajoute que de nouveaux éléments, et ses instructions indiquent à votre assistant de ne jamais supprimer, écraser ni renommer ce qui existe déjà : fichiers du site web, enregistrements DNS, Workers, buckets ou bases de données. Demandez-lui plutôt de choisir un nouveau nom.
Votre assistant signale l'absence de votre fichier de personnalisation
Vous n'avez pas encore validé votre personnalisation. Ouvrez « Maxisnap Studio - Start Here.html », personnalisez l'apparence de votre Studio et cliquez sur « Lock in my branding », ou dites à votre assistant de continuer avec l'apparence Maxisnap. Vous pourrez la modifier plus tard dans votre tableau de bord, sous Branding.
La vérification finale de votre assistant répond 401 ou 404
{"error":"unauthorized"}
401 signifie que la clé est incorrecte : utilisez la clé d'administration exactement comme la configuration l'a affichée. 404, ou une page web au lieu d'une courte réponse, signifie que l'adresse ou le dossier est incorrect, ou, sur un hébergement web, que les règles .htaccess de Studio sont ignorées.
Le déploiement Cloudflare s'est arrêté en cours de route
Demandez à votre assistant de relancer la même commande de déploiement depuis le même dossier. Il lit deployment.json et reprend là où il s'était arrêté, sans rien créer en double.
Maxisnap ne se connecte pas avec l'adresse et la clé fournies par votre assistant
L'adresse est celle à laquelle vous ouvrez le tableau de bord de votre Studio ; elle commence par https://, par exemple https://yourcompany.com/snaps. Copiez la clé sans espace avant ni après. Le guide pour connecter un Studio existant explique ce que signifie chaque message.
Besoin d'aide supplémentaire ?
Écrivez-nous et une personne vous répondra, en général sous un jour ouvré. Ces informations nous aident à vous répondre en une seule fois :
- L'option de configuration que vous avez choisie et l'étape où vous en êtes.
- Une capture de l'écran, avec le message d'erreur éventuel en entier.
- Où votre Studio sera installé : un compte Cloudflare nouveau ou existant, ou le nom de votre hébergeur web.
- Votre version de Maxisnap : sous Windows, dans Paramètres, puis À propos ; sur Mac, dans le menu Maxisnap, puis About Maxisnap.
Merci de ne pas envoyer votre clé d'administration, une clé Cloudflare ni un mot de passe. Nous n'en avons pas besoin pour vous aider.
Autres guides de configuration
- Je n'ai pas de site web
Installez Studio dans un compte Cloudflare gratuit
- Mon entreprise utilise déjà Cloudflare
Ajoutez Studio au compte Cloudflare de votre entreprise
- J'ai un hébergement web
Installez Studio sur votre hébergement web
- Je suis développeur web
Configuration de Studio pour les développeurs web
- J'ai déjà un Studio
Connectez Maxisnap à votre Studio