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

# Make 연동 팁 & 함정

> 매직밀키트 모듈로 Make 시나리오를 만들 때 사용하세요 — 모듈 찾기, 요청 타임아웃 설정, 중복 실행 방지, 노션 rate limit 준수.

매직밀키트 모듈을 Make에서 사용할 때 가장 흔한 문제를 예방하는 몇 가지 방법입니다.

## 모듈 찾기

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

## 타임아웃과 재시도

노션 등록이 실패하면 매직밀키트 서버는 포기하기 전에 **내부적으로 재시도**합니다. 이
재시도가 오래 걸리면 Make 모듈이 시간 제한에 걸려 **타임아웃**으로 나타날 수 있습니다.

<Note>
  오래 걸리는 요청에는 **타임아웃**을 명시적으로 설정하고(보통 수 초), 각 호출을 제한 범위
  내로 유지하세요 — 벌크 작업은 **호출당 100건 이하**로 유지합니다.
</Note>

## 중복 실행 방지

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

## 노션 rate limit 준수

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

## 마크다운 콘텐츠

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