agentic

So veröffentlichen Sie eine Website mit Cursor: Cloud Agent oder Ihr eigener Host11 min read

Reading Time: 8 minutesVeröffentlichen Sie eine in Cursor erstellte Website: Testen Sie das Projekt, verwenden Sie Cloud Agent Publish mit Vercel, sofern berechtigt, oder stellen Sie Ihr Repository über einen anderen Host bereit.

Cursor publishing a website cover

So veröffentlichen Sie eine Website mit Cursor: Cloud Agent oder Ihr eigener Host11 min read

Reading Time: 8 minutes

Um eine Website mit Cursor zu veröffentlichen, führen Sie zunächst das Projekt aus und wählen Sie dann den Bereitstellungspfad aus. Der Cloud Agent von Cursor verfügt über einen dokumentierten Veröffentlichungsablauf für ein mit Vercel verbundenes Repository. Wenn Sie den Desktop-Editor integriert haben oder einen anderen Host verwenden, stellen Sie das überprüfte Repository mit der normalen Pipeline dieses Hosts bereit. Mithilfe der Vorschau und des weitergeleiteten Ports von Cursor können Sie die App überprüfen, die öffentliche Adresse, die Sie Ihren Kunden geben, ist jedoch auch nicht verfügbar.

Diese exemplarische Vorgehensweise richtet sich an einen Builder, der einen funktionierenden Start und keinen generierten Landingpage-Screenshot wünscht. Es umfasst die Repository-Auswahl, Eingabeaufforderungen, lokale und Cloud-Vorschauen, Build-Prüfungen, Veröffentlichungen und den optionalen Shared-Artefact-Pfad für Stakeholder. Wenn mehrere Personen denselben Entwurf vor der Veröffentlichung überprüfen müssen, ziehen Sie Folgendes in Betracht: freigegebener AgentGrid.io-Arbeitsbereich statt Screenshots auszutauschen.

So erstellen Sie eine Website in Cursor und veröffentlichen sie mit AgentGrid.io

Richten Sie AgentGrid.io ein, bevor Sie Code in Cursor schreiben, damit die App im richtigen Arbeitsbereich landet.

Schritt 1: Erstellen Sie den Site-Arbeitsbereich in AgentGrid.io

Melden Sie sich unter app.agentgrid.io an, wählen Sie das richtige Team und einen Arbeitsbereich für die Website aus. Verwenden Sie einen separaten Arbeitsbereich für ein engeres Publikum. Wählen Sie ein App-Artefakt für die Website, kein Markdown-Briefing. Durch das Teilen eines privaten Artefakt-Links wird daraus keine öffentliche Website.

AgentGrid.io-Arbeitsbereich mit hervorgehobener Option „Einen Agenten einladen“.
In einem AgentGrid.io-Arbeitsbereich startet das Einladen eines Agenten eine unterstützte Verbindung.

Schritt 2: Verbinden Sie den Cursor-Agenten, nicht nur den Editor

Öffnen Sie das Site-Projekt in Cursor und verwenden Sie den Agent-Modus, der Dateien bearbeiten und Terminalbefehle ausführen kann. Geben Sie ihm diese Anweisung: 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. Genehmigen Sie den Namen, den Arbeitsbereich sowie die Lese- und Schreibfunktion in Ihrem Browser. Lassen Sie „Veröffentlichen“ deaktiviert, es sei denn, Sie möchten, dass der Agent bereitgestellt wird. Bitten Sie dann Cursor um die Ausführung npx @animaapp/cli@latest workspaces und stellen Sie sicher, dass der vorgesehene Arbeitsbereich angezeigt wird. Wenn der Terminalzugriff deaktiviert ist, verwenden Sie stattdessen den manuellen Ordnerimport.

Schritt 3: Erstellen, testen und importieren Sie das Projekt einmal

Eingabeaufforderung Cursor: Erstellen Sie eine responsive Buchungs-Landingpage für eine Fahrradwerkstatt. Verwenden Sie dieses Repository, fügen Sie eine übersichtliche Serviceliste und einen Buchungs-Call-to-Action hinzu, führen Sie die verfügbaren Prüfungen durch und teilen Sie mir mit, welche Dateien den Einstiegspunkt für die Website darstellen. Ändern Sie keinen unabhängigen Code. Überprüfen Sie den Unterschied und öffnen Sie die lokale Vorschau. Lassen Sie den verbundenen Agenten ausführen npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>, wobei der tatsächliche Ordner und die darin aufgeführte Arbeitsbereichs-ID ersetzt werden. Öffnen Sie die zurückgegebene Artefakt-URL. Stellen Sie sicher, dass es sich um eine statische Site handelt index.html und die referenzierten Vermögenswerte sind vorhanden. Ausschließen node_modules, Build-Ausgabe und Anmeldeinformationen. Wenn die Verbindung nicht möglich war, wählen Sie Neu → Ordner hochladen oder Neu → Aus ZIP importieren in AgentGrid.io. Beim Import handelt es sich um einen Snapshot, nicht um eine automatische Synchronisierung mit dem Repository. Überprüfen Sie die Dateien, die Vorschau und den Arbeitsbereich.

