📝
Notion 발급 가이드
난이도⭐⭐☆☆☆
💡 Notion 연동이란?
회의록 / 메모 / 위키를 Notion에 자동 백업 + 검색까지 가능해요. 팀 협업 / 학습 기록 / 독서 노트 같은 용도에 진짜 좋아요.
Notion Integration 생성
notion.so/my-integrations 접속 → "+ New integration" 클릭.
Name 입력 (예: MyApp Bot) → Workspace 선택 → "Submit".
Internal Integration Token 복사
생성 완료 후 "Internal Integration Token"이 표시돼요 (secret_... 형식).
Database 생성 (없으면)
Notion에서 새 페이지 → "/database" 입력 → "Database - Full page" 선택.
저장할 항목별로 Property 추가:
Name(Title) — 기본날짜(Date)카테고리(Select)참석자(Rich text) 등
⭐ Database를 Integration에 공유
이 단계가 가장 중요해요! 안 하면 404 에러.
Database 페이지 우상단 "..." (점 3개) → "Connect to" 또는 "+ Add connections" → 본인 Integration 선택.
Database ID 추출
Database 페이지 URL 복사:
https://notion.so/myworkspace/abc123def456ghi789jkl012mno345pq?v=...
└─────── Database ID ─────────┘32자 hex 부분 (하이픈 있어도 OK). ?v= 이후는 제거.
Foundry 환경변수 입력
발급 받은 정보 입력:
NOTION_API_TOKEN=secret_...NOTION_DATABASE_ID=abc123def456...
❓ 자주 묻는 질문
'object_not_found' 에러가 나요
Database를 Integration에 공유 안 했어요. Step 4 다시 확인 → "Connect to" → Integration 선택.
Property 이름 매칭 에러가 나요
코드에서 사용하는 property 이름이 Database의 실제 이름과 정확히 일치해야 해요. 대소문자 / 공백 / 한글 모두 정확히!
Database ID는 어디서 찾나요?
Database 페이지 URL에서 32자 hex 부분 (workspace 이름 뒤).
?v= 이후는 빼고 복사.여러 Database 동시 연동 가능?
가능! Integration 1개로 여러 Database 연동 가능 — 각 Database마다 "Connect to" 추가 필요.