PreviewShip 문서

PreviewShip은 브라우저에서 바로 열 수 있는 프론트엔드 산출물을 고정 프리뷰 URL로 바꿉니다. 워크플로에 맞는 방법을 선택하세요:

1. 1previewship.com에서 무료 계정 등록
2. 2콘솔의 API Keys 페이지에서 API Key 생성
3. 3CLI, MCP, 에디터 확장 또는 콘솔 업로드로 React/Vue/Vite/Next 정적 출력, index.html이 포함된 zip, 단일 HTML/Markdown/PDF 파일, 붙여넣은 HTML, 에이전트 생성물을 배포합니다
4. 4고정 프리뷰 URL을 공유하고 필요하면 접근 제어, 버전, 롤백, 재배포, 프로젝트 정리를 관리합니다

공유할 산출물이 이미 브라우저에서 열릴 수 있다면 PreviewShip을 사용하세요. 프론트엔드 리뷰 링크용이며 소스 빌드나 백엔드 호스팅 플랫폼이 아닙니다.

터미널 명령 하나로 배포하고 고정 프로젝트 URL, 공개/비밀번호 접근, 버전, 롤백, 재배포, 삭제를 관리합니다. CLI는 AI 에이전트와 CI를 위한 JSON 출력도 지원합니다.

설치

npx를 직접 사용하거나(설치 불필요) 전역 설치할 수 있습니다:

API Key 설정

인증을 위한 API Key를 설정하세요:

또는 환경 변수로 설정:

배포

빌드된 정적 디렉터리, 단일 HTML 파일 또는 Markdown 문서를 배포해 프리뷰 링크를 받으세요:

Agent를 위한 JSON 출력

--json 플래그를 사용하면 구조화된 출력을 받을 수 있으며, AI agent 및 CI 파이프라인에 적합합니다:

프로젝트 관리 명령

프로젝트 확인, 접근 변경, 만료 링크 복구, 고정 URL 롤백, 사용하지 않는 Free 프로젝트 슬롯 삭제에 사용하세요.

previewship deployments list --json
previewship projects list --json
previewship projects access 42 --password "review-pass"
previewship projects access 42 --public
previewship projects versions 42
previewship projects rollback 42 105 --confirm my-project
previewship projects redeploy 42
previewship projects delete 42 --confirm my-project

MCP 서버는 AI 코딩 에이전트가 프리뷰 배포와 프로젝트 관리를 네이티브 도구 호출로 수행하게 합니다. Claude Code, Cursor, Windsurf 및 MCP 호환 클라이언트에서 작동합니다.

설정

Claude Code의 경우 ~/.claude/settings.json에 추가:

{
  "mcpServers": {
    "previewship": {
      "command": "npx",
      "args": ["-y", "previewship-mcp"],
      "env": {
        "PREVIEWSHIP_API_KEY": "ps_live_your_key_here"
      }
    }
  }
}

Cursor의 경우 프로젝트 루트에 .cursor/mcp.json 생성:

{
  "mcpServers": {
    "previewship": {
      "command": "npx",
      "args": ["-y", "previewship-mcp"],
      "env": {
        "PREVIEWSHIP_API_KEY": "ps_live_your_key_here"
      }
    }
  }
}

Windsurf의 경우 ~/.codeium/windsurf/mcp_config.json에 추가:

{
  "mcpServers": {
    "previewship": {
      "command": "npx",
      "args": ["-y", "previewship-mcp"],
      "env": {
        "PREVIEWSHIP_API_KEY": "ps_live_your_key_here"
      }
    }
  }
}

사용 가능한 도구

• deploy_preview — 빌드 출력 디렉터리, 단일 .html 파일 또는 Markdown 문서를 배포하고 고정 프리뷰 URL을 반환합니다
• check_deployment — ID로 배포 상태를 확인합니다
• show_usage — 남은 배포 쿼터를 표시합니다
• list_projects / get_project — 고정 URL, 프로젝트 상태, 접근 모드, 재배포 가능 여부를 확인합니다
• get_project_access / set_project_access — PUBLIC과 PASSWORD를 전환합니다. PUBLIC은 저장된 비밀번호를 삭제합니다
• list_project_versions / rollback_project_version — retained 버전을 보고 고정 URL을 과거 배포로 롤백합니다
• redeploy_project_latest — latest retained artifact로 만료된 고정 프리뷰 링크를 복구합니다
• delete_project — 확인된 프로젝트를 삭제하고 고정 URL, 호스팅 프로젝트, 배포 연결, Showcase 항목을 영구 삭제합니다

PreviewShip은 현재 Codex 대화를 공유하기 위한 선택형 Codex skill도 제공합니다. 보이는 채팅 기록을 고충실도 HTML 페이지로 만들고 PreviewShip CLI로 배포한 뒤 공개 URL을 반환합니다.

skill 설치

Codex에서 사용

설치 후 Codex 대화에서 skill을 참조하세요:

