> ## 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.

# 자주 묻는 질문 (FAQ)

> 매직밀키트에서 가장 많이 묻는 질문 모음 — 모듈이 안 보일 때, 노션 커넥션/권한 에러, 타임아웃·중복 실행, 커넥션 관리 위치.

커뮤니티에서 가장 자주 나오는 질문과 해결법입니다. 서버 단위 문제(503 에러, 서버 느림,
로그, 서비스 정지)는 [문제 해결](/ko/troubleshooting) 가이드를 참고하세요.

<AccordionGroup>
  <Accordion title="Make에서 노션 플러스(Notion Plus) 모듈이 안 보여요">
    두 가지를 확인해 주세요.

    * **노션 플러스는 Pro 기능입니다.** **Pro** 라이선스가 필요하니, 배포에 Pro 라이선스가
      적용되어 있는지 확인해 주세요.
    * **노션 플러스 앱을 추가하고 커넥션을 설정하세요.** 노션 플러스 커스텀 앱을 추가하고
      연결하면 Make에 모듈이 나타납니다. 커넥션 설정·확인은
      [make.magicmealkits.com/connections](https://make.magicmealkits.com/connections)
      에서 진행해 주세요.

    <Note>
      **벌크노션(Bulk Notion)은 별도 상품입니다.** 노션 템플릿 업데이트를 직접 자동화하는
      서비스로, 매직밀키트 설치나 Make 연동이 **필요하지 않습니다** — 따라서 Make 모듈로는
      나타나지 않습니다.
    </Note>
  </Accordion>

  <Accordion title="노션 호출이 401 / 권한 에러로 실패해요">
    가장 흔한 원인은, 자동화하려는 **페이지나 데이터베이스에 노션 인티그레이션 권한이
    부여되지 않은** 경우입니다. 토큰을 발급하는 것만으로는 부족하며, 해당 페이지/DB에
    인티그레이션을 직접 추가해야 합니다.

    전체 단계별 해결: [노션 커넥션 & 권한 에러 해결하기](/ko/operations/notion-connection).
  </Accordion>

  <Accordion title="노션 등록이 자꾸 타임아웃되거나 시나리오가 두 번 실행돼요">
    서로 다른 두 가지 현상입니다.

    * **타임아웃.** 노션 등록이 실패하면 매직밀키트 서버가 **내부적으로 재시도**합니다. 이
      재시도가 Make 모듈의 시간 제한을 초과하면 타임아웃으로 나타날 수 있습니다. 요청
      **타임아웃**을 명시적으로 설정하고 입력값을 제한 범위 내로 유지해 주세요.
    * **중복 실행.** Make의 **"allow storing of incomplete executions"** 옵션은 실패한
      시나리오를 재실행하므로 중복 등록처럼 보일 수 있습니다. 반복이 보이면 이 설정을
      확인해 주세요.

    자세한 내용: [Make 연동 팁 & 함정](/ko/operations/make-integration-tips).
  </Accordion>

  <Accordion title="커넥션이 갑자기 쿠키 또는 인증 에러를 내요">
    쿠키/세션 형식은 시간이 지나면 바뀔 수 있습니다. 커넥션이 쿠키 또는 인증 에러로 실패하기
    시작하면 **커넥션을 다시 등록(재연결)** 해 주세요 — 대부분 이렇게 해결됩니다. 노션의
    경우, Make 노션 커넥션을 다시 설정(노션 로그아웃 후 재연결하며 로그인)하면 해결됩니다.
    커넥션 관리는
    [make.magicmealkits.com/connections](https://make.magicmealkits.com/connections)
    에서 합니다.
  </Accordion>

  <Accordion title="커넥션은 어디서 관리하나요?">
    커넥션 설정과 관리는
    [make.magicmealkits.com/connections](https://make.magicmealkits.com/connections) 로
    일원화되어 있습니다. 배포의 API URL과 키도 여기(및 App Status 페이지)에 표시되며, 직접
    입력하실 필요가 없습니다. [인증](/ko/authentication)을 참고하세요.
  </Accordion>

  <Accordion title="서버가 멈췄거나, 느리거나, 로그가 필요해요">
    문제 해결 가이드에서 다룹니다.

    <CardGroup cols={2}>
      <Card title="503 에러 반복" icon="triangle-exclamation" href="/ko/operations/fix-503-force-sync" />

      <Card title="느림 / 메모리 부족" icon="gauge-high" href="/ko/operations/upgrade-performance" />

      <Card title="시스템 로그 공유" icon="file-arrow-down" href="/ko/operations/share-system-logs" />

      <Card title="정지 또는 재설치" icon="power-off" href="/ko/operations/stop-reinstall" />
    </CardGroup>
  </Accordion>
</AccordionGroup>