Pular para o conteúdo principal
Guias de configuração do Studio Minha empresa já usa Cloudflare

Adicione o Studio à conta da Cloudflare da sua empresa

Se o domínio da sua empresa já é gerenciado na Cloudflare, o Studio pode ficar nessa mesma conta, ao lado do seu site. Ele recebe um endereço workers.dev próprio e gratuito e, se você quiser, um novo subdomínio do seu domínio. O seu site e os registros DNS dele continuam exatamente como estão.

Melhor para
Empresas cujo domínio já é gerenciado na Cloudflare.
O que você precisa
Maxisnap para Windows ou Mac, conectado com a conta que tem o Studio; um login da conta da Cloudflare da sua empresa com permissão para adicionar Workers, ou a pessoa que cuida dela; e um assistente de programação com IA no seu computador, ou um terminal com Node.js 20 ou mais recente.
Tempo
Cerca de 20 minutos na primeira vez.
Você recebe
O Studio em um endereço workers.dev próprio, além de um novo subdomínio, como snaps.yourcompany.com, se você quiser. O seu site continua exatamente como está.
Custo
O Studio foi feito para rodar no plano gratuito da Cloudflare. A Cloudflare publica a cota gratuita atual do R2 e os preços.

O que o Studio adiciona e o que ele deixa intacto

O que o Studio adiciona

  • O próprio app do Studio (a Cloudflare o chama de “Worker”)
  • Um espaço de armazenamento para as suas capturas (um “bucket R2”)
  • Um pequeno banco de dados para a sua biblioteca e a sua equipe (“D1”)
  • O endereço dele em workers.dev, além de um novo subdomínio, se você escolher um
  • O nome workers.dev da sua conta, se ela ainda não tiver um (um nome para a conta inteira)

O que o Studio deixa intacto

  • O seu site e os arquivos dele
  • Os registros DNS que já existem nos seus domínios
  • Qualquer outro Worker, armazenamento ou banco de dados
  • A sua cobrança e as outras configurações da conta

Se um nome já estiver em uso, o Studio escolhe outro ou pede que você escolha; ele não substitui nada que já exista.

Se outra pessoa cuida da sua Cloudflare ou do seu site, fale com ela primeiro. Algumas empresas têm regras sobre quem pode adicionar serviços à conta da empresa ou colocam uma página de login na frente de cada subdomínio, o que bloquearia os envios do Maxisnap.

Compartilhe o resumo técnico com a pessoa que cuida da sua Cloudflare.

Confira se o armazenamento está ativado

O Studio guarda as suas capturas no R2 da Cloudflare. Entre na conta da Cloudflare da sua empresa e verifique isto uma vez:

  1. No painel da Cloudflare, abra Storage & databases → R2 → Overview.
  2. Se a Cloudflare oferecer a opção de adicionar o R2, conclua o checkout. Se você não for o responsável pela cobrança da conta, peça a essa pessoa que faça este passo.

O painel do seu Studio mostra quanto armazenamento você usa. A documentação do R2 da Cloudflare, consultada em outubro de 2026, diz que o R2 é gratuito para começar, com uso mensal gratuito incluído, e que o seu uso é cobrado mensalmente.

O que você vai ver A página de visão geral do R2 da Cloudflare, com um botão para adicionar o R2 à sua conta e, se a Cloudflare pedir, um formulário para cartão ou PayPal.

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.

Quer o seu logotipo e as suas cores desde o início? Clique duas vezes em “Maxisnap Studio - Start Here.html”, defina a sua marca e clique em “Lock in my branding”. O assistente vai usar o resultado. Ou pule essa etapa e mude a marca depois, no painel, em Branding.

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.

Defina o endereço

O Studio sempre recebe um endereço workers.dev, que funciona desde o início. Você também pode adicionar um novo subdomínio do seu domínio, como snaps.yourcompany.com, se o domínio estiver ativo nesta conta da Cloudflare.

O seu endereço será parecido com este: snaps.yourcompany.workers.dev

Você pode adicionar o seu próprio domínio depois, sem perder nada.

Entregue a tarefa ao assistente de IA

  1. Abra o seu assistente de programação com IA: Claude Code, Codex, Cursor ou outro que consiga executar comandos no seu computador.
  2. Copie as instruções prontas do guia do assistente de IA, substitua a linha entre colchetes angulares pela pasta do seu Studio e cole as instruções no assistente.
  3. Diga a ele que a sua empresa já usa a Cloudflare e se você quer um subdomínio. Ele lê o arquivo de instruções na pasta do seu Studio e explica cada passo antes de executá-lo.

Obtenha as instruções prontas.

Crie uma chave da Cloudflare quando o assistente pedir

A implantação precisa de permissão para trabalhar na sua conta. Você a concede com um token de API da Cloudflare, que funciona como uma senha para essa única tarefa.

  1. Na Cloudflare, abra My Profile → API Tokens, clique em “Create Token” e escolha criar um token personalizado.
  2. Adicione estas quatro permissões: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit e D1 Edit.
  3. Para um subdomínio, adicione mais três: Zone Read, DNS Read e Workers Routes Read.
  4. Em Account Resources, escolha a conta da sua empresa. Para um subdomínio, em Zone Resources, inclua o seu domínio.
  5. Clique em “Continue to summary” e depois em “Create Token”. A Cloudflare mostra o token apenas uma vez, então copie-o imediatamente.
  6. Quando o assistente pedir, cole o token você mesmo no terminal, e não no chat.

Abra a página de API Tokens da Cloudflare.

