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

# 노션 커넥션 & 권한 에러 해결하기

> 노션 모듈이 401 또는 권한 에러로 실패할 때 사용하세요 — 노션 인티그레이션에 페이지/데이터베이스 접근 권한을 부여하고 Make 커넥션을 다시 설정합니다.

가장 흔한 노션 문제는 **권한 에러**입니다. 토큰은 정상인데, 자동화하려는 **특정 페이지나
데이터베이스에 접근 권한이 부여되지 않은** 경우입니다. 토큰 발급은 설정의 절반일 뿐입니다.

## 이럴 때 사용하세요

<Warning>
  **증상:** 토큰이 올바른 것 같은데도 노션 모듈이 **`401`**, 권한 에러, 또는 "커넥션 페이지에
  권한이 없습니다" 와 같이 실패합니다.
</Warning>

## 해결 방법

<Steps>
  <Step title="노션 인티그레이션 토큰 생성">
    노션에서 내부 인티그레이션을 만들고 토큰을 복사합니다. 이 값이 Make 커넥션의
    **Notion Token** 필드에 들어갑니다.
  </Step>

  <Step title="페이지/데이터베이스에 인티그레이션 권한 부여">
    **자동화하려는 페이지 또는 데이터베이스**를 열고, **연결(Connections)** 메뉴에서
    인티그레이션을 추가합니다(우측 상단 **•••** → **연결** → 인티그레이션 추가). 하위
    페이지가 권한을 상속하도록 **최상단** 페이지/DB에 추가해 주세요.

    <Note>
      대부분 이 단계를 빠뜨립니다. 대상 페이지에 접근 권한이 없는 토큰은 모든 호출에서
      `401` / 권한 에러를 반환합니다.
    </Note>
  </Step>

  <Step title="Make에 커넥션 등록">
    Make 노션 플러스 커넥션에 **Notion Token**(비공식 작업의 경우 **Space ID**, **User ID**
    포함)을 입력합니다. 커넥션 관리는
    [make.magicmealkits.com/connections](https://make.magicmealkits.com/connections)
    에서 합니다.
  </Step>

  <Step title="먼저 간단한 값으로 테스트">
    **간단한 텍스트** 입력으로 모듈을 실행해 커넥션이 동작하는지 먼저 확인한 뒤, 실제
    입력값으로 확장해 주세요. 권한 문제와 데이터/형식 문제를 구분할 수 있습니다.
  </Step>
</Steps>

## 그래도 실패한다면 — 커넥션 재설정

권한을 부여했는데도 계속 실패한다면 저장된 세션이 오래되었을 수 있습니다. **노션 커넥션을
다시 등록**해 주세요 — 노션에서 로그아웃한 뒤, 재연결하면서 다시 로그인합니다. 커넥션을
새로 만들면 대부분의 쿠키/세션 에러가 해소됩니다.

<Note>
  다른 매직밀키트 제품(Plaud, Tiro, 쓰레드)의 서비스별 자격 증명은 서버에 저장됩니다 — 해당
  계정은 [make.magicmealkits.com/connections](https://make.magicmealkits.com/connections)
  에서 재연결하세요. 노션은 예외로, 토큰을 요청마다 전달합니다.
  [인증](/ko/authentication)과 노션 API 개요를 참고하세요.
</Note>