자주 생기는 문제 해결

예상대로 작동하지 않나요? 아래에서 겪고 있는 문제를 찾아보세요. 문제마다 무슨 일이 일어나고 있는지, 어떻게 해야 하는지 안내합니다. 여기서 해결되지 않으면 문제를 신고하세요. MonstarX가 화면을 자동으로 캡처하므로 팀이 내가 본 것을 그대로 확인할 수 있습니다.

빌드가 느리거나 멈춘 것 같을 때

작은 변경은 1~2분, 완전히 새로운 앱은 보통 몇 분 걸립니다. MonstarX가 작업하는 동안 대화에는 작업 구간마다 시계와 함께 실시간 진행 줄이 표시됩니다. 볼 수 있는 페이지가 생기기 전까지는 미리보기에 지금 하고 있는 일을 보여 주는 상태 카드가 표시됩니다(예: “코드 작성 중… · 파일 7개”). 이 줄이 계속 바뀐다면 빌드는 진행 중입니다. 빌드 지켜보기를 참고하세요.

이렇게 해 보세요.

• 원한다면 탭을 닫아도 됩니다. 빌드는 브라우저가 아니라 MonstarX에서 실행됩니다. 알림을 켜 두면 완료되었을 때 알려 줍니다.
• 대기열을 확인하세요. 요청은 차례대로 처리됩니다. 다른 빌드가 진행 중일 때 보낸 만들기 요청은 프롬프트 입력란 위의 다음 아래에서 기다렸다가 자동으로 시작됩니다. 대기열 중지됨이 표시되면(예: 중지를 누른 뒤) 재개를 클릭하세요. 대기열을 참고하세요.
• 응답이 없는 모델은 자동으로 처리됩니다. 모델이 응답을 멈추면 MonstarX가 작업을 다른 모델로 넘깁니다. 이때 대화에는 “… 모델의 응답이 중단되어 … 모델로 계속 진행합니다.”라고 표시됩니다.
• 오래 기다려도 아무 변화가 없나요? 중지를 클릭한 다음 요청을 다시 보내거나, 모델 선택에서 다른 모델을 고르세요.

“MonstarX가 요청당 최대 단계 수인 …단계 후에 멈췄습니다”

요청 하나가 진행할 수 있는 단계 수에는 한도가 있습니다. 아주 큰 요청은 작업을 마치기 전에 이 한도에 도달할 수 있습니다. 지금까지의 작업은 모두 저장됩니다. 계속(계획한 기능이 남아 있으면 계속 만들기)을 클릭하면 멈춘 지점부터 이어서 진행합니다. 기능 계획을 참고하세요.

“이 작업 도중 MonstarX가 다시 시작되었습니다”

요청을 처리하는 동안 MonstarX가 업데이트되었다는 뜻입니다. MonstarX가 마지막 단계부터 스스로 이어서 진행하므로 따로 할 일은 없습니다. 대신 “MonstarX가 이 요청의 처리를 시작하지 못했습니다”가 보이면 요청을 다시 보내세요.

미리보기가 비어 있거나, 절전 상태이거나, 오류가 표시될 때

1. “미리보기가 절전 상태입니다”: 미리보기는 20분 동안 사용하지 않으면 멈추고, 페이지의 저장된 사본을 보여 줍니다. 작업 공간 위로 마우스를 움직이거나, 사본의 아무 곳이나 클릭하거나, 지금 활성화를 클릭하세요. 몇 초 안에 다시 시작됩니다.

2. “미리보기 시작 중…”: 처음 시작할 때는 프로젝트용 보안 클라우드 컴퓨터를 준비하고 앱에 필요한 것을 설치합니다. 1분 정도 걸릴 수 있습니다.

3. “페이지가 렌더링되지 않습니다” 또는 “페이지 복구 중…”: 지금 이 순간 페이지가 비어 있거나 오류가 있다는 뜻입니다. 빌드가 페이지를 작성하는 도중인 경우가 많습니다. 코드가 다시 작동하면 MonstarX가 바로 자동으로 새로고침합니다.

