notion-cv-setup

초기 설정

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

사용법

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

워크플로우

1. $ARGUMENTS에서 토큰과 URL을 파싱한다.

   • ntn_ 또는 secret_로 시작하는 값을 토큰으로 인식한다.
   • https://로 시작하는 값 또는 32자 hex 문자열을 페이지 URL/ID로 인식한다.
   • NOTION_TOKEN=, NOTION_CV_PAGE_URL= 접두사가 붙어 있으면 제거 후 값만 사용한다 (하위 호환).
   • 둘 중 하나라도 누락되면 사용법을 안내하고 중단한다.

2. 입력값을 검증한다.

   • 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를 추출할 수 없습니다." 출력 후 중단

3. 기존 .env 파일이 있는지 확인한다.

   • 이미 존재하면 "기존 .env 파일을 덮어씁니다." 라고 안내한다.

4. .env 파일을 생성한다.

   # Notion CV Page ID
   NOTION_CV_PAGE_ID=abc123def456...
   

   • 토큰은 .env에 저장하지 않는다 (MCP 설정에서 관리).

5. 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로 정상 등록 여부를 확인한다.

6. 설정 완료 메시지를 출력한다.

   • "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_****)