Notion Setup Skill

Notion API 토큰을 설정하고 연결을 검증합니다. 모든 Notion 스킬의 사전 요구 사항입니다.

Workflow

Step 1: 토큰 확인

사용자에게 Notion Integration Token을 요청합니다:

🔑 Notion Integration Token이 필요합니다.
https://www.notion.so/my-integrations 에서 생성할 수 있습니다.

토큰을 입력해주세요:

Step 2: 토큰 저장 및 연결 테스트

사용자가 토큰을 제공하면, 아래 명령으로 저장 및 테스트를 수행합니다:

PYTHONDONTWRITEBYTECODE=1 uv run --with notion-client python .claude/skills/notion-setup/scripts/setup.py --save <<'TOKEN_JSON'
{"token": "사용자_토큰"}
TOKEN_JSON

Step 3: 결과 보고

• 성공: {"success": true, "user": "...", "workspace": "..."} 반환 → 연결 성공 메시지 출력
• 실패: {"success": false, "error": "..."} 반환 → 에러 메시지 전달

연결 상태 확인 (토큰 저장 없이)

이미 설정된 토큰의 연결 상태만 확인하려면:

PYTHONDONTWRITEBYTECODE=1 uv run --with notion-client python .claude/skills/notion-setup/scripts/setup.py --test

토큰 재설정

기존 토큰을 새 토큰으로 교체하려면 Step 2와 동일하게 --save를 사용합니다. 기존 토큰은 덮어쓰기됩니다.

사용 예시

사용자: 노션 설정해줘
AI: 🔑 Notion Integration Token이 필요합니다. 토큰을 입력해주세요.
사용자: ntn_abc123...
AI: ✅ 연결 성공! 워크스페이스: My Workspace, 사용자: John Doe

저장 위치

• 토큰: ~/.notion-skills/.env (NOTION_TOKEN=...)
• 이 파일은 모든 Notion 스킬(notion-config, notion-update, notion-search)에서 공유됩니다.

멀티 토큰 (data_type별 별도 Integration)

이 스킬은 기본 NOTION_TOKEN만 다룹니다. 일부 DB가 별도 Integration으로 연결되는 경우(예: tickets DB가 다른 토큰을 사용), 추가 토큰은 notion-config add 시 --token-env/--token-value 옵션으로 등록합니다. 자세한 사용법은 notion-config SKILL.md 참조.

Important Rules

• 시크릿 보호: 토큰은 반드시 stdin JSON으로 전달 (bash 명령줄에 노출 금지)
• 글로벌 저장소: ~/.notion-skills/.env에 저장하여 모든 스킬에서 공유
• 커밋 금지: .env 파일은 절대 git에 커밋하지 않음