agentic

Cursor를 사용하여 웹 사이트를 게시하는 방법: 클라우드 에이전트 또는 자체 호스트1 min read

Reading Time: 6 minutesCursor에 구축된 웹 사이트 게시: 프로젝트를 테스트하고, 자격이 있는 경우 Vercel로 클라우드 에이전트 게시를 사용하거나 다른 호스트를 통해 저장소를 배포하세요.

Cursor publishing a website cover

Cursor를 사용하여 웹 사이트를 게시하는 방법: 클라우드 에이전트 또는 자체 호스트1 min read

Reading Time: 6 minutes

Cursor로 웹사이트를 게시하려면 먼저 프로젝트를 실행한 다음 배포 경로를 선택하세요. Cursor의 클라우드 에이전트에는 Vercel에 연결된 저장소에 대한 문서화된 게시 흐름이 있습니다. 데스크톱 편집기에서 구축했거나 다른 호스트를 사용하는 경우 해당 호스트의 일반 파이프라인을 사용하여 검토된 리포지토리를 배포합니다. Cursor의 미리보기 및 전달된 포트를 사용하면 앱을 검사할 수 있지만 고객에게 제공하는 공개 주소도 아닙니다.

이 연습은 생성된 랜딩 페이지 스크린샷이 아닌 실제 실행을 원하는 빌더를 위한 것입니다. 리포지토리 선택, 프롬프트, 로컬 및 클라우드 미리 보기, 빌드 확인, 게시 및 이해관계자를 위한 선택적 공유 아티팩트 경로를 다룹니다. 출시 전에 여러 사람이 동일한 초안을 검토해야 하는 경우 공유 AgentGrid.io 작업 공간 스크린샷을 교환하는 대신

Cursor에서 웹사이트를 구축하고 AgentGrid.io로 게시하는 방법

Cursor에 코드를 작성하기 전에 AgentGrid.io를 설정하면 앱이 올바른 작업 공간에 배치됩니다.

1단계: AgentGrid.io에서 사이트 작업공간 만들기

app.agentgrid.io에 로그인하고 올바른 팀을 선택한 다음 웹사이트의 작업 공간을 선택하세요. 더 좁은 범위의 청중을 위해 별도의 작업 공간을 사용하십시오. Markdown 개요가 아닌 웹사이트용 앱 아티팩트를 선택하세요. 비공개 아티팩트 링크를 공유해도 공개 사이트로 전환되지는 않습니다.

에이전트 초대가 강조 표시된 AgentGrid.io 작업 공간
AgentGrid.io 작업 영역에서 에이전트 초대는 지원되는 연결을 시작합니다.

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에서 가져오기를 선택하세요. 가져오기는 스냅샷이며 저장소와의 자동 동기화가 아닙니다. 파일, 미리보기, 작업공간을 확인하세요.

AgentGrid.io의 White Lotus 데모 웹사이트 아티팩트
AgentGrid.io의 웹사이트 아티팩트 예: White Lotus 데모는 해당 버전이 검토되는 동안 비공개입니다.

4단계: 동일한 아티팩트를 업데이트한 후 의도적으로 게시

아티팩트 URL을 Cursor Agent에 붙여넣고 해당 아티팩트에 모바일 메뉴를 수정하는 등 정밀한 개선을 요청하세요. 기록에서 변경 사항을 확인합니다. 사이트가 승인되면 AgentGrid.io에서 게시를 사용하거나 게시 기능이 있는 연결된 에이전트에 배포를 명시적으로 요청하세요. 결과 공개 URL을 열고 탐색 및 예약 링크를 테스트하세요. 게시는 개인 아티팩트 공유와 별개입니다. 이후의 코드 변경은 공개 배포를 자동으로 대체하지 않습니다. 업데이트를 라이브로 원할 때 업데이트를 게시하세요.

게시 옵션을 표시하는 AgentGrid.io 공유 메뉴가 업데이트되었습니다.
업데이트된 공유 메뉴에는 승인된 아티팩트를 라이브 웹 사이트로 전환하는 게시가 포함되어 있습니다.

Cursor가 직접 게시할 수 있는 것

Cursor의 클라우드 환경 설정 문서 특정 순서를 설명합니다. 작업을 저장소에 저장하고, Vercel 계정을 연결하고, 에이전트 창에서 게시를 선택하고, 배포 URL을 받습니다. Cursor는 저장소를 Vercel 프로젝트에 연결하고 기본 분기를 배포합니다. 나중에 기본 분기 커밋이 자동으로 배포됩니다. Vercel 팀에 배포하는 Cursor 팀에는 Hobby 이상의 계획이 필요합니다. 이러한 요구 사항은 모든 로컬 편집기 프로젝트에 대한 보편적인 게시 버튼이 아닙니다.

1단계: 올바른 저장소에서 시작

