{
  "id": "4f9aaaea-dc74-4eff-adfe-d346cb24df42",
  "slug": "ref/manual/content-launcher-콘텐츠-런처-notion",
  "doc_type": "ref",
  "title": "Notion — Content Launcher (콘텐츠 런처)",
  "title_en": null,
  "one_liner": " Notion 개요 — Notion 위키 발행 노션 \\ \\ 데이터베이스(DB)\\ \\ 에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다. 발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대",
  "summary_bullets": [],
  "body_md": "# Notion\n\n**개요 — Notion 위키 발행**\n\n노션 \\*\\*데이터베이스(DB)\\*\\*에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다.\n\n발행하려면 세 가지가 필요합니다: ① **통합 토큰** ② **대상 DB를 통합에 연결(공유)** ③ **database\\_id**. 아래 \\[토큰 발급 · DB 연결 · DB ID 확인]을 따라 설정하세요.\n\n**필수 필드 — 필수 필드**\n\n* **notion\\_token** — 통합 시크릿. `ntn_` 또는 `secret_` 로 시작합니다.\n* **database\\_id** — 발행 대상 노션 데이터베이스 ID(32자리).\n* **category\\_prop** (선택) — 카테고리를 기록할 DB 속성명(예: `분류`, `태그`).\n\n**토큰/인증 발급 — 토큰 발급 · DB 연결 · DB ID 확인**\n\n### 1) 통합 토큰 발급\n\n1. **https://www.notion.so/my-integrations** 접속 (또는 노션 좌하단 **설정 → Connections → 통합 개발/관리**)\n2. 기존 통합 선택, 또는 **+ New integration**으로 생성(워크스페이스 선택, Capabilities에 **Read content + Insert content** 체크)\n3. **Configuration** 탭 → **Internal Integration Secret** → **Show → Copy** → `notion_token`에 입력 (`ntn_…`)\n\n### 2) 통합을 대상 DB에 연결(공유) — 필수\n\n> 통합이 그 DB에 접근 권한이 없으면 토큰이 맞아도 **404**가 납니다.\n\n1. 발행할 **데이터베이스를 full page로 열기**\n2. 우측 상단 **···(More) → Connections(연결)** → 위에서 만든 통합 선택해 추가\n\n### 3) database\\_id 확인 (URL에서)\n\n* 데이터베이스를 full page로 연 상태의 주소창 URL: `https://www.notion.so/{워크스페이스}/{32자리DB ID}?v={뷰ID}`\n* **`?v=` 바로 앞 32자리**가 database\\_id 입니다(대시 없어도 됨).\n* ⚠️ URL에 **`?v=` 가 있어야 데이터베이스**입니다. 없으면 _페이지_ ID라 발행이 안 됩니다.\n* **인라인 데이터베이스**는 제목 옆 **⤢(open as full page)** 로 펼친 뒤 URL을 확인하세요.\n\n### 4) 입력 · 확인\n\n* 연결 정보 탭에 `notion_token` · `database_id` · (선택)`category_prop` 입력 → 저장.\n* 통합이 보는 DB가 맞는지 확실치 않으면, 대상 DB를 2)처럼 연결했는지 다시 확인하세요.\n\n**자주 발생하는 오류 — 자주 발생하는 오류**\n\n* **404 object\\_not\\_found / Could not find database** — 통합이 그 DB에 **공유되지 않음**(2단계 누락), 또는 _페이지_ ID를 넣음(데이터베이스 ID 필요 — URL의 `?v=` 확인).\n* **401 unauthorized / API token is invalid** — 토큰 오류·만료. my-integrations에서 시크릿 재확인.\n* **category\\_prop이 반영 안 됨** — DB에 그 속성명이 없거나 타입 불일치. DB 속성명을 정확히(대소문자) 입력.\n\n**권장 사항 — 권장 사항**\n\n* **데이터베이스 ID**를 사용하세요(페이지 ID 아님) — URL의 `?v=` 앞 32자리.\n* 통합 Capabilities에 **Insert content** 포함.\n* 노션 위키는 **대표(특성)이미지·CTA를 사용하지 않고**, 3줄 요약·FAQ·도입부 인포그래픽은 본문에 포함됩니다.\n",
  "related_slugs": [],
  "faq": [],
  "jsonld": null,
  "keywords": [],
  "source_id": "gitbook:UzjWwGASsQFDcNaCAGUu:EJCLcwCRJh2xY9umFfwI",
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "image_url": null,
  "caption": null,
  "solution_slug": null,
  "captured_at": null,
  "width": null,
  "height": null,
  "created_at": "2026-08-23T14:32:39.611542+00:00",
  "updated_at": "2026-08-23T14:32:39.611542+00:00",
  "visibility": "public",
  "source_stage": "1",
  "anonymized": true,
  "source_key": "gitbook-manuals",
  "origin": "ingest",
  "locked": false,
  "locked_by": null,
  "locked_at": null,
  "gate_state": {
    "g1": {
      "hits": [],
      "pass": true
    },
    "g2": {
      "pass": true,
      "total": 42,
      "issues": [
        "숫자·규격 같은 검증 가능한 구체가 부족합니다",
        "핵심 요약 불릿이 3개 미만입니다",
        "Q&A 쌍이 3개 미만입니다"
      ],
      "applies": true
    },
    "g3": {
      "pass": true,
      "required": false
    },
    "stage": "1",
    "decided_at": "2026-08-23T14:32:37.773Z"
  },
  "raw_id": "fa636bec-d300-498d-8000-0a8b9d22cf02",
  "search_text": "Notion — Content Launcher (콘텐츠 런처)   Notion 개요 — Notion 위키 발행 노션 \\ \\ 데이터베이스(DB)\\ \\ 에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다. 발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대  # Notion\n\n**개요 — Notion 위키 발행**\n\n노션 \\*\\*데이터베이스(DB)\\*\\*에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다.\n\n발행하려면 세 가지가 필요합니다: ① **통합 토큰** ② **대상 DB를 통합에 연결(공유)** ③ **database\\_id**. 아래 \\[토큰 발급 · DB 연결 · DB ID 확인]을 따라 설정하세요.\n\n**필수 필드 — 필수 필드**\n\n* **notion\\_token** — 통합 시크릿. `ntn_` 또는 `secret_` 로 시작합니다.\n* **database\\_id** — 발행 대상 노션 데이터베이스 ID(32자리).\n* **category\\_prop** (선택) — 카테고리를 기록할 DB 속성명(예: `분류`, `태그`).\n\n**토큰/인증 발급 — 토큰 발급 · DB 연결 · DB ID 확인**\n\n### 1) 통합 토큰 발급\n\n1. **https://www.notion.so/my-integrations** 접속 (또는 노션 좌하단 **설정 → Connections → 통합 개발/관리**)\n2. 기존 통합 선택, 또는 **+ New integration**으로 생성(워크스페이스 선택, Capabilities에 **Read content + Insert content** 체크)\n3. **Configuration** 탭 → **Internal Integration Secret** → **Show → Copy** → `notion_token`에 입력 (`ntn_…`)\n\n### 2) 통합을 대상 DB에 연결(공유) — 필수\n\n> 통합이 그 DB에 접근 권한이 없으면 토큰이 맞아도 **404**가 납니다.\n\n1. 발행할 **데이터베이스를 full page로 열기**\n2. 우측 상단 **···(More) → Connections(연결)** → 위에서 만든 통합 선택해 추가\n\n### 3) database\\_id 확인 (URL에서)\n\n* 데이터베이스를 full page로 연 상태의 주소창 URL: `https://www.notion.so/{워크스페이스}/{32자리DB ID}?v={뷰ID}`\n* **`?v=` 바로 앞 32자리**가 database\\_id 입니다(대시 없어도 됨).\n* ⚠️ URL에 **`?v=` 가 있어야 데이터베이스**입니다. 없으면 _페이지_ ID라 발행이 안 됩니다.\n* **인라인 데이터베이스**는 제목 옆 **⤢(open as full page)** 로 펼친 뒤 URL을 확인하세요.\n\n### 4) 입력 · 확인\n\n* 연결 정보 탭에 `notion_token` · `database_id` · (선택)`category_prop` 입력 → 저장.\n* 통합이 보는 DB가 맞는지 확실치 않으면, 대상 DB를 2)처럼 연결했는지 다시 확인하세요.\n\n**자주 발생하는 오류 — 자주 발생하는 오류**\n\n* **404 object\\_not\\_found / Could not find database** — 통합이 그 DB에 **공유되지 않음**(2단계 누락), 또는 _페이지_ ID를 넣음(데이터베이스 ID 필요 — URL의 `?v=` 확인).\n* **401 unauthorized / API token is invalid** — 토큰 오류·만료. my-integrations에서 시크릿 재확인.\n* **category\\_prop이 반영 안 됨** — DB에 그 속성명이 없거나 타입 불일치. DB 속성명을 정확히(대소문자) 입력.\n\n**권장 사항 — 권장 사항**\n\n* **데이터베이스 ID**를 사용하세요(페이지 ID 아님) — URL의 `?v=` 앞 32자리.\n* 통합 Capabilities에 **Insert content** 포함.\n* 노션 위키는 **대표(특성)이미지·CTA를 사용하지 않고**, 3줄 요약·FAQ·도입부 인포그래픽은 본문에 포함됩니다.\n",
  "embedding": null,
  "embedded_at": null,
  "embedding_hash": null,
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-notion",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-notion.md"
}