Cursor を使用して Web サイトを公開する方法: クラウド エージェントまたは独自のホスト3 min read
Reading Time: 3 minutesCursor で Web サイトを公開するには、まずプロジェクトを実行してから、展開パスを選択します。 Cursor の Cloud Agent には、Vercel に接続されたリポジトリの公開フローが文書化されています。デスクトップ エディターを組み込んだ場合、または別のホストを使用した場合は、レビューしたリポジトリをそのホストの通常のパイプラインでデプロイします。 Cursor のプレビューと転送ポートを使用するとアプリを検査できますが、顧客に提供するパブリック アドレスも検査できません。
このウォークスルーは、生成されたランディング ページのスクリーンショットではなく、実際に動作する起動を必要とするビルダーを対象としています。リポジトリの選択、プロンプト、ローカルおよびクラウドのプレビュー、ビルド チェック、公開、および関係者向けのオプションの共有アーティファクト パスについて説明します。リリース前に複数の人が同じドラフトをレビューする必要がある場合は、次のことを検討してください。 共有AgentGrid.ioワークスペース スクリーンショットを交換する代わりに。
Cursor で Web サイトを構築し、AgentGrid.io で公開する方法
Cursor にコードを記述する前に、AgentGrid.io をセットアップして、アプリが適切なワークスペースに配置されるようにします。
ステップ 1: AgentGrid.io でサイト ワークスペースを作成する
app.agentgrid.io でサインインし、適切なチームを選択し、Web サイトのワークスペースを選択します。対象者を絞り込む場合は、別のワークスペースを使用してください。 Markdown ブリーフではなく、Web サイトのアプリ アーティファクトを選択します。プライベート アーティファクト リンクを共有しても、それがパブリック サイトになるわけではありません。

ステップ 2: エディターだけでなく、Cursor エージェントに接続する
Cursor でサイト プロジェクトを開き、ファイルを編集してターミナル コマンドを実行できるエージェント モードを使用します。次の指示を与えます。 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. 名前、ワークスペース、ブラウザでの読み取りと書き込みを承認します。エージェントを展開する場合を除き、「公開」をオフのままにしておきます。次に、Cursor に実行を依頼します。 npx @animaapp/cli@latest workspaces 目的のワークスペースが表示されることを確認します。ターミナル アクセスが無効になっている場合は、代わりに手動フォルダー インポートを使用してください。
ステップ 3: プロジェクトを一度ビルド、テスト、インポートする
プロンプト Cursor: 自転車ワークショップ用のレスポンシブな予約ランディング ページを作成します。このリポジトリを使用して、明確なサービス リストと行動喚起の予約を追加し、利用可能なチェックを実行して、どのファイルがサイトのエントリ ポイントであるかを教えてください。無関係なコードは変更しないでください。 差分を確認し、ローカル プレビューを開きます。接続されたエージェントを実行する npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>、リストされている実際のフォルダーとワークスペース ID を置き換えます。返されたアーティファクト URL を開きます。静的サイトの場合は、次のことを確認してください。 index.html そしてその参照資産が存在します。除外する node_modules、ビルド出力、および認証情報。接続できなかった場合は、AgentGrid.io で新規 → フォルダーのアップロードまたは新規 → ZIP からインポートを選択します。インポートはスナップショットであり、リポジトリとの自動同期ではありません。ファイル、プレビュー、ワークスペースを確認します。

ステップ 4: 同じアーティファクトを更新し、意図的に公開する
アーティファクトの URL を Cursor エージェントに貼り付け、そのアーティファクトのモバイル メニューの修正など、正確な改善を求めます。履歴で変更を確認します。サイトが承認されたら、AgentGrid.io で公開を使用するか、公開機能を持つ接続されたエージェントに明示的に展開を依頼します。生成されたパブリック URL を開いて、ナビゲーションと予約リンクをテストします。公開は、プライベート アーティファクトの共有とは別のものです。その後のコード変更によって、パブリック デプロイメントが自動的に置き換えられるわけではありません。更新を公開したい場合は、更新を公開してください。