기존 사이트의 경우 Cursor에서 저장소를 열고 에이전트에게 기존 프레임워크, 구성 요소, 테스트 및 설계 규칙을 따르도록 요청하세요. 코드를 변경하기 전에 이미 배포된 항목과 프로덕션 분기를 식별하도록 하세요. 새로운 클라우드 에이전트 프로젝트의 경우 Cursor는 처음부터 시작 경로와 원본 저장소 생성 단계를 문서화합니다. 의존하기 전에 계정의 가용성을 확인하십시오. 저장된 저장소가 없는 초안 환경은 문서화된 Vercel 게시 경로에 대해 준비되지 않았습니다.

예시 프롬프트: “이 저장소에서 Cedar House 공장 공장을 위한 반응형 홈, 워크샵 및 방문 사이트를 구축하십시오. 가용성이 아닌 제공된 로고 및 워크샵 일정을 사용하십시오. 기존 프레임워크 및 스타일 규칙을 유지하십시오. 페이지 제목 및 설명을 추가하고, project-notes.md의 작업 가입 링크 및 키보드 친화적인 모바일 메뉴를 추가하십시오. 계획을 표시하고, 구현하고, 변경된 파일 및 테스트를 나열하고, 배포 전에 중지하십시오.”

프로젝트에 API 경로, 인증 또는 서버 렌더링 페이지가 있는 경우 지금 식별하십시오. 정적 전용 호스트는 런타임을 지원하지 않을 수 있습니다. 앱이 예상하는 환경 변수와 브라우저에 노출될 환경 변수가 무엇인지 물어보세요. 프로덕션 비밀을 에이전트 프롬프트에 붙여넣거나 소스 제어에 커밋하지 마세요.

2단계: 실행 중인 앱 미리보기

종속성을 설치하고 프로젝트에서 정의한 개발 명령을 실행합니다. 로컬 Cursor 편집기 세션의 경우 브라우저에서 로컬 개발 URL을 엽니다. 클라우드 에이전트의 경우 Cursor 문서는 에이전트 창에서 전달된 포트를 감지하고 수동으로 구성했습니다. 내부 브라우저에서 전달된 앱을 열고 실제 페이지를 검사합니다. “완료”라고 표시된 빌드 로그는 반응형 탐색이나 작업 호출 유도를 검증할 수 없습니다.

좁은 폭과 넓은 폭으로 사이트를 확인해보세요. 원하는 대상 및 테스트 양식에 대한 링크를 따르십시오. 키보드 탐색 및 시각적 포커스를 사용해 보세요. 대체 이미지, 메타데이터, 제목 순서, 누락된 자산 및 로드 상태를 검사합니다. 승인된 소스를 기준으로 매장 영업시간, 연락처 세부정보, 법적 문구, 이미지 권리를 확인하세요. 사이트가 API에 의존하는 경우 실패한 요청을 확인하고 브라우저 번들에 자격 증명이 표시되지 않는지 확인하세요.

테스트 프롬프트: “이 저장소의 린트, 테스트 및 프로덕션 빌드 스크립트를 실행하십시오. 브라우저에서 모바일 및 데스크톱 너비로 세 페이지를 엽니다. 손상된 자산, 데드 링크 및 액세스할 수 없는 컨트롤을 보고한 다음 코드 결함을 수정합니다. 배포 구성을 변경하거나 게시하지 마십시오. 사람의 결정이 필요한 실패를 요약합니다.” 에이전트가 성공을 보고한 후 실제로 직접 브라우저를 엽니다.

3단계: 실행 경로 선택

경로 가장 좋은 때는 공개되는 내용
클라우드 에이전트가 Vercel에 게시 Repository 및 Vercel 연결이 준비되었습니다. Vercel 배포 URL 및 구성된 도메인
호스트의 배포 워크플로 이미 CI/CD 파이프라인 또는 다른 플랫폼을 사용하고 있습니다. 호스트의 배포 URL
AgentGrid.io 아티팩트 팀에는 먼저 검토 가능한 작업 버전이 필요합니다. 아티팩트가 별도로 게시되기 전까지는 아무것도 없습니다.

처음 두 경로는 배포 경로입니다. 세 번째는 자체 앱 복사본을 사용한 공동 작업 및 게시 워크플로입니다. 하나의 진실 소스를 선택하고 어떤 버전 검토자가 본 것인지 기록하세요.

4단계: Cursor Cloud Agent 및 Vercel을 사용하여 게시

작업이 저장소에 있으면 Cursor에서 Vercel 계정을 연결합니다. 에이전트 창에서 에이전트 입력 위에 있는 게시를 선택합니다. Cursor가 Vercel 추가를 제공하는 경우 먼저 해당 연결을 완료하세요. 승인하기 전에 저장소, 대상 Vercel 팀, 기본 분기, 환경 변수 및 빌드 설정을 검토하세요. Cursor의 문서화된 흐름은 저장소를 연결하고, 기본 분기를 배포하고, URL을 반환합니다.

기본 분기에 무엇이 포함될지 증명하기 위해 미리보기 분기를 사용하지 마십시오. 병합하기 전에 차이점과 필요한 휴먼 코드 검토를 확인하세요. 나중에 해당 브랜치에 커밋하면 라이브 사이트가 자동으로 재배포될 수 있으므로 지금 승인 및 롤백 절차를 정의하세요. 생성된 사이트가 정적 사이트인 경우 출력 디렉터리를 확인하세요. 서버 경로가 관련된 경우 호스트가 앱의 런타임을 지원하는지 확인하세요. 도메인 DNS와 청구를 별도의 소유권 결정으로 처리합니다.