PreviewShip은 Claude Code 대화를 공유하기 위한 선택형 Claude Code skill도 제공합니다. 로컬 Claude Code JSONL 기록을 읽고, 보이는 채팅을 고품질 HTML 페이지로 렌더링한 뒤 PreviewShip CLI로 배포하고 공개 URL을 반환합니다.

skill 설치

Codex에서 사용

설치 후 Codex 대화에서 이 skill을 참조하고 Claude Code 대화 공유를 요청하세요:

Cursor는 VS Code 확장 프로그램과 완벽하게 호환됩니다. 동일한 방법으로 설치할 수 있습니다.

명령 팔레트로 설치

1. 1Cursor를 열고 Ctrl+P (Mac은 Cmd+P)를 누르세요
2. 2아래 명령을 붙여넣고 Enter를 누르세요:

VSIX로 설치

오프라인 설치가 필요한 경우 .vsix 파일을 다운로드하고 아래 "VSIX 수동 설치" 섹션을 참조하세요.

VS Code를 열고 Ctrl+P (Mac은 Cmd+P)를 누른 후 아래 명령을 붙여넣고 Enter를 누르세요:

마켓플레이스에 접근할 수 없는 환경에서는 .vsix 파일로 수동 설치할 수 있습니다.

설치 단계

1. 1위 버튼을 클릭하여 .vsix 파일 다운로드
2. 2Cursor 또는 VS Code를 열고 확장 프로그램 패널(Ctrl+Shift+X) 열기
3. 3확장 프로그램 패널 우측 상단 "..." → "VSIX에서 설치..." → 다운로드한 파일 선택

명령줄로도 설치할 수 있습니다:

모든 배포 방법(CLI, MCP, 에디터 확장 프로그램)에 API Key가 필요합니다. 생성 방법:

1. 1previewship.com에 로그인하고 API Keys 페이지로 이동
2. 2"API Key 생성"을 클릭하고 이름을 입력한 후 생성된 키 복사
3. 3CLI(previewship login), MCP 설정(PREVIEWSHIP_API_KEY 환경 변수) 또는 에디터 확장 프로그램(Set API Key 명령)에서 키를 사용

확장 프로그램 설치와 API Key 설정이 완료되면:

1. 1에디터에서 프론트엔드 프로젝트 폴더 열기
2. 2Open the command palette (Ctrl+Shift+P) and run "PreviewShip: Deploy Workspace, HTML, Markdown, or PDF File" or "PreviewShip: Deploy Active HTML, Markdown, or PDF File"
3. 3The extension packages the selected build output, HTML file, or Markdown file, uploads it, and returns a preview URL when ready

도구 없이 웹 콘솔에서 직접 배포할 수도 있습니다. 콘솔은 build-output zip 업로드, 단일 HTML, Markdown 또는 PDF 파일 업로드, HTML 소스 붙여넣기를 지원합니다:

1. 1로그인 후 "배포" 페이지로 이동
2. 2Select or create a project, then upload a .zip containing static build output, upload a .html/.md/.markdown/.pdf file, or paste a complete HTML document
3. 3PreviewShip은 zip 아티팩트를 정적 사이트로 배포하고, 단일 HTML 입력은 index.html로 패키징하며, 단일 Markdown 입력은 안전한 Markdown 뷰어 페이지를 추가한 뒤 배포합니다

프로젝트는 PreviewShip 링크 뒤의 안정적인 컨테이너입니다. 각 프로젝트는 고정 URL, latest 배포 포인터, 접근 모드, retained 버전, 선택적 Showcase 상태를 가집니다.

• 새 프로젝트 이름으로 배포하면 자동 생성되며, guest 프리뷰를 연결하면 고정 프로젝트에 바인딩됩니다.
• 고정 프로젝트 URL은 배포할 때마다 바뀌지 않습니다. 배포와 롤백은 해당 URL이 제공하는 내용만 바꿉니다.
• 공개 프로젝트는 일반적으로 공유할 수 있습니다. Pro 프로젝트는 비밀번호 접근을 사용할 수 있고 공개로 바꾸면 비밀번호가 삭제됩니다.
• 버전 기록은 플랜에 따라 다릅니다. Free는 3개, Pro Monthly는 10개, Pro Yearly는 40개의 롤백 가능 버전을 artifact가 유지되는 범위에서 보여줍니다.
• Free에는 프로젝트 1개가 포함됩니다. 한도가 가득 차면 사용하지 않는 프로젝트를 삭제하거나 업그레이드한 뒤 새 프리뷰를 배포/연결하세요.
• 프로젝트 삭제는 고정 프리뷰 URL, 호스팅 프로젝트, 배포 연결, Showcase 항목을 영구적으로 제거합니다.
• 공개 및 승인된 Showcase 항목만 색인될 수 있습니다. 비밀번호 프로젝트, 비공개/숨김 항목, 만료되어 접근할 수 없는 콘텐츠는 sitemap에 들어가지 않습니다.

PreviewShip 플랜은 배포 쿼터, 프로젝트 수, 업로드 한도, 보존 기간, 버전 기록, 접근 제어, 워터마크 제거를 함께 포함합니다: