Pular para o conteúdo principal
Guias de configuração do Studio Meu assistente de IA vai configurar

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

O que você vai ver A pasta do Studio extraída: três pastas (cloudflare, docs e snaps), a página Start Here e as instruções para assistentes de IA.

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”).

Responda às perguntas do assistente

  1. 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.
  2. Na hospedagem web, ele diz o que enviar e para onde, ou envia por você se você der a ele acesso à sua hospedagem.
  3. 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.

Veja as etapas de conta, armazenamento e token da Cloudflare no guia da conta gratuita da Cloudflare.

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.

O que você vai ver O resumo do assistente com o que ele vai criar e o que vai deixar intacto, aguardando o seu sim.

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