White Lotus-Demo-Website-Artefakt in AgentGrid.io
Beispiel eines Website-Artefakts in AgentGrid.io: Die White Lotus-Demo ist privat, während ihre Version überprüft wird.

Schritt 4: Aktualisieren Sie dasselbe Artefakt und veröffentlichen Sie es dann absichtlich

Fügen Sie die Artefakt-URL in den Cursor-Agenten ein und fordern Sie eine konkrete Verbesserung an, z. B. die Korrektur des mobilen Menüs für dieses Artefakt. Bestätigen Sie die Änderung im Verlauf. Wenn die Site genehmigt ist, verwenden Sie „Veröffentlichen“ in AgentGrid.io oder bitten Sie ausdrücklich einen verbundenen Agenten mit Veröffentlichungsfunktion, sie bereitzustellen. Öffnen Sie die resultierende öffentliche URL und testen Sie den Navigations- und Buchungslink. Das Veröffentlichen erfolgt getrennt vom Teilen des privaten Artefakts. Spätere Codeänderungen ersetzen nicht automatisch die öffentliche Bereitstellung: Veröffentlichen Sie ein Update, wenn Sie es live haben möchten.

Aktualisiertes AgentGrid.io-Freigabemenü mit der Option „Veröffentlichen“.
Das aktualisierte Menü „Teilen“ umfasst „Veröffentlichen“, wodurch ein genehmigtes Artefakt in eine Live-Website umgewandelt wird.

Was Cursor direkt veröffentlichen kann

Cursor’s Dokumentation zur Einrichtung der Cloud-Umgebung beschreibt eine bestimmte Reihenfolge: Arbeit in einem Repository speichern, ein Vercel-Konto verbinden, im Agentenfenster „Veröffentlichen“ auswählen und eine Bereitstellungs-URL erhalten. Cursor verknüpft das Repo mit einem Vercel-Projekt und stellt seinen Standardzweig bereit. Spätere Standardzweig-Commits werden automatisch bereitgestellt. Ein Cursor-Team, das in einem Vercel-Team eingesetzt wird, benötigt einen Plan über Hobby. Bei diesen Anforderungen handelt es sich nicht um eine universelle Veröffentlichungsschaltfläche für jedes lokale Editorprojekt.

Schritt 1: Beginnen Sie im richtigen Repository

Öffnen Sie für eine vorhandene Site deren Repository in Cursor und bitten Sie den Agenten, das vorhandene Framework, die Komponenten, Tests und Designkonventionen zu befolgen. Lassen Sie es identifizieren, was bereits bereitgestellt wurde und welcher Zweig in Produktion ist, bevor Sie den Code ändern. Für ein neues Cloud-Agent-Projekt dokumentiert Cursor einen völlig neuen Ansatz und einen Schritt zur Erstellung des Origin-Repositorys. Überprüfen Sie die Verfügbarkeit in Ihrem Konto, bevor Sie sich darauf verlassen. Eine Entwurfsumgebung ohne gespeichertes Repo ist nicht für den dokumentierten Vercel-Veröffentlichungspfad bereit.

Beispielaufforderung: „Erstellen Sie in diesem Repository eine reaktionsfähige Startseite, Workshops und Besuchsseite für den Cedar House-Pflanzenshop. Verwenden Sie das bereitgestellte Logo und den Workshop-Zeitplan, nicht die erfundene Verfügbarkeit. Behalten Sie das vorhandene Framework und die Stilkonventionen bei. Fügen Sie Seitentitel und Beschreibungen, funktionierende Anmeldelinks von project-notes.md und ein tastaturfreundliches mobiles Menü hinzu. Zeigen Sie einen Plan, implementieren Sie ihn, listen Sie geänderte Dateien und Tests auf und stoppen Sie vor der Bereitstellung.“

Wenn das Projekt über API-Routen, Authentifizierung oder vom Server gerenderte Seiten verfügt, identifizieren Sie diese jetzt. Ein rein statischer Host unterstützt die Laufzeit möglicherweise nicht. Fragen Sie, welche Umgebungsvariablen die App erwartet und ob diese dem Browser angezeigt werden. Fügen Sie niemals Produktionsgeheimnisse in eine Agent-Eingabeaufforderung ein und übergeben Sie sie niemals der Quellcodeverwaltung.

Schritt 2: Vorschau der laufenden App