4. 여전히 비어 있거나 최신 상태가 아닌가요? 미리보기 도구 모음의 미리보기 새로고침을 클릭하세요. 그래도 해결되지 않으면 개발 서버 다시 시작을 클릭하세요(휴대폰에서는 ••• 메뉴 → 개발 서버 다시 시작).

5. “새로고침으로 해결되지 않았습니다”: 앱 자체에 버그가 있다는 뜻입니다. 아래쪽에 페이지의 오류 내용이 표시됩니다. 대화에서 요청하세요. 예: “홈 페이지가 비어 있어요. 고쳐 주세요.” 대화에서 수정되면 자동으로 반영됩니다.

보기 권한으로 공유받은 프로젝트라면 미리보기를 새로고침할 수 있습니다. 계속 실패하면 소유자에게 다시 시작해 달라고 요청하세요. 자세한 내용은 미리보기를 참고하세요.

‘오류가 발생했습니다’가 표시될 때

이 페이지는 MonstarX가 요청한 화면을 열지 못했다는 뜻입니다.

1. 다시 시도를 클릭하세요.

2. 그래도 안 되면 페이지를 새로고침하거나, 홈을 클릭해 프로젝트 목록에서 다시 시작하세요.

3. 계속 실패한다면 인터넷 연결을 확인한 다음 문제를 신고하세요.

관련 메시지와 해결 방법:

메시지	해결 방법
“MonstarX가 업데이트되었습니다. 페이지를 새로고침하여 계속하세요.”	새로고침을 클릭하세요. 탭을 열어 둔 사이에 MonstarX의 새 버전이 나왔습니다.
“작업 중에 MonstarX가 업데이트되었습니다. 요청이 완료되었는지 확인하고, 완료되지 않았다면 다시 시도하세요.”	대화를 확인하세요. 요청이 끝나지 않았다면 다시 보내세요.
“MonstarX에 연결하지 못했습니다. 연결을 확인한 후 다시 시도하세요.”	인터넷 연결이 끊겼습니다. 다시 연결한 다음 시도하세요.
“메시지가 100,000자 한도를 …자 초과했습니다.”	메시지를 줄이세요. 한도에 가까워지면 입력란에 글자 수가 표시됩니다.
“이 모델은 현재 요금제에서 사용할 수 없습니다.”	모델 선택에서 자동이나 다른 모델을 고르세요. 프리미엄 모델은 Plus 이상 요금제에서 쓸 수 있습니다. 모델 선택하기를 참고하세요.

사용 한도에 도달했을 때

“… 요금제의 5시간 한도를 모두 사용했습니다. … 초기화됩니다.”라는 메시지가 표시됩니다(주간 한도일 때도 비슷한 메시지가 표시됩니다). 잃어버리는 작업은 없습니다. 이렇게 할 수 있습니다.

• 기다리기: 프롬프트 입력란 옆의 사용량 링을 클릭하면 각 한도가 언제 초기화되는지 볼 수 있습니다.
• Boost 사용하기: 모든 한도를 지금 바로 초기화합니다(Plus와 Pro만 해당).
• 업그레이드하기: 즉시 더 큰 한도를 받습니다.
• 프리미엄 모델 한도를 다 썼나요? 낮은 비용이나 표준 그룹의 모델을 골라 계속 만드세요.

한도에 여유가 생기면 MonstarX에 이어서 진행해 달라고 요청하세요. 사용량과 한도를 참고하세요.

계속 로그아웃되거나 로그인 화면으로 돌아갈 때

Stripe, Google, 이메일 속 링크에서 돌아오면 MonstarX가 로그인 상태를 빠르게 다시 확인하므로 페이지가 한 번 깜빡일 수 있습니다. 로그인 페이지로 계속 되돌아가거나 “로그아웃되었습니다. 이 프로젝트를 계속 보려면 다시 로그인하세요.”가 표시된다면 이렇게 해 보세요.

1. 페이지를 새로고침하세요.

