공부하는 바이브 코딩 with 클로드 코드 - Ch8 - (1)
Claude Code에 노션(Notion) MCP 연동하기!
안녕하세요, 앵그리비버입니다! 👋
MCP 연결을 안하고 클로드 코드를 사용하는 분은 없겠지만 책의 마지막 챕터를 정리해봅니다. Claude Code와 MCP(Model Context Protocol) 연결인데요! 너무 쉬워서 이렇게 까지 쉬우면 안 사용할 이유가 없지 않나 싶네요.
결론부터 말씀드리면... 생각보다(?), 생각만큼(?) 참 쉽습니다~! 🎉
스마트하게 터미널 명령 한 줄로 노션을 연결하고, 클릭 몇 번 만에 로그인 인증까지 끝내는 과정을 스크린샷과 함께 알려드릴게요!
1단계: 터미널에서 노션 MCP 서버 등록하기
Claude Code를 실행 전에 터미널에서 바로 CLI 명령어로 노션 MCP 서버 URL을 등록해 줍니다.
claude mcp add --transport http notion https://mcp.notion.com/mcp
스크린샷에서 보시는 것처럼 터미널에 이 한 줄만 똭! 입력하고 엔터를 누르면 준비 완료입니다.
2단계: /mcp 메뉴로 인증(Authentication) 진행하기
Claude Code 실행 화면에서 /mcp를 입력하면 연동된 MCP 서버 목록이 나와요. 처음 연동할 때는 notion · △ needs authentication 상태로 뜹니다.
1번 Authenticate를 선택해 주면 브라우저가 자동으로 열리면서 노션 OAuth 인증 페이지로 연결됩니다!
3단계: 브라우저에서 워크스페이스 권한 승인
브라우저가 짠 하고 열리면 노션 로그인 화면이 나와요. 저는 평소 쓰는 구글 계정으로 로그인했습니다. 로그인 후에는 Connect with Notion MCP 권한 부여 창이 뜨는데요.
- 내 노션 데이터베이스 및 페이지 접근 권한 확인
http://localhost:54592/callback리다이렉트 URL 동의 체크- 아래 Continue 버튼 클릭!
승인이 완료되면 브라우저에 Authentication Successful 문구가 뜨고, 다시 터미널로 돌아오면 끝입니다!
4단계: 연결 완료 확인하기!
다시 Claude Code 터미널에서 /mcp를 확인해보니...
Notion MCP Server - Status: ✓ connected / Auth: ✓ authenticatedTools: 14 tools
와... 노션 검색, 페이지 생성, 블록 추가 등 14개 도구가 자동으로 Claude Code에 세팅되었습니다!
처음엔 OAuth 설정에서 막히면 어쩌나 걱정했는데, 막상 해보니 3분도 안 걸렸네요. 개발이나 PM 업무할 때 터미널에서 노션으로 바로 데이터 쏘는 경험, 꼭 한번 느껴보세요!
다음 글에서는 이걸로 진짜 노션 문서를 자동 생성해본 후기를 들고 오겠습니다. 모두 즐거운 바이브 코딩 되세요, 화이팅! 🔥
### 시도: 프롬프트 한 줄 던지기
터미널을 열고 아래 내용을 요청했습니다.
"클로드 코드의 업데이트, 변경 사항을 검색하고 요약해 주세요. 그 결과를 노션 MCP를 이용해 노션에 저장해 주세요."
그러면 클로드 코드가 **Agent(Search Claude Code updates)** 를 자동으로 띄우더니 2026년 3월 기준 최신 버전인 **v2.1.81** 및 **v2.1.0** 관련 체인로그와 웹 문서들을 검색합니다.
### 결과: 기깔나게 정리된 노션 요약 문서!
약 1분 57초 만에 작업이 끝나고 노션 페이지 URL 링크가 터미널에 떴습니다. 링크를 클릭하면 스크린샷처럼 진짜 깔끔한 노션 문서가 완성되어 있습니다! 📄
< 표에 정리된 내용과 일치>
- **개요 및 최신 버전 정리**: v2.1.81 (2026년 3월 기준)
- **주요 버전 v2.1.0 분석**: Agent Teams(실험적 기능), 팀 리더 역할 및 독립 실행 구조
- **기간별 변경 사항 마크다운 표**:
- 1월: Agent Teams, Skills GA 출시, MCP OAuth 개선, 메모리 68% 절감
- 2월: `/loop` 명령어, cron 스케줄링, 1M 컨텍스트 윈도우 (Opus 4.6)
- 3월 초~말: Opus 4.6 기본 64k/상한 128k 토큰, `--bare` 플래그, 모바일 알림 채널(Telegram/Discord) 연동
- **버그 수정 및 PDF 문서 개선점 정리**
(추가) Sequential Thinking MCP 추가하기
### MCP 연동: Sequential Thinking MCP 추가하기
먼저 터미널에서 명령어로 local MCP로 추가해 줍니다.
```bash
claude mcp add sequential-thinking -s local -- npx -y @modelcontextprotocol/server-sequential-thinking@latest
```
설치가 완료 후에 예제 프롬프트를 입력했습니다. Claude Code가 스스로 생각을 단계별로 확장(Thought 1 ~ Thought 8)하면서 복잡한 문제를 깊게 분석하기 시작합니다.
### 시도: 클로드에게 질문 던지기 & 8단계 사고 과정 실행
프롬프트는 이렇게 작성했습니다. "웹 포트폴리오 체류 시간을 2배 늘리기 위한 체계적인 전략을 구상해달라고 요청했습니다. 그리고 그 결과를 노션 MCP를 통해 노션 페이지로 저장해달라고 요청했습니다."
그러자 클로드가 `sequential-thinking` 툴을 써서 혼자 차근차근 생각을 정리하기 시작하더라고요.
- **1단계:** 문제 정의 (낮은 체류 시간의 원인 분석)
- **2단계:** 현재 상태 파악 및 가설 수립
- **3단계:** 3개 핵심 전략 축 도출 (콘텐츠 깊이 / 참여 유도 / 내부 연결)
- **4단계:** 수학적 타당성 검증 (케이스 스터디 +30초, 내부 링크 방문 +90초 = 2배 가능!)
- **5단계:** 임팩트/노력 매트릭스 우선순위 설정
... 그리고 마지막 **8단계** 종합 결론까지!
terminal 로그에 `thoughtNumber: 8, totalThoughts: 8`이 찍히는 것까지 확인했습니다.
### 결과: 노션에 2개의 완성형 문서가 짠!
사고 과정이 끝나자마자 `notion-create-pages` 도구가 실행되더니, 제 노션 계정에 자동으로 페이지가 딱 만들어졌습니다!
노션으로 가서 확인해보니:
1. **`체류 시간 늘리기`**: 콘텐츠 품질 강화, 인터랙티브 요소(라이브 데모), 소셜 증명, **우선순위 실행 로드맵 표(HIGH/MED/LOW)** 까지 완벽하게 정리됨!
2. **`체류 시간 늘리기 - 체계적 구상`**: Sequential Thinking 8단계 사고 요약표, **성공 지표 KPI 표(현재 측정 필요 -> 목표 2개월 후 2배)** 정렬!
아이디어 구상부터 수치화된 KPI 설정, 그리고 실행 로드맵 표 작성까지 제가 손 하나 안 대고 터미널 프롬프트 몇 줄로 끝났습니다.
### 느낌: 일하는 방식의 변화 - '직접 쓰기'에서 '검토 및 피드백'으로
이전의 업무 흐름이:
`아이디어 구상 ➔ 문서 작성 ➔ 표 구성 ➔ 수치 검토` 였다면,
지금은:
`프롬프트로 프레임 요청 ➔ 생성된 노션 문서 검토 ➔ 수정 요청` 으로 바뀌었습니다. 기획 초안에 드는 시간이 줄어들다 보니, 저는 핵심 의사결정이나 리소스 배분 같은 본질적인 고민에 훨씬 많은 시간을 쓸 수 있게 되었어요.
코딩만 바이브로 하는 게 아니라, **PM 업무와 기획 문서 작성도 바이브로 하는 시대**가 확실히 왔습니다.