Installieren Sie Abhängigkeiten und führen Sie den vom Projekt definierten Entwicklungsbefehl aus. Öffnen Sie für eine lokale Cursor-Editorsitzung die lokale Entwicklungs-URL in einem Browser. Für einen Cloud Agent dokumentiert Cursor erkannte und manuell konfigurierte weitergeleitete Ports im Agentenfenster. Öffnen Sie die weitergeleitete App im internen Browser und überprüfen Sie echte Seiten. Ein Build-Protokoll mit der Meldung „abgeschlossen“ kann keine reaktionsfähige Navigation oder funktionierende Handlungsaufforderungen validieren.

Überprüfen Sie die Website in schmalen und breiten Breiten. Folgen Sie den Links zu den vorgesehenen Zielen und Testformularen. Probieren Sie Tastaturnavigation und sichtbaren Fokus aus. Überprüfen Sie Bildalternativen, Metadaten, Überschriftenreihenfolge, fehlende Assets und Ladestatus. Überprüfen Sie die Öffnungszeiten, Kontaktdaten, Rechtskopien und Bildrechte anhand der genehmigten Quelle. Wenn die Site von einer API abhängig ist, überprüfen Sie eine fehlgeschlagene Anfrage und stellen Sie sicher, dass in den Browserpaketen keine Anmeldeinformationen angezeigt werden.

Testaufforderung: „Führen Sie die Lint-, Test- und Produktions-Build-Skripts dieses Repositorys aus. Öffnen Sie die drei Seiten in einem Browser auf Mobil- und Desktop-Breite. Melden Sie fehlerhafte Assets, tote Links und unzugängliche Steuerelemente und beheben Sie dann Codefehler. Ändern Sie die Bereitstellungskonfiguration nicht und veröffentlichen Sie sie nicht. Fassen Sie Fehler zusammen, die eine menschliche Entscheidung erfordern.“ Öffnen Sie den Browser tatsächlich selbst, nachdem der Agent den Erfolg meldet.

Schritt 3: Wählen Sie den Startpfad

Pfad Am besten, wenn Was öffentlich wird
Cloud Agent in Vercel veröffentlichen Repository und Vercel-Verbindung sind bereit Vercel-Bereitstellungs-URL und konfigurierte Domäne
Der Bereitstellungsworkflow Ihres Hosts Sie nutzen bereits eine CI/CD-Pipeline oder eine andere Plattform Die Bereitstellungs-URL des Hosts
AgentGrid.io-Artefakt Ein Team benötigt zunächst eine überprüfbare Arbeitsversion Nichts, bis das Artefakt separat veröffentlicht wird

Die ersten beiden Pfade sind Bereitstellungsrouten. Der dritte ist ein Kollaborations- und Veröffentlichungsworkflow mit einer eigenen Kopie der App. Wählen Sie eine Quelle der Wahrheit aus und notieren Sie, welche Version die Prüfer gesehen haben.

Schritt 4: Mit Cursor Cloud Agent und Vercel veröffentlichen

Sobald sich die Arbeit in einem Repository befindet, verbinden Sie das Vercel-Konto in Cursor. Wählen Sie im Fenster „Agenten“ über der Agenteneingabe die Option „Veröffentlichen“ aus. Wenn Cursor „Vercel hinzufügen“ anbietet, schließen Sie zuerst diese Verbindung ab. Überprüfen Sie vor der Genehmigung das Repository, das Vercel-Zielteam, den Standardzweig, die Umgebungsvariablen und die Build-Einstellungen. Der dokumentierte Ablauf von Cursor verknüpft dann das Repo, stellt den Standardzweig bereit und gibt die URL zurück.

Verwenden Sie einen Vorschauzweig nicht als Beweis dafür, was im Standardzweig landet. Überprüfen Sie vor dem Zusammenführen den Unterschied und alle erforderlichen menschlichen Codeüberprüfungen. Ein späterer Commit für diesen Zweig kann die Live-Site automatisch erneut bereitstellen. Definieren Sie daher jetzt Genehmigungs- und Rollback-Verfahren. Wenn eine generierte Site statisch ist, bestätigen Sie das Ausgabeverzeichnis. Wenn Serverrouten beteiligt sind, stellen Sie sicher, dass der Host die Laufzeit der App unterstützt. Behandeln Sie die Domäne DNS und die Abrechnung als separate Eigentumsentscheidungen.

Schritt 5: Über einen anderen Host bereitstellen oder zur Überprüfung freigeben

Übertragen Sie den überprüften Code bei einem anderen Host und folgen Sie dem Framework-spezifischen Repository- oder Upload-Workflow dieses Anbieters. Konfigurieren Sie den Build-Befehl, den Ausgabeort, Umgebungsvariablen, Weiterleitungen und die benutzerdefinierte Domäne auf diesem Host. Nutzen Sie die Vorschaubereitstellung zur Genehmigung durch die Stakeholder, sofern verfügbar. Cursor hilft bei Code und Befehlen; Der Host ist Eigentümer der öffentlichen URL und der Produktionseinstellungen.

