Claude Code + Notion MCP 서버로 개발 로그 자동화하기

1git log --oneline -10
2# 커밋 메시지들 복사해서
3# Notion 페이지 수동 작성
4# 카테고리 분류도 일일이...

"오늘 작업을 Notion에 새 로그로 정리해줘"

1{
2  "mcpServers": {
3    "notion-dev-log": {
4      "type": "stdio",
5      "command": "npx",
6      "args": ["-y", "@notionhq/notion-mcp-server"],
7      "env": {
8        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_your_token_here\", \"Notion-Version\": \"2022-06-28\"}"
9      }
10    }
11  }
12}
13

"Notion MCP 연결 테스트해줘"

1"오늘 작업한 내용을 새 Notion 로그로 만들어줘"
2"최근 버그 수정 작업을 정리해서 추가해줘"
3"새로 구현한 로그인 기능을 독립된 로그로 기록해줘"
4

1제목: "Notion MCP 설정 가이드 추가 및 기존 dev-log 규칙 제거"
2
3타입: ["Documentation", "Configuration"]
4날짜: "2025-08-03"
5상태: "완료"
6프로젝트: "crowrish-blog"
7커밋: "3c24651f6e5bfdb8ea14305656a4b178a4894c8c"
8변경 파일: [".mcp.json", "CLAUDE.md", "notion-mcp-setup-guide.md"]
9작업 시간: 2.5시간
10
11상세 내용:
12• 새 파일: notion-mcp-setup-guide.md - 설정 과정 완전 가이드
13• 수정: CLAUDE.md - 기존 bash 방식 제거
14• 추가: .mcp.json - MCP 서버 설정 완료
15
16성과:
17• bash 명령어 → 자연어 기반 로그 관리 전환 완료
18• 동료들과 공유 가능한 실용적 가이드 문서 작성
19• 표준화된 개발 로그 시스템 구축

"상세하게 분석해서 Notion에 정리해줘"
"간단하게 요약해서 기존 페이지에 업데이트해줘"
"지난 주 작업들을 프로젝트별로 나눠서 만들어줘"

1# .gitignore에 꼭 추가하세요
2.mcp.json
3
4# API 토큰 정기적으로 로테이션
5# 통합 권한도 최소한으로 설정

1## Notion MCP 개발 로그 관리
2
3- **MCP 연결**: `.mcp.json` 파일을 통한 Notion MCP 서버 연결 완료
4- **설정 가이드**: `notion-mcp-setup-guide.md` 시행착오 해결 가이드 문서화
5- **자연어 관리**: 기존 bash `dev-log` 명령어에서 자연어 기반 로그 관리로 전환
6
7### 사용 방법
8
9#### 기본 요청 방식
10
11```
12"오늘 작업 내용을 Notion MCP에 로그로 남겨줘"
13"최근 커밋들을 분석해서 개발 로그 작성해줘"
14"새로 구현한 기능을 Notion 개발 로그에 정리해줘"
15```
16
17### MCP DEV LOG 데이터베이스 스키마
18
19모든 로그 항목은 다음 속성들이 자동으로 채워집니다:
20
21- **제목** (Title): 작업 내용 요약
22- **설명** (Rich Text): 상세한 작업 설명
23- **타입** (Multi-select): Documentation, Feature, Bug Fix, Configuration 등
24- **상태** (Select): 진행중, 완료, 보류 등
25- **날짜** (Date): 작업 일자
26- **프로젝트** (Select): crowrish-blog
27- **커밋 해시** (Rich Text): Git 커밋 해시
28- **변경된 파일** (Multi-select): 수정된 파일 목록
29- **작업 시간** (Number): 예상 작업 시간 (시간)
30
31### ⚡ 자동 처리 기능
32
33Claude가 자동으로 수행하는 작업:
34
35- 최근 git 커밋 분석 및 정보 추출
36- 작업 내용 카테고리화 (이미지, 테스트, 구조 등)
37- 커밋 해시와 변경된 파일 목록 자동 입력
38- 영향도와 기능 설명 상세 작성
39- 구조화된 블록 형태로 Notion에 저장
40
41### 🚨 Notion MCP 새 페이지 생성 시 주의사항
42
43**데이터베이스에 새 페이지 생성할 때**:
44
45```json
46// ✅ 올바른 방식 - database_id를 parent로 사용
47{
48  "parent": {"database_id": "db_id"},
49  "properties": {
50    "제목": {"title": [{"text": {"content": "페이지 제목"}}]},
51    "설명": {"rich_text": [{"text": {"content": "내용"}}]},
52    "프로젝트": {"select": {"name": "프로젝트 이름"}},
53    "타입": {"multi_select": [{"name": "Feature"}]},
54    "상태": {"select": {"name": "완료"}},
55    "커밋 해시": {"rich_text": [{"text": {"content": "해시값"}}]},
56    "변경된 파일": {"multi_select": [{"name": "파일명"}]},
57    "날짜": {"date": {"start": "2025-08-04"}},
58    "작업 시간": {"number": 1.5}
59  }
60}
61```
62
63**흔한 실수들**:
64- `page_id`를 parent로 사용 → `object_not_found` 에러
65- 한국어 속성명 오타 (`제목` vs `title`)
66- 잘못된 속성 타입 사용 (select vs multi_select)

1- name: Log to Notion
2  run: |
3    curl -X POST https://api.notion.com/v1/pages \
4      -H "Authorization: Bearer ${{ secrets.NOTION_TOKEN }}" \
5      -d "$BUILD_LOG"
6