Como publicar um site com Cursor: Cloud Agent ou seu próprio host13 min read
Reading Time: 8 minutesPara publicar um site com Cursor, primeiro execute o projeto e depois escolha o caminho de implantação. O Cloud Agent do Cursor possui um fluxo de publicação documentado para um repositório conectado ao Vercel. Se você criou o editor de desktop ou usa um host diferente, implante o repositório revisado com o pipeline normal desse host. A visualização e a porta encaminhada do Cursor permitem inspecionar o aplicativo, mas o endereço público que você fornece aos clientes também não.
Este passo a passo é para um construtor que deseja um lançamento funcional em vez de uma captura de tela da página de destino gerada. Abrange a escolha do repositório, prompts, visualizações locais e na nuvem, verificações de construção, publicação e o caminho opcional do artefato compartilhado para as partes interessadas. Se várias pessoas precisarem revisar o mesmo rascunho antes do lançamento, considere um espaço de trabalho AgentGrid.io compartilhado em vez de trocar capturas de tela.
Como construir um site em Cursor e publicá-lo com AgentGrid.io
Configure AgentGrid.io antes de escrever o código em Cursor para que o aplicativo chegue ao espaço de trabalho correto.
Etapa 1: Crie o espaço de trabalho do site em AgentGrid.io
Faça login em app.agentgrid.io, selecione a equipe correta e escolha um espaço de trabalho para o site. Use um espaço de trabalho separado para um público mais restrito. Escolha um artefato de aplicativo para o site, não um resumo do Markdown. Compartilhar um link de artefato privado não o transforma em um site público.

Etapa 2: Conecte o Agente Cursor, não apenas o editor
Abra o projeto do site em Cursor e use o modo Agente, que pode editar arquivos e executar comandos de terminal. Dê esta instrução: Connect this Cursor Agent to agentgrid.io. Run npx @animaapp/cli@latest login, show me the verification URL and code, and wait for my approval. Do not publish yet. Aprove seu nome, espaço de trabalho e leia e escreva em seu navegador. Deixe Publicar desativado, a menos que queira que o agente seja implantado. Em seguida, peça ao Cursor para executar npx @animaapp/cli@latest workspaces e verifique se ele consegue ver o espaço de trabalho pretendido. Se o acesso ao terminal estiver desabilitado, use a importação manual de pastas.
Etapa 3: crie, teste e importe o projeto uma vez
Alerta Cursor: Crie uma página inicial de reserva responsiva para uma oficina de bicicletas. Use este repositório, adicione uma lista de serviços clara e um call to action de reserva, execute as verificações disponíveis e diga quais arquivos são o ponto de entrada do site. Não altere o código não relacionado. Revise sua comparação e abra a visualização local. Faça com que o agente conectado seja executado npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, substituindo a pasta real e o ID do espaço de trabalho listado. Abra o URL do artefato retornado. Para um site estático, certifique-se index.html e seus ativos referenciados estão presentes. Excluir node_modules, saída de compilação e credenciais. Se a conexão não for possível, escolha Novo → Carregar pasta ou Novo → Importar do ZIP em AgentGrid.io. A importação é um instantâneo, não uma sincronização automática com o repositório. Verifique seus arquivos, visualização e espaço de trabalho.

Etapa 4: atualize o mesmo artefato e publique intencionalmente
Cole o URL do artefato no Agente Cursor e solicite uma melhoria precisa, como corrigir o menu móvel desse artefato. Confirme a mudança no histórico. Quando o site for aprovado, use Publicar em AgentGrid.io ou peça expressamente a um agente conectado com capacidade de Publicação para implantá-lo. Abra o URL público resultante e teste o link de navegação e reserva. A publicação é separada do compartilhamento do artefato privado. Alterações posteriores no código não substituem automaticamente a implantação pública: publique uma atualização quando quiser que ela esteja ativa.

