# Notion — Content Launcher (콘텐츠 런처)

>  Notion 개요 — Notion 위키 발행 노션 \ \ 데이터베이스(DB)\ \ 에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다. 발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대

## 핵심 요약


# Notion

**개요 — Notion 위키 발행**

노션 \*\*데이터베이스(DB)\*\*에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다.

발행하려면 세 가지가 필요합니다: ① **통합 토큰** ② **대상 DB를 통합에 연결(공유)** ③ **database\_id**. 아래 \[토큰 발급 · DB 연결 · DB ID 확인]을 따라 설정하세요.

**필수 필드 — 필수 필드**

* **notion\_token** — 통합 시크릿. `ntn_` 또는 `secret_` 로 시작합니다.
* **database\_id** — 발행 대상 노션 데이터베이스 ID(32자리).
* **category\_prop** (선택) — 카테고리를 기록할 DB 속성명(예: `분류`, `태그`).

**토큰/인증 발급 — 토큰 발급 · DB 연결 · DB ID 확인**

### 1) 통합 토큰 발급

1. **https://www.notion.so/my-integrations** 접속 (또는 노션 좌하단 **설정 → Connections → 통합 개발/관리**)
2. 기존 통합 선택, 또는 **+ New integration**으로 생성(워크스페이스 선택, Capabilities에 **Read content + Insert content** 체크)
3. **Configuration** 탭 → **Internal Integration Secret** → **Show → Copy** → `notion_token`에 입력 (`ntn_…`)

### 2) 통합을 대상 DB에 연결(공유) — 필수

> 통합이 그 DB에 접근 권한이 없으면 토큰이 맞아도 **404**가 납니다.

1. 발행할 **데이터베이스를 full page로 열기**
2. 우측 상단 **···(More) → Connections(연결)** → 위에서 만든 통합 선택해 추가

### 3) database\_id 확인 (URL에서)

* 데이터베이스를 full page로 연 상태의 주소창 URL: `https://www.notion.so/{워크스페이스}/{32자리DB ID}?v={뷰ID}`
* **`?v=` 바로 앞 32자리**가 database\_id 입니다(대시 없어도 됨).
* ⚠️ URL에 **`?v=` 가 있어야 데이터베이스**입니다. 없으면 _페이지_ ID라 발행이 안 됩니다.
* **인라인 데이터베이스**는 제목 옆 **⤢(open as full page)** 로 펼친 뒤 URL을 확인하세요.

### 4) 입력 · 확인

* 연결 정보 탭에 `notion_token` · `database_id` · (선택)`category_prop` 입력 → 저장.
* 통합이 보는 DB가 맞는지 확실치 않으면, 대상 DB를 2)처럼 연결했는지 다시 확인하세요.

**자주 발생하는 오류 — 자주 발생하는 오류**

* **404 object\_not\_found / Could not find database** — 통합이 그 DB에 **공유되지 않음**(2단계 누락), 또는 _페이지_ ID를 넣음(데이터베이스 ID 필요 — URL의 `?v=` 확인).
* **401 unauthorized / API token is invalid** — 토큰 오류·만료. my-integrations에서 시크릿 재확인.
* **category\_prop이 반영 안 됨** — DB에 그 속성명이 없거나 타입 불일치. DB 속성명을 정확히(대소문자) 입력.

**권장 사항 — 권장 사항**

* **데이터베이스 ID**를 사용하세요(페이지 ID 아님) — URL의 `?v=` 앞 32자리.
* 통합 Capabilities에 **Insert content** 포함.
* 노션 위키는 **대표(특성)이미지·CTA를 사용하지 않고**, 3줄 요약·FAQ·도입부 인포그래픽은 본문에 포함됩니다.


## FAQ


---
출처: https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-notion · 최종 갱신 2026-08-23T14:32:39.611542+00:00