O resumo técnico explica para que serve cada permissão. Depois que o seu Studio estiver funcionando, você pode excluir o token; para atualizar ou remover o Studio mais tarde, será preciso um novo.

O que você vai ver A página de tokens da Cloudflare: uma linha para cada permissão e um botão “Continue to summary” na parte de baixo.

Confira o plano e depois crie o seu Studio

Nada é criado até você dizer sim. Primeiro, o assistente executa o plano e o mostra para você. “Will create” lista um Worker, um bucket R2 e um banco de dados D1, além do seu nome workers.dev, se for novo, e do seu subdomínio, se você escolheu um. “Will not touch” lista os seus domínios e o DNS, os seus outros Workers, buckets e bancos de dados.

  1. Se o plano mostrar um problema, como um nome que já está em uso, escolha outro nome e execute o plano de novo.
  2. Quando o plano parecer certo, diga ao assistente para prosseguir. Se a implantação parar no meio do caminho, executar o mesmo comando de novo continua sem criar nada em duplicidade.
O que você vai ver O assistente mostra o plano: o endereço do Studio e, em seguida, “Will create”, “Will not touch” e eventuais avisos.

Guarde a sua chave de administrador

  1. Quando termina, a implantação mostra o endereço do seu Studio e a chave de administrador dele, uma única vez. Guarde a chave em um lugar seguro, como o seu gerenciador de senhas. Você entra no painel com ela, e qualquer pessoa que a tenha pode usar o seu Studio.
  2. A implantação também grava um arquivo chamado deployment.json na pasta cloudflare. Guarde esse arquivo, porque a atualização ou a remoção do Studio mais tarde depende dele.

Conecte o Maxisnap e experimente

  • 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.

O Maxisnap para Windows e o Maxisnap para Mac enviam cada arquivo a um Studio na Cloudflare em uma única solicitação, e ele aceita até 25 MB por arquivo.

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 subdomínio já está em uso

snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.

Esse nome já aponta para algum lugar, então o Studio não mexe nele. Escolha um subdomínio que ainda não seja usado por nada, como studio ou share.

Uma rota de Worker já cobre o subdomínio

The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.

Outro Worker da sua conta responde a todos os subdomínios que correspondem a essa rota, então o Studio nunca veria os próprios visitantes. Escolha um nome fora da rota ou pergunte à pessoa que configurou a rota.

O Studio não encontra o seu domínio

That domain is not in this Cloudflare account.

O domínio está em outra conta da Cloudflare, ou o token não consegue enxergá-lo. Crie o token na conta que contém o seu domínio, com Zone Read, DNS Read e Workers Routes Read para esse domínio.

O seu domínio está marcado como “not active yet”

yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.

A Cloudflare ainda não responde pelo domínio, geralmente porque os servidores de nomes dele ainda apontam para o seu provedor antigo. Use o endereço workers.dev por enquanto; você pode adicionar o subdomínio depois, sem perder nada.

O novo subdomínio ainda não abre

A Cloudflare pode demorar um pouco para ativar um novo subdomínio. O endereço workers.dev funciona desde o início, então use-o até lá.

Os envios falham no subdomínio, mas o endereço workers.dev funciona

Uma configuração de segurança da Cloudflare nesse subdomínio está barrando o Maxisnap: Cloudflare Access (uma página de login na frente do endereço), uma regra de WAF ou o Bot Fight Mode. Peça a quem cuida da sua Cloudflare que libere o subdomínio do Studio. O resumo técnico lista o que verificar.

O plano diz que não conseguiu verificar as rotas de Worker

Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).

Adicione Workers Routes Read ao token. Sem essa permissão, o Studio não consegue ver se outro Worker já atende o novo subdomínio.

O armazenamento não está ativado

R2 storage is not turned on for this Cloudflare account yet.

Ative o R2 no painel da Cloudflare, como na etapa 1, e peça ao assistente que execute o plano de novo.

O nome do Studio já está em uso

A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.

Informe outro nome ao assistente, como snaps-yourcompany. Se o nome de um armazenamento ou de um banco de dados já estiver em uso, a ferramenta de implantação escolhe sozinha o próximo nome livre.

A Cloudflare recusou uma etapa

Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.

Falta uma permissão no token. Crie um novo token com as permissões da etapa 5 e cole-o de novo no terminal quando o assistente pedir.

A configuração parou no meio do caminho

Peça ao assistente que execute de novo o mesmo comando de implantação. Ele continua de onde parou e não cria nada em duplicidade.

O seu novo endereço ainda não abre

Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.

Tudo foi criado; a Cloudflare ainda está ativando o endereço. Aguarde alguns minutos e abra o endereço de novo.

Você perdeu a chave de administrador

O assistente pode definir uma nova chave. Ele executa este comando a partir da pasta cloudflare do download do Studio, com um token da Cloudflare no terminal. O comando mostra a nova chave uma única vez; depois, conecte o Maxisnap de novo com ela.

node deploy/cli.mjs update --record deployment.json --yes --new-admin-key

Vídeos grandes não são enviados

O Maxisnap para Windows e o Maxisnap para Mac enviam cada arquivo a um Studio na Cloudflare em uma única solicitação, e ele aceita até 25 MB por arquivo.

Mantenha as gravações abaixo desse tamanho ou corte-as antes de enviar.

O Maxisnap diz que a chave está incorreta

Copie a chave de novo do lugar onde você a guardou, sem espaços antes ou depois dela. Confira também o endereço: é o que a configuração mostrou a você, começando com https://.

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