메인 콘텐츠로 건너뛰기
매직밀키트 모듈을 Make에서 사용할 때 가장 흔한 문제를 예방하는 몇 가지 방법입니다.

모듈 찾기

  • 노션 플러스는 Pro 기능입니다Pro 라이선스가 필요합니다. Make에서 모듈이 보이지 않으면 노션 플러스 앱이 추가되고 커넥션이 설정되었는지도 확인해 주세요.
  • 모든 커넥션 설정·관리는 make.magicmealkits.com/connections 에서 합니다.

타임아웃과 재시도

노션 등록이 실패하면 매직밀키트 서버는 포기하기 전에 내부적으로 재시도합니다. 이 재시도가 오래 걸리면 Make 모듈이 시간 제한에 걸려 타임아웃으로 나타날 수 있습니다.
오래 걸리는 요청에는 타임아웃을 명시적으로 설정하고(보통 수 초), 각 호출을 제한 범위 내로 유지하세요 — 벌크 작업은 호출당 100건 이하로 유지합니다.

중복 실행 방지

Make의 “allow storing of incomplete executions” 옵션은 실패한 시나리오를 재실행합니다. 위의 서버 측 재시도와 겹치면 중복 등록처럼 보일 수 있습니다. 반복이 보이면 시나리오의 이 설정을 확인하고, 실패 시 재실행이 의도한 동작인지 판단하세요.

노션 rate limit 준수

노션 플러스 모듈은 약 초당 3회 요청으로 제한됩니다(노션 자체 API와 동일). 이 한도를 넘어서는 병렬 분기를 만들지 말고, 스로틀링하거나 배치로 묶어 주세요. 벌크 제한과 선택적 config 블록은 노션 API 개요를 참고하세요.

마크다운 콘텐츠

노션 Rich Text 블록은 블록당 2,000자 제한이 있어, 매직밀키트는 긴 마크다운을 변환할 때 여러 블록으로 분할합니다. RawRefined 출력은 길이/표현이 미묘하게 다를 수 있으니, 용도에 맞는 것을 선택하세요. 자세한 내용은 노션 API 개요를 참고하세요.