> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magicmealkits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 문제 해결

> 매직밀키트 배포 유지하기: Google Cloud 결제, 서비스 정지/재설치, 서버가 늦게 복구될 때 대처 방법.

아래 내용은 매직밀키트 서버가 고객님 본인의 Google Cloud 프로젝트에서 동작하기 때문에
**모든** 매직밀키트 배포(Threads, Plaud, Notion 등 전 앱)에 공통으로 적용됩니다.

**문제가 생기면 여기서 시작하세요** — 증상에 맞는 항목을 선택하세요.

### 서버가 멈췄거나 에러가 날 때

<CardGroup cols={2}>
  <Card title="평가판 종료 / 결제 활성화" icon="credit-card" href="/ko/operations/google-cloud-billing">
    Google Cloud 무료 평가판이 끝나 서버가 멈췄을 때 — 업그레이드(결제 활성화)합니다.
  </Card>

  <Card title="모듈에서 503 에러 반복" icon="triangle-exclamation" href="/ko/operations/fix-503-force-sync">
    Make 시나리오가 `503` 으로 계속 실패할 때 — 서버를 강제로 다시 활성화합니다.
  </Card>

  <Card title="노션 401 / 권한 에러" icon="lock" href="/ko/operations/notion-connection">
    노션 모듈이 `401` 또는 권한 에러로 실패할 때 — 접근 권한을 부여하고 커넥션을 다시 설정합니다.
  </Card>
</CardGroup>

### 성능 개선과 유지 관리

<CardGroup cols={2}>
  <Card title="서버가 느리거나 메모리 부족" icon="gauge-high" href="/ko/operations/upgrade-performance">
    과부하로 느릴 때 — 메모리 티어를 Free에서 Basic으로 업그레이드합니다.
  </Card>

  <Card title="Make 시나리오 만들기" icon="puzzle-piece" href="/ko/operations/make-integration-tips">
    모듈 찾기, 타임아웃 설정, 중복 실행 방지 등 Make.com 작성 팁입니다.
  </Card>

  <Card title="지원팀이 로그를 요청" icon="file-arrow-down" href="/ko/operations/share-system-logs">
    Google Cloud에서 시스템 로그를 다운로드해 지원팀에 전달합니다.
  </Card>

  <Card title="정지 또는 재설치" icon="power-off" href="/ko/operations/stop-reinstall">
    서비스를 정지하거나 재설치합니다(결제 사전 조건 포함).
  </Card>
</CardGroup>

## 서비스 유지하기

매직밀키트 서버는 **고객님 본인의 Google Cloud 프로젝트**에서 동작하며, 일반적인 사용에서는
Google Cloud 무료 사용 범위 내에서 동작하도록 설계되어 있지만 **무료 평가판은 기간 제한**이
있습니다.

<Warning>
  Google Cloud **무료 평가판**으로 시작하셨다면, 먼저 **결제 정보를 활성화(업그레이드)** 하지
  않으면 **평가판 종료 후 서버가 정지**됩니다. 단계별 안내와 요금 정보는
  [구글 클라우드 결제 활성화(업그레이드)](/ko/operations/google-cloud-billing) 페이지를
  참고하세요.
</Warning>

## 서비스 정지 또는 재설치

매직밀키트 서비스는 언제든 간편하게 정지하고 재설치할 수 있습니다.

1. [make.magicmealkits.com/google-connection](https://make.magicmealkits.com/google-connection) 에서 Google Cloud에 로그인합니다.
2. [make.magicmealkits.com/app-status](https://make.magicmealkits.com/app-status) 에 접속합니다.
3. **Stop Service** 를 클릭하고 `magic-meal-kits` 를 입력해 확인합니다.

전체 단계별 안내:
[서비스 정지 또는 재설치하기](/ko/operations/stop-reinstall).

<Warning>
  **재설치하려면 정상적인 Google Cloud 결제 정보가 필요합니다.** Google Cloud 결제 정보에
  문제가 있으면 설치가 진행되지 않습니다 — 결제 문제를 먼저 해결한 뒤 재설치하세요. 결제
  상태 확인이 어렵다면, 결제 문제를 해결한 후 **완전히 삭제하고 다시 설치**하시는 것이 가장
  깔끔합니다.
</Warning>

<Note>
  **결제 수정·재설치 후에는 20\~30분 정도 기다려 주세요 — 여러 번 재배포하지 마세요.**
  서버가 오랫동안 정지됐다가 재설치하거나 결제 정보를 수정하면, 서비스가 **바로 동작하지
  않는** 경우가 많습니다. 한동안 `503`(콜드 스타트)이나 `429`(Rate exceeded) 에러가 보일 수
  있는데, 이는 정상적인 워밍업/반영 과정으로 보통 **20\~30분 안에** 자동으로 해소됩니다.
  조금만 기다려 주세요 — 반복해서 재배포해도 더 빨라지지 않고 오히려 복구가 더 오래 걸릴 수
  있습니다.
</Note>