Notion cv setup

Skill SongMarco/notion-cv-helper/skills/notion-cv-setup

Notion 토큰과 CV 페이지 URL을 인자로 받아 MCP 서버를 등록하고 .env 파일을 생성한다From its SKILL.md

Install

npx -y skills add SongMarco/notion-cv-helper --skill notion-cv-setup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.4 KB, as published. Nobody here has run it

초기 설정

인자로 전달받은 Notion 토큰과 CV 페이지 URL로 MCP 서버를 등록하고 .env 파일을 생성한다.

사용법

/notion-cv-setup ntn_xxxxx https://www.notion.so/My-CV-abc123def456

워크플로우

$ARGUMENTS에서 토큰과 URL을 파싱한다.
- ntn_ 또는 secret_로 시작하는 값을 토큰으로 인식한다.
- https://로 시작하는 값 또는 32자 hex 문자열을 페이지 URL/ID로 인식한다.
- NOTION_TOKEN=, NOTION_CV_PAGE_URL= 접두사가 붙어 있으면 제거 후 값만 사용한다 (하위 호환).
- 둘 중 하나라도 누락되면 사용법을 안내하고 중단한다.
입력값을 검증한다.
- Token: ntn_ 또는 secret_ 접두사 확인
  - 검증 실패 시: "토큰은 ntn_ 또는 secret_ 으로 시작해야 합니다." 출력 후 중단
- Page URL에서 Page ID를 추출한다:
  - URL의 경로 마지막 부분에서 32자 hex를 추출한다
  - 패턴: https://www.notion.so/... 에서 마지막 - 뒤의 hex 또는 경로 끝의 32자
  - 하이픈이 포함된 UUID 형태면 하이픈을 제거한다
  - 쿼리 파라미터(?v=... 등)는 무시한다
  - 32자 hex ID가 직접 입력된 경우도 허용한다
- 추출 실패 시: "URL에서 Page ID를 추출할 수 없습니다." 출력 후 중단
기존 .env 파일이 있는지 확인한다.
- 이미 존재하면 "기존 .env 파일을 덮어씁니다." 라고 안내한다.
.env 파일을 생성한다.
```
# Notion CV Page ID
NOTION_CV_PAGE_ID=abc123def456...
```
- 토큰은 .env에 저장하지 않는다 (MCP 설정에서 관리).
claude mcp add 명령어로 Notion MCP 서버를 등록한다.
- Bash 도구로 다음 명령어를 실행한다:
```
claude mcp add -e NOTION_TOKEN=<토큰값> notion -- npx -y @notionhq/notion-mcp-server
```
- 이미 notion MCP 서버가 등록되어 있으면 먼저 제거 후 재등록한다:
```
claude mcp remove notion 2>/dev/null; claude mcp add -e NOTION_TOKEN=<토큰값> notion -- npx -y @notionhq/notion-mcp-server
```
- 등록 후 claude mcp list로 정상 등록 여부를 확인한다.
설정 완료 메시지를 출력한다.
- "Notion MCP 서버가 등록되고 .env 파일이 생성되었습니다."
- "Notion에서 CV 페이지에 Integration 연결을 확인해 주세요."
  - 페이지 우측 상단 "..." > "Connections" > 생성한 Integration 추가
- "claude --continue로 세션을 이어가면 Notion MCP 서버가 활성화됩니다."
- "/notion-cv-read로 CV를 조회할 수 있습니다."

Notion Integration 미생성 시 안내

## Notion Integration 생성 방법

1. https://www.notion.so/profile/integrations/internal 에서 새 Integration을 생성
2. 권한: Read content, Update content, Insert content 체크
3. 생성 후 토큰(ntn_ 접두사)을 복사
4. CV 페이지에서 ... > Connections > 생성한 Integration 추가

주의사항

토큰 값을 터미널 출력이나 로그에 절대 노출하지 않는다
.env 파일의 토큰 값을 출력할 때 마스킹한다 (예: ntn_****)