2. 브라우저에서 monstarx.com의 쿠키를 허용했는지 확인하세요. 로그인하려면 쿠키가 필요합니다. 개인정보 보호 설정이 엄격하거나 광고 차단 확장 프로그램을 쓰면 쿠키가 차단될 수 있습니다.

3. 내 이름 아래 메뉴에서 로그아웃한 다음 다시 로그인하세요.

4. 시크릿 창이나 다른 브라우저에서 시도해 보세요. 그곳에서 된다면 확장 프로그램이나 브라우저 설정이 원인입니다.

비밀번호를 잊어버렸나요? 로그인 페이지에서 비밀번호를 잊으셨나요?를 클릭하세요. 프로필과 로그인을 참고하세요.

도메인이 아직 작동하지 않을 때

도메인은 brewandbean.com처럼 앱에 쓰는 전용 웹 주소입니다. 도메인 상태는 프로젝트 게시 메뉴의 도메인과 설정 → 도메인에서 확인할 수 있습니다.

상태	의미	해야 할 일
등록 중	구매한 도메인을 등록하고 설정하는 중	기다리세요. 보통 몇 분 안에 공개되며, 몇 시간 걸릴 때도 있습니다.
설정 중 / DNS를 기다리는 중	내가 가진 도메인이 아직 앱을 가리키지 않음	게시 → 도메인에 표시된 CNAME 레코드를 도메인의 DNS(주소 설정)를 관리하는 회사에 추가하세요. 변경 사항이 퍼지기까지 시간이 걸릴 수 있습니다.
인증서 발급 중	주소가 앱을 가리키고 있으며, HTTPS 자물쇠를 설정하는 중	할 일이 없습니다. 자동으로 공개됩니다.
확인 필요 / 설정 확인 필요	완료되지 않은 단계가 있음	앱 → 게시 → 도메인을 열고 설정 완료를 누르거나, 표시된 단계를 따르세요.

앱이 게시되었는지도 확인하세요. 도메인에 보여 줄 내용이 있어야 합니다. 내가 가진 루트 도메인(www.example.com이 아닌 example.com)은 DNS가 Cloudflare에 있어야 합니다. 지금 쓰는 DNS 회사를 유지하려면 대신 www를 연결하세요. 내 도메인 연결하기와 도메인 구매하기를 참고하세요.

앱에서 보낸 이메일이 도착하지 않을 때

앱은 monstarx.app의 전용 주소로 이메일(회원가입 확인, 비밀번호 재설정, 주문 영수증)을 보냅니다.

1. 프로젝트의 백엔드›이메일을 여세요. 앱이 보낸 모든 이메일이 상태와 함께 표시됩니다.

2. 목록에 없나요? 앱이 이메일을 보내지 않은 것입니다. 대화에서 요청하세요. 예: “누군가 주문하면 확인 이메일을 보내 주세요.”

3. 전송되지 않음 · 테스트 주소인가요? someone@example.com 같은 주소는 메일을 받을 수 없으므로 일부러 건너뜁니다. 실제로 쓰는 내 메일함으로 테스트하세요.

4. 실패인가요? 옆에 이유가 표시됩니다. 앱이 시간당 또는 일일 이메일 한도(목록 맨 위에 표시)에 도달했다면 기다렸다가 다시 시도하세요.

5. 전송됨인데 받지 못했나요? 받는 사람에게 스팸함이나 프로모션함을 확인해 달라고 하세요.

앱의 이메일을 참고하세요.

QA가 계속 실패할 때

자동 QA는 실제 브라우저에서 앱을 테스트합니다. 테스트가 실패하면 QA가 대화에서 무엇이 잘못되었는지 설명합니다.

