Ajoutez Studio au compte Cloudflare de votre entreprise
Si le domaine de votre entreprise est déjà géré dans Cloudflare, Studio peut s'installer dans ce même compte, à côté de votre site web. Il reçoit sa propre adresse workers.dev gratuite et, si vous le souhaitez, un nouveau sous-domaine de votre domaine. Votre site web et ses enregistrements DNS restent exactement tels quels.
- Meilleur pour
- Les entreprises dont le domaine est déjà géré dans Cloudflare.
- Ce qu'il vous faut
- Maxisnap pour Windows ou Mac, connecté avec le compte qui dispose de Studio ; un accès au compte Cloudflare de votre entreprise permettant d'ajouter des Workers, ou la personne qui s'en occupe ; et un assistant de codage IA sur votre ordinateur, ou un terminal avec Node.js 20 ou une version plus récente.
- Durée
- Environ 20 minutes la première fois.
- Ce que vous obtenez
- Studio à sa propre adresse workers.dev, plus un nouveau sous-domaine comme snaps.yourcompany.com si vous en voulez un. Votre site web reste exactement tel quel.
- Coût
- Studio est conçu pour fonctionner avec l'offre gratuite de Cloudflare. Cloudflare publie le quota gratuit actuel de R2 et ses tarifs.
Ce que Studio ajoute, et ce qu'il laisse intact
Studio ajoute
- L'application Studio elle-même (Cloudflare l'appelle un « Worker »)
- Un espace de stockage pour vos captures (un « bucket R2 »)
- Une petite base de données pour votre bibliothèque et votre équipe (« D1 »)
- Son adresse sur workers.dev, plus un nouveau sous-domaine si vous en choisissez un
- Le nom workers.dev de votre compte, s'il n'en a pas encore (un seul nom pour tout le compte)
Studio laisse intact
- Votre site web et ses fichiers
- Les enregistrements DNS existants de vos domaines
- Tout autre Worker, espace de stockage ou base de données
- Votre facturation et vos autres paramètres de compte
Si un nom est déjà utilisé, Studio en choisit un autre ou vous demande de le faire ; il ne remplace pas ce qui existe déjà.
Si quelqu'un d'autre s'occupe de votre Cloudflare ou de votre site web, consultez d'abord cette personne. Certaines entreprises ont des règles sur la personne autorisée à ajouter des services au compte de l'entreprise, ou placent une page de connexion devant chaque sous-domaine, ce qui bloquerait les envois de Maxisnap.
Transmettez la note technique à la personne qui s'occupe de votre Cloudflare.
Vérifiez que le stockage est activé
Studio stocke vos captures dans Cloudflare R2. Connectez-vous au compte Cloudflare de votre entreprise et vérifiez-le une fois :
- Dans le tableau de bord Cloudflare, ouvrez Storage & databases → R2 → Overview.
- Si Cloudflare propose d'ajouter R2, terminez son processus de paiement. Si vous n'êtes pas le responsable de la facturation du compte, demandez-lui d'effectuer cette étape.
Le tableau de bord de votre Studio indique la quantité de stockage que vous utilisez. La documentation de Cloudflare sur R2, consultée en octobre 2026, indique que R2 est gratuit pour commencer, avec une utilisation mensuelle gratuite incluse, et que votre utilisation vous est facturée chaque mois.
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.
Vous voulez votre logo et vos couleurs dès le départ ? Double-cliquez sur « Maxisnap Studio - Start Here.html », personnalisez l'apparence de votre Studio et cliquez sur « Lock in my branding ». Votre assistant s'en sert. Ou passez cette étape et modifiez la personnalisation plus tard dans votre tableau de bord, sous Branding.
Décidez de l'adresse
Studio reçoit toujours une adresse workers.dev, qui fonctionne dès le départ. Vous pouvez aussi ajouter un nouveau sous-domaine de votre domaine, comme snaps.yourcompany.com, si le domaine est actif dans ce compte Cloudflare.
Votre adresse ressemblera à ceci : snaps.yourcompany.workers.dev
Vous pourrez ajouter votre propre domaine plus tard sans rien perdre.
Confiez-le à votre assistant IA
- Ouvrez votre assistant de codage IA : Claude Code, Codex, Cursor ou un autre capable d'exécuter des commandes sur votre ordinateur.
- Copiez les instructions toutes prêtes depuis le guide consacré à l'assistant IA, remplacez la ligne entre chevrons par votre dossier Studio, puis collez-les.
- Dites-lui que votre entreprise utilise déjà Cloudflare, et si vous voulez un sous-domaine. Il lit le fichier d'instructions de votre dossier Studio et explique chaque étape avant de l'exécuter.
Créez une clé Cloudflare quand votre assistant la demande
Le déploiement a besoin de l'autorisation de travailler dans votre compte. Vous la donnez avec un jeton d'API Cloudflare, qui fonctionne comme un mot de passe pour cette seule tâche.
- Dans Cloudflare, ouvrez My Profile → API Tokens, cliquez sur « Create Token » et choisissez de créer un jeton personnalisé.
- Ajoutez ces quatre permissions : Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit et D1 Edit.
- Pour un sous-domaine, ajoutez-en trois autres : Zone Read, DNS Read et Workers Routes Read.
- Sous Account Resources, choisissez le compte de votre entreprise. Pour un sous-domaine, sous Zone Resources, incluez votre domaine.
- Cliquez sur « Continue to summary », puis sur « Create Token ». Cloudflare n'affiche le jeton qu'une seule fois ; copiez-le donc tout de suite.
- Quand votre assistant vous le demande, collez vous-même le jeton dans le terminal, et non dans la conversation.
Ouvrez la page API Tokens de Cloudflare.
La note technique indique à quoi sert chaque permission. Une fois votre Studio en marche, vous pouvez supprimer le jeton ; la mise à jour ou la suppression de votre Studio nécessitera plus tard un nouveau jeton.
Vérifiez le plan, puis créez votre Studio
Rien n'est créé tant que vous n'avez pas dit oui. Votre assistant commence par exécuter le plan et vous le montre. « Will create » répertorie un Worker, un bucket R2 et une base de données D1, ainsi que votre nom workers.dev s'il est nouveau et votre sous-domaine si vous en avez choisi un. « Will not touch » répertorie vos domaines et votre DNS, vos autres Workers, buckets et bases de données.
- Si le plan signale un problème, comme un nom déjà utilisé, choisissez un autre nom et relancez le plan.
- Quand le plan vous semble correct, dites à votre assistant de poursuivre. Si le déploiement s'arrête en cours de route, relancer la même commande permet de continuer sans rien créer en double.
Conservez votre clé d'administration
- Une fois terminé, le déploiement affiche l'adresse de votre Studio et sa clé d'administration, une seule fois. Conservez la clé en lieu sûr, par exemple dans votre gestionnaire de mots de passe. C'est avec elle que vous vous connectez à votre tableau de bord, et toute personne qui la possède peut utiliser votre Studio.
- Le déploiement écrit aussi un fichier nommé deployment.json dans le dossier cloudflare. Conservez ce fichier, car il sera utilisé pour mettre à jour ou supprimer votre Studio plus tard.
Connectez Maxisnap et essayez
- 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.
Maxisnap pour Windows et Maxisnap pour Mac envoient chaque fichier à un Studio Cloudflare en une seule requête, que celui-ci accepte jusqu'à 25 MB par fichier.
É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
Le sous-domaine est déjà utilisé
snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.
Ce nom pointe déjà quelque part, donc Studio n'y touche pas. Choisissez un sous-domaine que rien n'utilise encore, comme studio ou share.
Une route Worker couvre déjà le sous-domaine
The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.
Un autre Worker de votre compte répond à tous les sous-domaines qui correspondent à cette route ; Studio ne verrait donc jamais ses propres visiteurs. Choisissez un nom en dehors de la route, ou adressez-vous à la personne qui a configuré la route.
Studio ne trouve pas votre domaine
That domain is not in this Cloudflare account.
Le domaine se trouve dans un autre compte Cloudflare, ou le jeton ne peut pas le voir. Créez le jeton dans le compte qui contient votre domaine, avec Zone Read, DNS Read et Workers Routes Read pour ce domaine.
Votre domaine est marqué « not active yet »
yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.
Cloudflare ne répond pas encore pour ce domaine, généralement parce que ses serveurs de noms pointent toujours vers votre ancien fournisseur. Utilisez pour l'instant l'adresse workers.dev ; vous pourrez ajouter le sous-domaine plus tard sans rien perdre.
Le nouveau sous-domaine ne s'ouvre pas encore
Cloudflare peut mettre un certain temps à activer un nouveau sous-domaine. L'adresse workers.dev fonctionne dès le départ ; utilisez-la en attendant.
Les envois échouent sur le sous-domaine, mais l'adresse workers.dev fonctionne
Un paramètre de sécurité Cloudflare sur ce sous-domaine bloque Maxisnap : Cloudflare Access (une page de connexion placée devant l'adresse), une règle WAF ou Bot Fight Mode. Demandez à la personne qui s'occupe de votre Cloudflare de laisser passer le sous-domaine de Studio. La note technique indique les points à vérifier.
Le plan indique qu'il n'a pas pu vérifier les routes Worker
Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).
Ajoutez Workers Routes Read au jeton. Sans cette permission, Studio ne peut pas voir si un autre Worker intercepte déjà le nouveau sous-domaine.
Le stockage n'est pas activé
R2 storage is not turned on for this Cloudflare account yet.
Activez R2 dans le tableau de bord Cloudflare, comme à l'étape 1, puis demandez à votre assistant de relancer le plan.
Le nom du Studio est déjà utilisé
A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.
Indiquez un autre nom à votre assistant, comme snaps-yourcompany. Si le nom d'un stockage ou d'une base de données est déjà pris, l'outil de déploiement choisit tout seul le prochain nom libre.
Cloudflare a refusé une étape
Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.
Il manque une permission au jeton. Créez un nouveau jeton avec les permissions de l'étape 5 et collez-le de nouveau dans le terminal quand votre assistant vous le demande.
La configuration s'est arrêtée en cours de route
Demandez à votre assistant de relancer la même commande de déploiement. Il reprend là où il s'était arrêté et ne crée rien en double.
Votre nouvelle adresse ne s'ouvre pas encore
Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.
Tout est créé ; Cloudflare est encore en train d'activer l'adresse. Patientez quelques minutes, puis rouvrez l'adresse.
Vous avez perdu votre clé d'administration
Votre assistant peut en définir une nouvelle. Il exécute cette commande depuis le dossier cloudflare de votre téléchargement de Studio, avec un jeton Cloudflare dans le terminal. La commande affiche la nouvelle clé une seule fois ; reconnectez ensuite Maxisnap avec cette clé.
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key Les vidéos volumineuses ne s'envoient pas
Maxisnap pour Windows et Maxisnap pour Mac envoient chaque fichier à un Studio Cloudflare en une seule requête, que celui-ci accepte jusqu'à 25 MB par fichier.
Gardez les enregistrements sous cette taille, ou raccourcissez-les avant de les envoyer.
Maxisnap indique que la clé n'est pas la bonne
Copiez de nouveau la clé depuis l'endroit où vous l'avez enregistrée, sans espace avant ni après. Vérifiez aussi l'adresse : c'est celle que la configuration vous a indiquée ; elle commence par https://.
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
- J'ai un hébergement web
Installez Studio sur votre hébergement web
- Mon assistant IA le configurera
Laissez votre assistant IA configurer Studio
- Je suis développeur web
Configuration de Studio pour les développeurs web
- J'ai déjà un Studio
Connectez Maxisnap à votre Studio