O que Cursor pode publicar diretamente
Cursor Documentação de configuração do ambiente em nuvem descreve uma sequência específica: salve o trabalho em um repositório, conecte uma conta Vercel, selecione Publicar na janela Agentes e receba um URL de implantação. Cursor vincula o repositório a um projeto Vercel e implanta seu branch padrão. As confirmações de ramificação padrão posteriores são implantadas automaticamente. Uma equipe Cursor implantando em uma equipe Vercel precisa de um plano acima do Hobby. Esses requisitos não são um botão de publicação universal para todos os projetos de editores locais.
Etapa 1: comece no repositório certo
Para um site existente, abra seu repositório em Cursor e peça ao Agente para seguir a estrutura, os componentes, os testes e as convenções de design existentes. Faça com que ele identifique o que já está implantado e qual ramificação está em produção antes de alterar o código. Para um novo projeto de Cloud Agent, Cursor documenta uma rota do zero e uma etapa de criação do repositório Origin; verifique a disponibilidade em sua conta antes de confiar nela. Um ambiente de rascunho sem um repositório salvo não está pronto para o caminho documentado do Vercel Publish.
Exemplo de solicitação: “Neste repositório, crie um site responsivo de início, oficinas e visitas para a loja de plantas da Cedar House. Use o logotipo fornecido e a programação do workshop, não a disponibilidade inventada. Mantenha a estrutura existente e as convenções de estilo. Adicione títulos e descrições de páginas, links de inscrição funcionais em project-notes.md e um menu móvel amigável ao teclado. Mostre um plano, implemente-o, liste arquivos e testes alterados e pare antes da implantação.”
Se o projeto tiver rotas de API, autenticação ou páginas renderizadas pelo servidor, identifique-as agora. Um host somente estático pode não suportar o tempo de execução. Pergunte quais variáveis de ambiente o aplicativo espera e se alguma delas seria exposta ao navegador. Nunca cole segredos de produção em um prompt do agente nem os confirme no controle de origem.
Etapa 2: visualizar o aplicativo em execução
Instale dependências e execute o comando de desenvolvimento definido pelo projeto. Para uma sessão do editor Cursor local, abra o URL de desenvolvimento local em um navegador. Para um agente de nuvem, os documentos Cursor detectaram e configuraram manualmente as portas encaminhadas na janela Agentes. Abra o aplicativo encaminhado no navegador interno e inspecione as páginas reais. Um log de construção que diz “completo” não pode validar a navegação responsiva ou chamadas de ação funcionais.
Verifique o site em larguras estreitas e largas. Segue links para os destinos pretendidos e formulários de teste. Experimente a navegação pelo teclado e o foco visível. Inspecione alternativas de imagem, metadados, ordem de cabeçalho, ativos ausentes e estados de carregamento. Valide o horário de funcionamento, detalhes de contato, cópia legal e direitos de imagem em relação à fonte aprovada. Se o site depender de uma API, verifique uma solicitação com falha e confirme se nenhuma credencial aparece nos pacotes do navegador.
Solicitação de teste: “Execute os scripts de lint, teste e construção de produção deste repositório. Abra as três páginas em um navegador em larguras móveis e de desktop. Relate ativos quebrados, links inativos e controles inacessíveis e, em seguida, corrija defeitos de código. Não altere a configuração de implantação ou publique. Resuma as falhas que exigem uma decisão humana.” Na verdade, abra você mesmo o navegador depois que o agente relatar sucesso.
Etapa 3: escolha o caminho de lançamento
| Caminho | Melhor quando | O que se torna público |
|---|---|---|
| Publicação do Cloud Agent no Vercel | Repositório e conexão Vercel estão prontos | URL de implantação Vercel e domínio configurado |
| Fluxo de trabalho de implantação do seu host | Você já usa um pipeline de CI/CD ou outra plataforma | O URL de implantação do host |
| Artefato AgentGrid.io | Uma equipe precisa primeiro de uma versão de trabalho revisável | Nada até que o artefato seja publicado separadamente |
Os dois primeiros caminhos são rotas de implantação. O terceiro é um fluxo de trabalho de colaboração e publicação com sua própria cópia do aplicativo. Escolha uma fonte de verdade e registre qual versão os revisores viram.
Etapa 4: publicar com Cursor Cloud Agent e Vercel
Assim que a obra estiver em um repositório, conecte a conta Vercel em Cursor. Na janela Agentes, selecione Publicar acima da entrada do agente. Se Cursor oferecer Add Vercel, conclua essa conexão primeiro. Revise o repositório, a equipe Vercel de destino, a ramificação padrão, as variáveis de ambiente e as configurações de construção antes de aprovar. O fluxo documentado do Cursor vincula o repositório, implanta a ramificação padrão e retorna a URL.
Não use um branch de visualização como prova do que irá parar no branch padrão. Verifique a diferença e qualquer revisão de código humano necessária antes de mesclar. Um commit posterior nessa filial pode reimplantar o site ativo automaticamente, portanto, defina os procedimentos de aprovação e reversão agora. Se um site gerado for estático, confirme o diretório de saída; se rotas de servidor estiverem envolvidas, confirme se o host oferece suporte ao tempo de execução do aplicativo. Trate o domínio DNS e a cobrança como decisões de propriedade separadas.
Etapa 5: implantar por meio de outro host ou compartilhar para revisão
Com outro host, confirme o código revisado e siga o repositório específico da estrutura desse provedor ou o fluxo de trabalho de upload. Configure o comando de construção, local de saída, variáveis de ambiente, redirecionamentos e domínio personalizado nesse host. Use sua implantação prévia para aprovação das partes interessadas, quando disponível. Cursor auxilia com códigos e comandos; o host possui o URL público e as configurações de produção.
Para uma revisão da equipe, AgentGrid.io documenta um Conexão Cursor. Confirme se o ambiente do agente pode executar o fluxo de conexão, conceda apenas acesso ao espaço de trabalho pretendido e peça para ele retornar o link do artefato. Se a conexão não for adequada, importe você mesmo a pasta do projeto revisado ou ZIP. Inspecione a visualização e a origem do artefato após a transferência; um link privado não é um site de produção e as edições no repositório original não são sincronizadas automaticamente com uma cópia importada.
Solicitação de transferência com escopo definido: “Depois de autorizar a conexão, coloque o projeto Cedar House revisado no espaço de trabalho nomeado como um artefato de aplicativo não publicado. Retorne seu URL privado e liste todas as dependências ou recursos de back-end que não foram transferidos. Não publique, compartilhe externamente ou escolha outro espaço de trabalho.” Quando a equipe terminar, use o artefato fluxo de publicação separado se AgentGrid.io for o host escolhido.
Etapa 6: verifique a implantação real
Abra o URL público enquanto estiver desconectado e em um telefone. Compare suas páginas com a visualização aprovada. Teste a navegação, formulários, destino de inscrição, HTTPS, metadados, carregamento de imagens e qualquer domínio personalizado. Registre o commit implementado ou a revisão do artefato. Se a página pública for mais antiga, verifique a seleção do branch, a saída do build, as variáveis de ambiente, os logs de implantação e o cache antes de anunciá-la. Execute novamente os testes após cada atualização de produção.
Faça a próxima atualização deliberada
Registre a versão aprovada e o URL público. Novas edições são rascunhos até serem revisadas e publicadas novamente.
Perguntas frequentes
Cursor pode publicar um site sem Vercel?
Sim, produzindo código para o fluxo de trabalho de outro provedor de hospedagem. O controle documentado Cloud Agent Publish discutido aqui usa Vercel. A visualização do editor de desktop e as portas encaminhadas não são serviços de hospedagem independentes.
Por que a publicação não está disponível na minha sessão do Cloud Agent?
Verifique se o projeto está salvo em um repositório e se o Vercel está conectado. Elegibilidade, plano, configurações da organização e permissões de repositório também podem ser importantes. Siga o guia de configuração atual do Cursor em vez de assumir que os mesmos controles aparecem em todas as contas.
Uma visualização do Cursor atualizará meu site ativo?
Não. Uma visualização local ou encaminhada expõe um processo de desenvolvimento para inspeção. Uma implantação é um evento separado. No caminho Vercel de Cursor, commits futuros para a ramificação padrão podem atualizar a produção após a configuração da integração.
Posso usar AgentGrid.io apenas para aprovação?
Sim. Mantenha um artefato não publicado para revisão compartilhada e, em seguida, publique esse artefato aprovado ou implemente o repositório revisado correspondente por meio de seu host existente. Mantenha ambas as cópias alinhadas se você usar ambas.
Para uma comparação da transferência, consulte nosso guia para compartilhar uma saída de agente como um link. O publicar um site Claude Design cobre outro ponto de partida, enquanto o Passo a passo de publicação do site Muse mostra um artefato revisado sendo encaminhado para publicação. Esses são fluxos de trabalho diferentes, e não recursos de produtos intercambiáveis.

Figma
Adobe XD
Sketch
Blog