Für eine Teamüberprüfung dokumentiert AgentGrid.io a Cursor-Verbindung. Bestätigen Sie, dass die Agent-Umgebung den Verbindungsfluss ausführen kann, gewähren Sie nur Zugriff auf den vorgesehenen Arbeitsbereich und fordern Sie ihn auf, den Artefakt-Link zurückzugeben. Wenn die Verbindung nicht geeignet ist, importieren Sie den überprüften Projektordner oder die ZIP-Datei selbst. Überprüfen Sie die Artefaktvorschau und die Quelle nach der Übertragung. Ein privater Link ist keine Produktionswebsite und Änderungen im Original-Repository werden nicht automatisch mit einer importierten Kopie synchronisiert.

Aufforderung zur bereichsbezogenen Übergabe: „Nachdem ich die Verbindung autorisiert habe, fügen Sie das überprüfte Cedar House-Projekt als unveröffentlichtes App-Artefakt in den benannten Arbeitsbereich ein. Geben Sie die private URL zurück und listen Sie alle Abhängigkeiten oder Backend-Funktionen auf, die nicht übertragen werden konnten. Nicht veröffentlichen, extern teilen oder einen anderen Arbeitsbereich auswählen.“ Wenn sich das Team abmeldet, verwenden Sie die Artefakte Separater Veröffentlichungsablauf wenn AgentGrid.io der ausgewählte Host ist.

Schritt 6: Überprüfen Sie die tatsächliche Bereitstellung

Öffnen Sie die öffentliche URL, während Sie abgemeldet sind und von einem Telefon aus. Vergleichen Sie die Seiten mit der genehmigten Vorschau. Testen Sie Navigation, Formulare, Anmeldeziel, HTTPS, Metadaten, Laden von Bildern und jede benutzerdefinierte Domäne. Zeichnen Sie die bereitgestellte Commit- oder Artefaktrevision auf. Wenn die öffentliche Seite älter ist, überprüfen Sie die Zweigauswahl, die Build-Ausgabe, die Umgebungsvariablen, die Bereitstellungsprotokolle und das Caching, bevor Sie sie ankündigen. Führen Sie die Tests nach jedem Produktionsupdate erneut durch.

Machen Sie das nächste Update bewusst

Notieren Sie die genehmigte Version und die öffentliche URL. Neue Änderungen sind Entwürfe, bis sie überprüft und erneut veröffentlicht werden.

Häufig gestellte Fragen

Kann Cursor eine Website ohne Vercel veröffentlichen?

Ja, indem Sie Code für den Workflow eines anderen Hosting-Anbieters erstellen. Die hier besprochene dokumentierte Cloud Agent Publish-Steuerung verwendet Vercel. Desktop-Editor-Vorschau und weitergeleitete Ports sind keine unabhängigen Hosting-Dienste.

Warum ist „Veröffentlichen“ in meiner Cloud Agent-Sitzung nicht verfügbar?

Überprüfen Sie, ob das Projekt in einem Repository gespeichert ist und ob Vercel verbunden ist. Berechtigung, Plan, Organisationseinstellungen und Repository-Berechtigungen können ebenfalls von Bedeutung sein. Befolgen Sie die aktuelle Einrichtungsanleitung von Cursor, anstatt davon auszugehen, dass in jedem Konto dieselben Steuerelemente angezeigt werden.

Wird eine Cursor-Vorschau meine Live-Website aktualisieren?

Nein. Eine lokale oder weitergeleitete Vorschau stellt einen Entwicklungsprozess zur Inspektion bereit. Eine Bereitstellung ist ein separates Ereignis. Im Vercel-Pfad von Cursor können zukünftige Commits für den Standardzweig die Produktion aktualisieren, nachdem die Integration eingerichtet wurde.

Kann ich AgentGrid.io nur zur Genehmigung verwenden?

Ja. Behalten Sie ein unveröffentlichtes Artefakt zur gemeinsamen Überprüfung und veröffentlichen Sie dann entweder das genehmigte Artefakt oder stellen Sie das entsprechende überprüfte Repository über Ihren vorhandenen Host bereit. Halten Sie beide Kopien ausgerichtet, wenn Sie beide verwenden.

Einen Vergleich der Übergabe finden Sie in unserem Leitfaden zu Teilen Sie die Ausgabe eines Agenten als Link. Die Veröffentlichen Sie eine Claude Design-Website deckt einen weiteren Ausgangspunkt ab, während die Komplettlösung für die Veröffentlichung der Muse-Website zeigt ein rezensiertes Artefakt, das zur Veröffentlichung übergeht. Dabei handelt es sich um unterschiedliche Arbeitsabläufe, nicht um austauschbare Produktfunktionen.

|

Co-founder & CEO