시작하기

빠른 시작

가입 후 비공개 미리보기 URL까지 5분이면 됩니다.

이 페이지에서는 새로 가입하여 비공개 미리보기 URL로 이동할 수 있습니다. 2단계에는 두 가지 경로가 있습니다. 보유하고 있는 것과 일치하는 경로를 선택하세요.

1. 작업 공간 만들기

/login에서 로그인하세요. 이메일 + 비밀번호, GitHub, Google의 세 가지 로그인 방법이 지원됩니다. 처음 로그인하면 귀하의 계정 이름을 딴 작업 공간이 제공됩니다. 나중에 작업공간 설정에서 이름을 바꿀 수 있습니다.

새 워크스페이스는 라이브 사이트와 에이전트 연결을 무제한으로 제공하는 Free 요금제로 시작합니다. 이 구성만으로도 빠른 시작 과정을 끝까지 진행할 수 있습니다. 현재 크레딧, 도메인, 기능 차이는 가격 페이지를 참조하세요.

2. 사이트 가져오기 - 하나 선택

템플릿에서 시작하거나(저장소 필요 없음) 기존 GitHub 저장소에 연결할 수 있습니다.

A. 템플릿에서 시작(빠름, GitHub 아님)

/onboarding/from-template을 엽니다. 오늘 5개의 스타터가 배송됩니다.

  • SaaS 랜딩 — 단일 페이지 마케팅 사이트(Next.js)
  • 문서 사이트 — 마크다운 기반 문서 페이지(Next.js)
  • 포트폴리오 — 약 + 프로젝트 섹션이 있는 개인 사이트(Next.js)
  • Astro docs — 콘텐츠 우선 문서 시작 프로그램(Astro)
  • Vite + React 랜딩 — 단일 페이지 앱 셸(Vite + React)

하나를 선택하고 변수 양식(site_slug, 프로젝트 및 템플릿별 노브)을 작성한 후 제출하세요. Showly 사이트를 생성하고 템플릿 파일을 구체화한 후 첫 번째 빌드를 시작합니다. 빌드 상태가 표시되는 새 사이트의 세부정보 페이지로 이동하게 됩니다.

이 경로는 미리보기 URL에 대한 가장 빠른 방법입니다. GitHub OAuth 없음, 설치 없음, 웹후크 대기 없음.

B. 저장소 연결

워크스페이스 홈에서 사이트 연결을 클릭하고 GitHub 저장소를 등록하세요. 처음 연결하면 GitHub에서 Showly GitHub 앱을 승인하라는 메시지가 표시됩니다. 보조금에 적용되는 내용은 첫 번째 사이트를 참조하세요. 승인되면 Showly의 가져오기 단계에서는 요청 시 저장소 메타데이터(package.json, 잠금 파일 및 프레임워크 힌트)를 읽어 다음을 수행합니다.

  • 프레임워크 감지(Astro, Vite, Next.js 내보내기 또는 정적 HTML)
  • 빌드 명령 및 출력 디렉터리 제안

제안된 매니페스트를 확인합니다. 계속하기 전에 모든 필드를 재정의할 수 있습니다.

두 경로는 모두 3단계에서 수렴됩니다.

3. 에이전트 연결(선택사항이지만 권장)

에이전트에 Showly MCP 서버를 등록합니다.

npx @showly/mcp-server install --to claude-code   # or --to codex

이것이 전체 설정입니다. 복사할 토큰이 없습니다. Showly 도구를 처음 호출하면 에이전트가 브라우저 탭을 열어 로그인하고 액세스를 승인합니다. Showly 그런 다음 범위가 지정된 토큰을 에이전트에 직접 발급합니다. 인증 핸드셰이크 작동 방식과 브라우저 없음 폴백에 대해서는 스킬 설치를 참조하세요.

이제 에이전트에게 프로덕션 자격 증명을 제공하지 않고도 Claude Code 또는 Codex에 사이트 컨텍스트를 읽고, 변경 계획을 제안하고, 미리보기를 생성하도록 요청할 수 있습니다.

4. 첫 번째 변경

Showly 채팅 패널이나 상담원으로부터 다음과 같이 말합니다.

홈페이지 영웅 헤드라인을 '의식 없이 배송'으로 변경

상담원은 다음을 수행합니다.

  1. get_site_context를 호출하여 관련 파일을 읽습니다.
  2. create_change_plan 제안서를 작성합니다.
  3. apply_site_patch를 호출하여 Showly 관리 작업공간에서 편집 내용을 준비합니다.
  4. create_preview를 호출하여 미리보기 URL을 만들고 생성합니다.

빌드가 완료되면(보통 90초 미만) 채팅에 미리보기 URL이 표시됩니다.

5. 승인 및 게시

미리보기 URL을 엽니다. 차이점을 검토하세요. 준비가 되면 게시 요청을 클릭하세요. 이렇게 하면 미리 보기가 프로덕션으로 승격되기 전에 소유자나 관리자가 승인해야 하는 보류 중인 승인 요청이 생성됩니다.

승인 후 Showly는 미리보기 아티팩트를 프로덕션으로 승격합니다. 릴리스 패널에 새로운 라이브 URL이 표시됩니다.

다음은 무엇입니까?