• 기본적으로 QA는 보고만 합니다. MonstarX가 앱을 고치고 다시 테스트하게 하려면 이 문제 수정(또는 이 문제 …개 수정)을, 그대로 두려면 나중에를 선택하세요.
• 자동 수정(QA 설정에 있음)을 켜면 스스로 고치고 다시 테스트하지만, 크레딧을 더 사용합니다.
• “직접 확인해 주세요”: QA가 테스트하지 못한 단계가 있다는 뜻입니다. 미리보기를 열고 표시된 단계를 따라 한 다음, 무엇이 보이는지 대화에 알려 주세요.
• “…가 연결되지 않았으므로 해당 단계는 테스트되지 않았습니다”: 앱에 필요한 Stripe 같은 서비스가 아직 연결되지 않았다는 뜻입니다. QA 카드의 … 연결을 클릭하고 키를 추가한 다음 QA를 다시 실행하세요(커넥터 참고).
• “QA가 재시작으로 인해 중단되어 완료되지 않았습니다”: 상단 바의 QA를 열고 지금 QA 실행을 클릭하세요.
• “QA를 시작하지 못했습니다”: QA도 요금제 사용량을 씁니다. 한도에 도달했다면 사용 한도에 도달했을 때를 참고하세요.

QA 테스트를 참고하세요.

변경 후 앱이 망가졌다면 어떻게 되돌리나요?

MonstarX는 빌드가 코드를 바꿀 때마다 앱 코드의 버전을 저장하므로, 언제든 이전 상태로 돌아갈 수 있습니다.

1. 프로젝트 상단 바에서 버전을 클릭하세요.

2. 변경하기 전의 버전을 찾으세요. 버전마다 저장된 시각과 파일 수가 표시됩니다.

3. 복원을 클릭하고 확인하세요.

복원하면 앱의 코드가 그 버전으로 바뀝니다. 사용자, 주문, 게시물 같은 앱의 데이터는 변경되지 않습니다. 복원도 새 버전으로 저장되므로 복원한 것을 다시 되돌릴 수도 있습니다. 대화에 무엇이 잘못되었는지 말해도 됩니다. 예: “메뉴 페이지의 마지막 변경을 되돌려 주세요.” 버전을 참고하세요.

알림이 오지 않을 때

설정›알림에서 기기마다 알림을 켜고 테스트 보내기를 클릭하세요. iPhone과 iPad에서는 먼저 MonstarX를 홈 화면에 추가하고(공유 → 홈 화면에 추가) 홈 화면에서 여세요. 알림을 참고하세요.

자주 묻는 질문

MonstarX 빌드가 왜 이렇게 오래 걸리나요?

완전히 새로운 앱은 보통 몇 분 걸립니다. 대화와 상태 카드에 지금 하고 있는 일이 표시되며, 내용이 계속 바뀐다면 작업 중입니다. 탭을 닫아도 빌드는 계속되며, 알림을 켜 두면 완료되었을 때 알려 줍니다.

미리보기가 왜 비어 있나요?

대개 미리보기가 절전 상태이거나(마우스를 올리거나 지금 활성화를 클릭하세요), 빌드가 페이지를 작성하는 도중입니다(자동으로 새로고침됩니다). 그 밖의 경우에는 미리보기 새로고침, 그다음 개발 서버 다시 시작을 클릭하거나, 대화에서 페이지를 고쳐 달라고 요청하세요.

변경 사항을 되돌리려면 어떻게 하나요?

프로젝트 상단 바에서 버전을 클릭하고, 변경하기 전의 버전을 찾아 복원을 클릭하세요. 앱 데이터에는 영향이 없습니다.

실패한 빌드도 크레딧을 사용하나요?

네. 멈추기 전까지 한 AI 작업만큼 사용합니다. 작업은 저장되므로 이어서 진행해도 같은 작업을 다시 하지 않습니다.

여기서 해결되지 않으면 어디에 연락하나요?

루나에게 물어보기에서 문제를 신고하거나(스크린샷으로 버그 신고), 내 이름 아래 메뉴의 지원에서 티켓을 만드세요. 문제 신고를 참고하세요.

관련 페이지

문제 신고스크린샷이 담긴 버그 신고 보내기, 티켓 만들기

사용량과 한도한도에 도달하면 어떻게 되는지

버전앱의 이전 버전으로 언제든 돌아가기

미리보기실시간 미리보기의 작동, 절전, 다시 시작