5단계: 다른 호스트를 통해 배포하거나 검토를 위해 공유

다른 호스트를 사용하여 검토된 코드를 커밋하고 해당 공급자의 프레임워크별 저장소 또는 업로드 워크플로를 따르세요. 해당 호스트에서 빌드 명령, 출력 위치, 환경 변수, 리디렉션 및 사용자 지정 도메인을 구성합니다. 가능한 경우 이해관계자 승인을 위해 미리보기 배포를 사용하세요. Cursor는 코드 및 명령을 지원합니다. 호스트는 공개 URL과 프로덕션 설정을 소유합니다.

팀 검토를 위해 AgentGrid.io는 다음을 문서화합니다. Cursor 연결. 에이전트 환경이 연결 흐름을 실행할 수 있는지 확인하고, 의도한 작업 영역에 대한 액세스 권한만 부여하고, 아티팩트 링크를 반환하도록 요청할 수 있습니다. 연결이 적합하지 않은 경우 검토한 프로젝트 폴더 또는 ZIP을 직접 가져옵니다. 전송 후 아티팩트 미리보기 및 소스를 검사합니다. 비공개 링크는 프로덕션 웹사이트가 아니며 원본 저장소의 편집 내용은 가져온 복사본과 자동으로 동기화되지 않습니다.

범위가 지정된 핸드오프 프롬프트: “연결을 승인한 후 검토된 Cedar House 프로젝트를 게시되지 않은 앱 아티팩트로 명명된 작업 공간에 넣습니다. 개인 URL을 반환하고 전송에 실패한 모든 종속성 또는 백엔드 기능을 나열합니다. 게시하거나 외부에 공유하거나 다른 작업 공간을 선택하지 마십시오.” 팀이 로그오프할 때 아티팩트의 별도의 게시 흐름 AgentGrid.io가 선택된 호스트인 경우.

6단계: 실제 배포 확인

로그아웃한 상태와 전화에서 공개 URL을 엽니다. 해당 페이지를 승인된 미리보기와 비교하세요. 탐색, 양식, 가입 대상, HTTPS, 메타데이터, 이미지 로드 및 사용자 정의 도메인을 테스트합니다. 배포된 커밋 또는 아티팩트 개정을 기록합니다. 공개 페이지가 오래된 경우 이를 알리기 전에 분기 선택, 빌드 출력, 환경 변수, 배포 로그 및 캐싱을 확인하세요. 프로덕션 업데이트가 완료될 때마다 테스트를 다시 실행하세요.

다음 업데이트를 의도적으로 수행

승인된 버전과 공개 URL을 기록하세요. 새로운 수정사항은 검토 후 다시 게시될 때까지 초안입니다.

자주 묻는 질문

Cursor는 Vercel 없이 웹사이트를 게시할 수 있나요?

예, 다른 호스팅 제공업체의 워크플로를 위한 코드를 생성하면 됩니다. 여기에 설명된 문서화된 클라우드 에이전트 게시 제어는 Vercel을 사용합니다. 데스크탑 편집기 미리보기 및 전달된 포트는 독립적인 호스팅 서비스가 아닙니다.

내 클라우드 에이전트 세션에서 게시를 사용할 수 없는 이유는 무엇입니까?

프로젝트가 저장소에 저장되었는지, Vercel이 연결되었는지 확인하세요. 자격, 계획, 조직 설정 및 저장소 권한도 중요할 수 있습니다. 모든 계정에 동일한 컨트롤이 나타난다고 가정하기보다는 Cursor의 현재 설정 가이드를 따르세요.

Cursor 미리보기가 내 라이브 웹사이트를 업데이트합니까?

아니요. 로컬 또는 전달된 미리 보기는 검사를 위한 개발 프로세스를 공개합니다. 배포는 별도의 이벤트입니다. Cursor의 Vercel 경로에서 기본 분기에 대한 향후 커밋은 통합이 설정된 후 프로덕션을 업데이트할 수 있습니다.

승인용으로만 AgentGrid.io를 사용할 수 있나요?

그렇습니다. 공유 검토를 위해 게시되지 않은 아티팩트를 보관한 다음, 승인된 해당 아티팩트를 게시하거나 기존 호스트를 통해 검토된 해당 저장소를 배포하세요. 두 복사본을 모두 사용하는 경우 두 복사본을 모두 정렬된 상태로 유지하세요.

핸드오프를 비교하려면 다음 가이드를 참조하세요. 에이전트 출력을 링크로 공유. 는 Claude 디자인 웹사이트 게시 또 다른 출발점을 다루고, Muse 웹사이트 게시 연습 검토된 아티팩트가 게시로 이동하는 모습을 보여줍니다. 이는 상호 교환 가능한 제품 기능이 아닌 서로 다른 작업 흐름입니다.

|

Co-founder & CEO