Cómo publicar un sitio web con Cursor: Agente en la nube o su propio host13 min read
Reading Time: 9 minutesPara publicar un sitio web con Cursor, primero ejecute el proyecto y luego elija la ruta de implementación. El Agente de nube de Cursor tiene un flujo de publicación documentado para un repositorio conectado a Vercel. Si incorporó el editor de escritorio o utilizó un host diferente, implemente el repositorio revisado con la canalización normal de ese host. La vista previa y el puerto reenviado de Cursor le permiten inspeccionar la aplicación, pero tampoco lo es la dirección pública que les da a los clientes.
Este tutorial está dirigido a un constructor que desea un lanzamiento funcional en lugar de una captura de pantalla de la página de destino generada. Cubre la elección del repositorio, indicaciones, vistas previas locales y en la nube, comprobaciones de compilación, publicación y la ruta opcional de artefactos compartidos para las partes interesadas. Si varias personas necesitan revisar el mismo borrador antes del lanzamiento, considere una espacio de trabajo compartido AgentGrid.io en lugar de intercambiar capturas de pantalla.
Cómo crear un sitio web en Cursor y publicarlo con AgentGrid.io
Configure AgentGrid.io antes de escribir código en Cursor para que la aplicación llegue al espacio de trabajo correcto.
Paso 1: crear el espacio de trabajo del sitio en AgentGrid.io
Inicie sesión en app.agentgrid.io, seleccione el equipo correcto y elija un espacio de trabajo para el sitio web. Utilice un espacio de trabajo separado para una audiencia más reducida. Elija un artefacto de aplicación para el sitio web, no un resumen de Markdown. Compartir un enlace de artefacto privado no lo convierte en un sitio público.

Paso 2: Conecte el agente Cursor, no solo el editor
Abra el proyecto del sitio en Cursor y use el modo Agente, que puede editar archivos y ejecutar comandos de terminal. Dale esta instrucción: 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. Apruebe su nombre, espacio de trabajo y lectura y escritura en su navegador. Deje Publicar desactivado a menos que desee que se implemente el agente. Luego pida a Cursor que ejecute npx @animaapp/cli@latest workspaces y verifique que pueda ver el espacio de trabajo previsto. Si el acceso a la terminal está deshabilitado, utilice la importación manual de carpetas.
Paso 3: cree, pruebe e importe el proyecto una vez
Mensaje Cursor: Cree una página de inicio de reserva receptiva para un taller de bicicletas. Utilice este repositorio, agregue una lista clara de servicios y un llamado a la acción de reserva, ejecute las comprobaciones disponibles y dígame qué archivos son el punto de entrada al sitio. No cambie el código no relacionado. Revise su diferencia y abra la vista previa local. Haga que el agente conectado se ejecute npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, sustituyendo la carpeta real y el ID del espacio de trabajo que figura en la lista. Abra la URL del artefacto devuelto. Para un sitio estático, asegúrese de index.html y sus activos referenciados están presentes. excluir node_modules, resultados de compilación y credenciales. Si la conexión no fue posible, elija Nuevo → Cargar carpeta o Nuevo → Importar desde ZIP en AgentGrid.io. La importación es una instantánea, no una sincronización automática con el repositorio. Verifique sus archivos, vista previa y espacio de trabajo.

Paso 4: actualice el mismo artefacto y luego publíquelo intencionalmente
Pegue la URL del artefacto en el Agente Cursor y solicite una mejora precisa, como arreglar el menú móvil de ese artefacto. Confirma el cambio en Historial. Cuando se apruebe el sitio, utilice Publicar en AgentGrid.io o solicite expresamente a un agente conectado con capacidad de Publicación que lo implemente. Abra la URL pública resultante y pruebe el enlace de navegación y reserva. La publicación es independiente de compartir el artefacto privado. Los cambios de código posteriores no reemplazan automáticamente la implementación pública: publique una actualización cuando los desee.

Qué puede publicar Cursor directamente
Cursor Documentación de configuración del entorno de nube describe una secuencia específica: guardar el trabajo en un repositorio, conectar una cuenta de Vercel, seleccionar Publicar en la ventana Agentes y recibir una URL de implementación. Cursor vincula el repositorio a un proyecto de Vercel e implementa su rama predeterminada. Las confirmaciones de rama predeterminada posteriores se implementan automáticamente. Un equipo Cursor que se despliega en un equipo Vercel necesita un plan superior a Hobby. Estos requisitos no son un botón de publicación universal para cada proyecto de editor local.
Paso 1: comience en el repositorio correcto
Para un sitio existente, abra su repositorio en Cursor y solicite al Agente que siga el marco, los componentes, las pruebas y las convenciones de diseño existentes. Haga que identifique lo que ya está implementado y qué rama está en producción antes de cambiar el código. Para un nuevo proyecto de Cloud Agent, Cursor documenta una ruta de inicio desde cero y un paso de creación del repositorio de Origin; verifique la disponibilidad en su cuenta antes de confiar en ella. Un entorno borrador sin un repositorio guardado no está listo para la ruta documentada de Vercel Publish.
Mensaje de ejemplo: «En este repositorio, cree un sitio responsivo de Inicio, Talleres y Visitas para la tienda de plantas Cedar House. Utilice el logotipo y el cronograma de talleres proporcionados, no la disponibilidad inventada. Mantenga el marco existente y las convenciones de estilo. Agregue títulos y descripciones de páginas, enlaces de registro funcionales desde project-notes.md y un menú móvil compatible con teclado. Muestre un plan, impleméntelo, enumere los archivos y pruebas modificados, y deténgase antes de la implementación».
Si el proyecto tiene rutas API, autenticación o páginas renderizadas por el servidor, identifíquelas ahora. Es posible que un host solo estático no admita el tiempo de ejecución. Pregunte qué variables de entorno espera la aplicación y si alguna estaría expuesta al navegador. Nunca pegue secretos de producción en el indicador de un agente ni los envíe al control de fuente.
Paso 2: vista previa de la aplicación en ejecución
Instale las dependencias y ejecute el comando de desarrollo definido por el proyecto. Para una sesión del editor Cursor local, abra la URL de desarrollo local en un navegador. Para un agente de la nube, los documentos Cursor detectaron y configuraron manualmente los puertos reenviados en la ventana Agentes. Abra la aplicación reenviada en el navegador interno e inspeccione páginas reales. Un registro de compilación que dice «completo» no puede validar la navegación receptiva ni las llamadas a la acción funcionales.
Consulte el sitio en anchos estrechos y anchos. Siga los enlaces a los destinos previstos y los formularios de prueba. Pruebe la navegación con el teclado y el enfoque visible. Inspeccione las alternativas de imágenes, los metadatos, el orden de los encabezados, los recursos faltantes y los estados de carga. Valide el horario de la tienda, los datos de contacto, la copia legal y los derechos de imagen con la fuente aprobada. Si el sitio depende de una API, verifique una solicitud fallida y confirme que no aparezcan credenciales en los paquetes del navegador.
Mensaje de prueba: «Ejecute los scripts de pelusa, prueba y compilación de producción de este repositorio. Abra las tres páginas en un navegador en dispositivos móviles y de escritorio. Informe activos rotos, enlaces inactivos y controles inaccesibles, luego corrija los defectos del código. No altere la configuración de implementación ni publique. Resuma las fallas que requieren una decisión humana». En realidad, abra el navegador usted mismo después de que el agente informe que tuvo éxito.
Paso 3: elige la ruta de lanzamiento
| Camino | mejor cuando | lo que se vuelve publico |
|---|---|---|
| Publicación del agente en la nube en Vercel | El repositorio y la conexión Vercel están listos | URL de implementación de Vercel y dominio configurado |
| El flujo de trabajo de implementación de su host | Ya utilizas una canalización de CI/CD u otra plataforma | La URL de implementación del host |
| artefacto AgentGrid.io | Un equipo necesita primero una versión funcional revisable | Nada hasta que el artefacto se publique por separado. |
Los dos primeros caminos son rutas de implementación. El tercero es un flujo de trabajo de colaboración y publicación con su propia copia de la aplicación. Elija una fuente de verdad y registre qué versión vieron los revisores.
Paso 4: Publicar con Cursor Cloud Agent y Vercel
Una vez que el trabajo esté en un repositorio, conecte la cuenta de Vercel en Cursor. En la ventana Agentes, seleccione Publicar encima de la entrada del agente. Si Cursor ofrece Agregar Vercel, primero complete esa conexión. Revise el repositorio, el equipo Vercel de destino, la rama predeterminada, las variables de entorno y la configuración de compilación antes de aprobar. Luego, el flujo documentado de Cursor vincula el repositorio, implementa la rama predeterminada y devuelve la URL.
No utilice una rama de vista previa como prueba de lo que llegará a la rama predeterminada. Verifique la diferencia y cualquier revisión del código humano requerida antes de fusionar. Una confirmación posterior a esa rama puede volver a implementar el sitio activo automáticamente, así que defina los procedimientos de aprobación y reversión ahora. Si un sitio generado es estático, confirme el directorio de salida; Si hay rutas del servidor involucradas, confirme que el host admita el tiempo de ejecución de la aplicación. Trate el dominio DNS y la facturación como decisiones de propiedad independientes.
Paso 5: implementar a través de otro host o compartir para revisión
Con otro host, confirme el código revisado y siga el repositorio específico del marco de trabajo de ese proveedor o el flujo de trabajo de carga. Configure el comando de compilación, la ubicación de salida, las variables de entorno, las redirecciones y el dominio personalizado en ese host. Utilice su implementación preliminar para la aprobación de las partes interesadas cuando esté disponible. Cursor ayuda con código y comandos; el host posee la URL pública y la configuración de producción.
Para una revisión del equipo, AgentGrid.io documenta un Conexión Cursor. Confirme que el entorno del agente pueda ejecutar el flujo de conexión, otorgue solo acceso al espacio de trabajo deseado y pídale que devuelva el enlace del artefacto. Si la conexión no es adecuada, importe usted mismo la carpeta del proyecto revisado o el ZIP. Inspeccionar la vista previa del artefacto y la fuente después de la transferencia; un enlace privado no es un sitio web de producción y las ediciones en el repositorio original no se sincronizan automáticamente con una copia importada.
Aviso de transferencia con alcance: «Después de autorizar la conexión, coloque el proyecto Cedar House revisado en el espacio de trabajo designado como un artefacto de aplicación no publicado. Devuelva su URL privada y enumere las dependencias o características de backend que no se pudieron transferir. No publique, comparta externamente ni elija otro espacio de trabajo». Cuando el equipo cierre la sesión, usa el artefacto. flujo de publicación separado si AgentGrid.io es el host elegido.
Paso 6: verificar la implementación real
Abra la URL pública sin iniciar sesión y desde un teléfono. Compare sus páginas con la vista previa aprobada. Pruebe la navegación, los formularios, el destino de registro, HTTPS, los metadatos, la carga de imágenes y cualquier dominio personalizado. Registre la confirmación implementada o la revisión del artefacto. Si la página pública es más antigua, verifique la selección de ramas, el resultado de la compilación, las variables de entorno, los registros de implementación y el almacenamiento en caché antes de anunciarla. Vuelva a ejecutar las pruebas después de cada actualización de producción.
Haga que la próxima actualización sea planificada
Registre la versión aprobada y la URL pública. Las nuevas ediciones son borradores hasta que se revisen y publiquen nuevamente.
Preguntas frecuentes
¿Puede Cursor publicar un sitio web sin Vercel?
Sí, produciendo código para el flujo de trabajo de otro proveedor de hosting. El control documentado de publicación del agente en la nube que se analiza aquí utiliza Vercel. La vista previa del editor de escritorio y los puertos reenviados no son servicios de alojamiento independientes.
¿Por qué Publicar no está disponible en mi sesión de Cloud Agent?
Verifique que el proyecto esté guardado en un repositorio y que Vercel esté conectado. La elegibilidad, el plan, la configuración de la organización y los permisos del repositorio también pueden ser importantes. Siga la guía de configuración actual de Cursor en lugar de asumir que aparecen los mismos controles en todas las cuentas.
¿Una vista previa de Cursor actualizará mi sitio web activo?
No. Una vista previa local o reenviada expone un proceso de desarrollo para su inspección. Una implementación es un evento separado. En la ruta Vercel de Cursor, las confirmaciones futuras a la rama predeterminada pueden actualizar la producción después de configurar la integración.
¿Puedo utilizar AgentGrid.io sólo para aprobación?
Sí. Mantenga un artefacto no publicado para revisión compartida, luego publique ese artefacto aprobado o implemente el repositorio revisado correspondiente a través de su host existente. Mantenga ambas copias alineadas si usa ambas.
Para una comparación del traspaso, consulte nuestra guía para compartir la salida de un agente como un enlace. el publicar un sitio web de diseño Claude cubre otro punto de partida, mientras que el Tutorial de publicación del sitio web de Muse muestra un artefacto revisado pasando a publicación. Estos son flujos de trabajo diferentes, no características de productos intercambiables.

Figma
Adobe XD
Sketch
Blog


