Deixe o assistente de IA configurar o Studio
Um assistente de programação com IA no seu computador, como Claude Code, Codex ou Cursor, pode colocar o Studio no ar para você. Você cola instruções prontas. O assistente lê o guia de configuração incluído no download do Studio, avalia com você se a sua hospedagem web ou uma conta da Cloudflare é a melhor opção e pergunta antes de alterar qualquer coisa.
- Melhor para
- Pessoas que já usam um assistente de programação com IA capaz de executar comandos no computador, para qualquer um dos dois tipos de Studio: em hospedagem web ou na Cloudflare.
- O que você precisa
- Maxisnap para Windows ou Mac, conectado com a conta que tem o Studio; um assistente de programação com IA no seu computador; e o login da sua hospedagem ou uma conta da Cloudflare.
- Tempo
- Pouco trabalho manual: você responde às perguntas do assistente e aprova cada alteração.
- Você recebe
- O mesmo Studio das outras opções de configuração, na sua hospedagem web ou na sua própria conta da Cloudflare.
O que o assistente segue
Todo download do Studio contém instruções escritas para assistentes de IA. Elas explicam as duas edições do Studio, os passos exatos da instalação, o que deve permanecer privado e como verificar o resultado. Elas também orientam o assistente a:
- Perguntar a você antes de qualquer envio, implantação ou alteração em um servidor ou em uma conta, e dizer exatamente o que vai mudar.
- Nunca excluir, sobrescrever nem renomear o que já existe: arquivos do site, registros DNS, Workers, buckets ou bancos de dados. O Studio só adiciona coisas novas.
- Manter chaves e senhas fora dos arquivos que ele cria.
- Entregar a você o endereço do Studio e a chave de administrador no final, para que você possa conectar o Maxisnap.
Obtenha o Studio no seu computador
- No Windows: no Maxisnap, abra Configurações → Conta → Assistente de configuração, clique em “Comece agora” e depois em “Baixar painel”. O Maxisnap salva o ZIP do Studio na sua pasta Downloads e abre essa pasta.
- No Mac: no Maxisnap, abra Settings → Welcome & Help → Studio Setup Guide, clique em “Get Started” e depois em “Download Dashboard”. O Maxisnap salva o ZIP do Studio na sua pasta Downloads.
Extraia o ZIP. No Windows, clique nele com o botão direito e escolha “Extrair Tudo”. No Mac, clique duas vezes nele.
Copie o local da pasta extraída; você vai colá-lo na etapa 3. No Windows, clique com o botão direito na pasta e escolha “Copiar como caminho”. No Mac, selecione a pasta e pressione Option+Command+C.
O arquivo de instruções para assistentes de IA está nessa pasta:
AGENTS.md
Confirme a sua marca, se quiser
Clique duas vezes em “Maxisnap Studio - Start Here.html”, defina o logotipo, as cores e as fontes e clique em “Lock in my branding”. O assistente vai usar o resultado. Você também pode pular esta etapa e mudar a marca depois, no painel, em Branding.
Copie as instruções
Copie estas instruções, substitua a linha entre colchetes angulares pela pasta do seu Studio e cole as instruções no assistente.
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. Cole no seu assistente. O navegador bloqueou a cópia. Em vez disso, selecione o texto e copie-o.
Responda às perguntas do assistente
- Diga onde está o seu site: em uma hospedagem web (cPanel, hPanel, Plesk etc.), na Cloudflare ou, por enquanto, em lugar nenhum. Sem um site, a edição Cloudflare é a escolha segura.
- Na hospedagem web, ele diz o que enviar e para onde, ou envia por você se você der a ele acesso à sua hospedagem.
- Para a Cloudflare, ele pede um token de API da Cloudflare. Crie o token na Cloudflare, em My Profile → API Tokens, com as permissões que o assistente listar, e cole-o você mesmo no terminal.
Confira o plano dele antes de dizer sim
Antes de uma implantação na Cloudflare, o assistente mostra o plano a você. “Will create” lista um Worker, um bucket R2 e um banco de dados D1, e “Will not touch” lista todo o resto da conta. Na hospedagem web, ele informa qual pasta vai adicionar. Diga sim somente quando a lista parecer certa.
Conecte o Maxisnap e experimente
Quando tudo funciona, o assistente entrega a você o endereço do seu Studio e a chave de administrador dele. Guarde a chave em um lugar seguro, como o seu gerenciador de senhas.
- Maxisnap para Windows: abra Configurações → Conta → Assistente de configuração, clique em “Comece agora” e depois em “Avançar” até chegar à etapa 4, “Conectar o Maxisnap”. Cole o endereço e a chave do seu Studio, clique em “Testar conexão”, depois em “Avançar” e, na última página, em “Concluir e salvar”. Você pode usar a chave de administrador que a configuração mostrou ou um código de envio de People & access, no seu painel.
- Maxisnap para Mac: abra Settings → Welcome & Help → Studio Setup Guide e escolha “I already have a dashboard”. Cole o endereço e a chave do seu Studio, clique em “Test Connection”, depois em “Next” e, por fim, em “Finish & Save”.
Faça uma captura e clique em “Enviar” no editor. No Windows, Ctrl+Alt+7 captura uma região e a envia na hora. O link de compartilhamento vai para a sua área de transferência.
Próximos passos: adicione a sua equipe no painel, em People & access (cada pessoa recebe o próprio código e uma função), e mude o logotipo ou as cores quando quiser, em Branding.
Se algo der errado
O assistente diz que não consegue abrir arquivos nem executar comandos
Use um assistente de programação que rode no seu computador e consiga trabalhar em uma pasta, como Claude Code, Codex ou Cursor. Um chat em uma aba do navegador não consegue ver a pasta do seu Studio nem executar a ferramenta de implantação.
O assistente não encontra o arquivo de instruções
Confira a pasta que você colou nas instruções. Ela precisa ser a pasta do Studio já extraída, e não o arquivo ZIP; é nela que fica o arquivo de instruções para assistentes de IA.
O assistente diz que falta o Node.js ou que a versão é antiga demais
A ferramenta de implantação da Cloudflare precisa do Node.js 20 ou mais recente. Instale a versão LTS atual a partir de nodejs.org ou deixe o assistente instalá-lo depois de explicar o que vai fazer, e então comece de novo. O Studio em hospedagem web não precisa do Node.js.
O assistente pede que você cole um token ou uma senha no chat
Em vez disso, cole-o no terminal quando o comando pedir, para que ele não fique no histórico do chat. Se você já colou um token da Cloudflare no chat, exclua-o na Cloudflare, em My Profile → API Tokens, assim que o seu Studio estiver funcionando, e crie outro na próxima vez que precisar.
O assistente quer excluir, substituir ou renomear alguma coisa
Diga não. O Studio só adiciona coisas novas, e as instruções dele orientam o assistente a nunca excluir, sobrescrever nem renomear arquivos de sites, registros DNS, Workers, buckets ou bancos de dados que já existem. Peça que ele escolha um nome novo.
O assistente diz que falta o arquivo da sua marca
Você ainda não confirmou a sua marca. Abra “Maxisnap Studio - Start Here.html”, defina a sua marca e clique em “Lock in my branding”, ou diga ao assistente para prosseguir com o visual do Maxisnap. Você pode mudar isso depois no painel, em Branding.
A verificação final do assistente retorna 401 ou 404
{"error":"unauthorized"}
401 significa que a chave está errada: use a chave de administrador exatamente como a configuração a mostrou. 404, ou uma página da web em vez de uma resposta curta, significa que o endereço ou a pasta não estão corretos ou, em hospedagem web, que as regras .htaccess do Studio estão sendo ignoradas.
A implantação na Cloudflare parou no meio do caminho
Peça ao assistente que execute de novo o mesmo comando de implantação, a partir da mesma pasta. Ele lê o deployment.json e continua de onde parou, sem criar nada em duplicidade.
O Maxisnap não conecta com o endereço e a chave do assistente
O endereço é aquele que você usa para abrir o painel do seu Studio, começando com https://, como https://yourcompany.com/snaps. Copie a chave sem espaços antes ou depois dela. O guia para conectar um Studio existente explica o que cada mensagem significa.
Ainda precisa de ajuda?
Envie um e-mail e uma pessoa vai responder, geralmente em até um dia útil. Estes detalhes nos ajudam a responder de uma só vez:
- A opção de configuração que você escolheu e a etapa em que você está.
- Uma captura da tela, com qualquer mensagem de erro por inteiro.
- Onde o seu Studio vai ficar: uma conta da Cloudflare nova ou já existente, ou o nome da sua empresa de hospedagem web.
- A sua versão do Maxisnap: no Windows, em Configurações e depois em Sobre; no Mac, em Maxisnap e depois em About Maxisnap.
Por favor, não envie a sua chave de administrador, uma chave da Cloudflare nem uma senha. Não precisamos delas para ajudar você.
Outros guias de configuração
- Não tenho um site
Coloque o Studio em uma conta gratuita da Cloudflare
- Minha empresa já usa Cloudflare
Adicione o Studio à conta da Cloudflare da sua empresa
- Tenho hospedagem web
Instale o Studio na sua hospedagem web
- Sou desenvolvedor web
Configuração do Studio para desenvolvedores web
- Já tenho um Studio
Conecte o Maxisnap ao seu Studio