Cursor が直接公開できるもの
Cursorさん クラウド環境セットアップドキュメント では、作業をリポジトリに保存し、Vercel アカウントに接続し、エージェント ウィンドウで [公開] を選択し、展開 URL を受け取るという特定のシーケンスについて説明します。 Cursor は、リポジトリを Vercel プロジェクトにリンクし、そのデフォルトのブランチをデプロイします。その後のデフォルト ブランチ コミットは自動的にデプロイされます。 Vercel チームに展開する Cursor チームには、ホビー以上のプランが必要です。これらの要件は、すべてのローカル エディター プロジェクトに共通の公開ボタンではありません。
ステップ 1: 適切なリポジトリで開始する
既存のサイトの場合は、Cursor でそのリポジトリを開き、既存のフレームワーク、コンポーネント、テスト、および設計規則に従うようにエージェントに依頼します。コードを変更する前に、何がすでにデプロイされているか、どのブランチが本番であるかを識別させます。新しい Cloud Agent プロジェクトの場合、Cursor には、最初から開始するルートと Origin リポジトリの作成手順が文書化されています。アカウントに依存する前に、アカウントが利用可能かどうかを確認してください。リポジトリが保存されていないドラフト環境は、文書化された Vercel Publish パスに対応する準備ができていません。
プロンプトの例: 「このリポジトリで、Cedar House プラント ショップの応答性の高いホーム、ワークショップ、および訪問サイトを構築します。提供されたロゴとワークショップのスケジュールを使用します。利用できるかどうかを考え出したものではありません。既存のフレームワークとスタイル規則を維持します。ページのタイトルと説明を追加し、project-notes.md から有効なサインアップ リンクを追加し、キーボードで操作できるモバイル メニューを追加します。計画を表示し、実装し、変更されたファイルとテストを一覧表示し、展開前に停止します。」
プロジェクトに API ルート、認証、またはサーバーでレンダリングされたページがある場合は、ここでそれらを特定します。静的専用ホストはランタイムをサポートしていない可能性があります。アプリがどの環境変数を予期しているか、またブラウザーに公開される環境変数があるかどうかを尋ねます。運用シークレットをエージェント プロンプトに貼り付けたり、ソース管理にコミットしたりしないでください。
ステップ 2: 実行中のアプリをプレビューする
依存関係をインストールし、プロジェクトによって定義された開発コマンドを実行します。ローカル Cursor エディター セッションの場合は、ブラウザーでローカル開発 URL を開きます。 Cloud Agent の場合、Cursor ドキュメントにより、エージェント ウィンドウで転送ポートが検出され、手動で設定されました。転送されたアプリを内部ブラウザで開き、実際のページを検査します。 「完了」と表示されるビルド ログでは、応答性の高いナビゲーションや動作する CTA を検証できません。
狭い幅と広い幅でサイトを確認してください。目的のリンク先とテスト フォームへのリンクに従ってください。キーボード ナビゲーションと可視フォーカスを試してください。画像の代替、メタデータ、見出しの順序、欠落しているアセット、読み込み状態を検査します。承認された情報源に対して、店舗の営業時間、連絡先の詳細、法的コピー、および肖像権を検証します。サイトが API に依存している場合は、失敗したリクエストをチェックし、ブラウザ バンドルに資格情報が表示されないことを確認します。
テストプロンプト: 「このリポジトリの lint、テスト、および運用ビルド スクリプトを実行します。モバイルとデスクトップの幅でブラウザで 3 つのページを開きます。壊れたアセット、無効なリンク、アクセスできないコントロールを報告し、コードの欠陥を修正します。デプロイメント構成を変更したり公開したりしないでください。人間の決定が必要な失敗を要約します。」エージェントが成功を報告した後、実際にブラウザを自分で開きます。
ステップ 3: 起動パスを選択する
| パス | 最適な時期 | 公になるもの |
|---|---|---|
| クラウド エージェントの Vercel への公開 | リポジトリと Vercel 接続の準備ができました | Vercel デプロイメント URL と構成されたドメイン |
| ホストの展開ワークフロー | すでに CI/CD パイプラインまたは別のプラットフォームを使用している | ホストのデプロイメント URL |
| AgentGrid.io アーティファクト | チームにはまずレビュー可能な作業バージョンが必要です | アーティファクトが個別に公開されるまでは何もありません |
最初の 2 つのパスは展開ルートです。 3 つ目は、アプリの独自のコピーを使用したコラボレーションおよび公開ワークフローです。 Pick one source of truth and record which version reviewers saw.
Step 4: Publish with Cursor Cloud Agent and Vercel
Once the work is in a repository, connect the Vercel account in Cursor. [エージェント] ウィンドウで、エージェント入力の上にある [公開] を選択します。 Cursor が Add Vercel を提供する場合は、最初にその接続を完了します。 Review the repository, destination Vercel team, default branch, environment variables, and build settings before approving. Cursor の文書化されたフローでは、リポジトリをリンクし、デフォルトのブランチをデプロイして、URL を返します。
デフォルト ブランチに何が配置されるかを証明するためにプレビュー ブランチを使用しないでください。マージする前に、差分と必要な人間によるコード レビューを確認してください。その後そのブランチにコミットすると、ライブ サイトが自動的に再デプロイされるため、ここで承認とロールバックの手順を定義します。生成されたサイトが静的な場合は、出力ディレクトリを確認します。サーバー ルートが関係している場合は、ホストがアプリのランタイムをサポートしていることを確認してください。ドメイン DNS と請求を別個の所有権の決定として扱います。
Step 5: Deploy through another host, or share for review
With another host, commit the reviewed code and follow that provider’s framework-specific repository or upload workflow. Configure build command, output location, environment variables, redirects, and custom domain on that host. Use its preview deployment for stakeholder approval when available. Cursor はコードとコマンドを支援します。 the host owns the public URL and production settings.
チームレビュー用に、AgentGrid.io に文書化されています。 Cursor接続。 Confirm the agent environment can run the connection flow, grant only access to the intended workspace, and ask it to return the artifact link. If connecting is unsuitable, import the reviewed project folder or ZIP yourself. Inspect the artifact preview and source after transfer; a private link is not a production website, and edits in the original repo do not automatically synchronize to an imported copy.
スコープ付きハンドオフ プロンプト: 「接続を承認したら、レビュー済みの Cedar House プロジェクトを、未公開のアプリ アーティファクトとして指定されたワークスペースに配置します。そのプライベート URL を返し、転送に失敗した依存関係やバックエンド機能をリストします。公開したり、外部に共有したり、別のワークスペースを選択したりしないでください。」チームがサインオフするときに、アーティファクトの 別の公開フロー AgentGrid.io が選択されたホストの場合。
ステップ 6: 実際の展開を確認する
Open the public URL while signed out and from a phone.そのページを承認されたプレビューと比較します。 Test navigation, forms, signup destination, HTTPS, metadata, image loading, and any custom domain.デプロイされたコミットまたはアーティファクトのリビジョンを記録します。 If the public page is older, check branch selection, build output, environment variables, deployment logs, and caching before announcing it.本番環境を更新するたびにテストを再実行します。
次回の更新は計画的に行う
承認されたバージョンとパブリック URL を記録します。 New edits are drafts until reviewed and published again.
よくある質問
Can Cursor publish a website without Vercel?
はい、別のホスティングプロバイダーのワークフロー用のコードを作成することで可能です。ここで説明する文書化された Cloud Agent Publish コントロールでは Vercel を使用します。デスクトップ エディターのプレビューと転送ポートは、独立したホスティング サービスではありません。
Cloud Agent セッションで公開が利用できないのはなぜですか?
プロジェクトがリポジトリに保存され、Vercel が接続されていることを確認します。資格、プラン、組織設定、リポジトリ権限も重要になる場合があります。すべてのアカウントに同じコントロールが表示されると想定するのではなく、Cursor の現在のセットアップ ガイドに従ってください。
Cursor プレビューはライブ Web サイトを更新しますか?
いいえ。ローカルまたは転送されたプレビューでは、検査のために開発プロセスが公開されます。デプロイメントは別のイベントです。 Cursor の Vercel パスでは、統合が設定された後、デフォルト ブランチへの今後のコミットによって運用環境が更新される可能性があります。
AgentGrid.io を承認のみに使用できますか?
はい。未公開のアーティファクトを共有レビュー用に保持してから、その承認されたアーティファクトを公開するか、既存のホストを通じて対応するレビュー済みリポジトリをデプロイします。両方を使用する場合は、両方のコピーを揃えてください。
ハンドオフの比較については、ガイドを参照してください。 エージェントの出力をリンクとして共有する。の Claude デザイン Web サイトを公開する 別の出発点をカバーしますが、 Muse Web サイト公開のウォークスルー は、レビュー済みの成果物が公開に移行していることを示しています。これらは異なるワークフローであり、互換性のある製品機能ではありません。

Figma
Adobe XD
Sketch
ブログ


