Claude Code + 노션: 스스로 관리하는 세컨드 브레인을 위한 다섯 가지 워크플로

60초 만에 설정하기

claude mcp add --transport http notion https://mcp.notion.com/mcp

다음 실행 때 OAuth 승인 요청을 수락하면 끝이에요. 이제 Claude Code가 워크스페이스를 검색하고, 페이지를 마크다운으로 읽고 수정하며, 데이터베이스를 조회할 수 있어요. 모든 연결 옵션과 권한, 호스팅형과 자체 호스팅형의 장단점은 Notion MCP 종합 가이드에서 확인할 수 있어요. 이 설정 전반의 바탕이 되는 개념은 LLM 위키란?에서 설명해요.

먼저 워크스페이스를 이해시키세요 (CLAUDE.md)

챗봇과 원칙을 지키는 사서의 차이는 작업 규칙 파일에 있어요. Claude Code는 실행할 때마다 프로젝트 디렉터리의 CLAUDE.md를 읽어요. 워크스페이스의 규칙을 한 번만 적어 두면 아래 모든 워크플로에 그대로 적용돼요.

# My Notion workspace
- Sources live in "Inbox"; synthesized notes in "Knowledge Base"
- Always cite the source page when creating summaries
- Link related pages with @-mentions (they create backlinks)
- Never edit pages in "Archive"
- Projects DB relates to Tasks DB via the "Project" property

워크플로 5가지

1. 자료 반영하기

"방금 수신함에 추가한 글을 읽어 줘. 지식 베이스에 요약 페이지를 작성해 줘. 핵심 주장과 이미 있는 내용에 비해 새로 추가된 내용을 담고, 관련된 모든 페이지를 @멘션해 줘. 기존 노트와 상충하는 내용은 표시해 줘."

자료 하나를 반영하면 보통 요약 페이지, 색인 페이지, 요약에서 링크한 모든 페이지 등 여러 페이지가 함께 바뀌어요. 이런 작업이 지식을 누적해서 키워 주지만, 수동으로 노트를 작성할 때는 결코 꾸준히 이어 가지 못해요.

2. 상호 연결 점검

"지식 베이스에서 의미상 관련이 있지만 연결되지 않은 페이지 쌍을 5개 찾아 줘. 각 쌍이 어떻게 연결되는지 한 문장으로 설명하고, 내가 승인하면 @멘션을 추가해 줘."

이럴 때 의미를 이해하는 능력이 태그보다 더 유용해요. Claude는 공통 키워드가 없는 페이지도 연결해요. @멘션은 백링크를 만들기 때문에, 연결을 승인할 때마다 두 페이지가 동시에 더 풍부해져요.

3. 주간 검토

"이번 주 내 워크스페이스에서 바뀐 내용을 모두 나열해 줘. 새 페이지, 업데이트된 프로젝트, 진행이 멈춘 작업을 포함해 줘. 그런 다음 상호 연결 3개와 업데이트할 만한 요약 1개를 제안해 줘."

2월이면 흐지부지되는 검토 습관을 일요일의 20분으로 대신할 수 있어요. 확인은 여러분이, 저장과 정리는 에이전트가 맡아요.

4. 지식의 빈틈 분석

"워크스페이스 전체에서 [주제]에 관해 내가 알고 있는 내용을 모두 모아 줘. 충분히 다룬 내용 / 피상적으로 다룬 내용 / 전혀 다루지 않은 내용으로 정리해 줘."

'전혀 다루지 않은 내용' 열이 앞으로 조사할 목록이 돼요. 추측이 아니라 여러분의 노트에서 직접 뽑아낸 목록이에요.

5. 답변을 다시 저장하기

"방금 작성한 비교 내용을 지식 베이스에 페이지로 저장하고, 출처를 연결한 뒤 색인에 추가해 줘."

좋은 답변이 채팅 기록 속에서 사라져서는 안 돼요. 지식 베이스에 다시 저장하면 다음 질문의 토대가 되는 노드로 남아요. 지식이 초기화되는 대신 계속 쌓이는 거예요.

안전장치 (골치 아픈 시행착오로 배운 것들)

• 상호 연결은 적용 전에 확인하세요. 모델은 때때로 단어가 겹친다는 이유로 연결해요. 저희 모델은 한 번 "Python 데코레이터"와 "인테리어 장식"을 연결한 적이 있어요. 되돌리기보다는 검토 후 적용하는 편이 나아요.
• 지식 베이스 전체가 아니라 서로 연관된 영역 안에서 작업하세요. "1800개 페이지 전체"를 요청하지 마세요. 데이터베이스 하나, 클러스터 하나, 또는 일주일로 범위를 좁히세요. 컨텍스트 한도는 실제로 존재해요.
• 변경하면 안 되는 영역을 보호하세요. CLAUDE.md에 아카이브와 신뢰할 수 있는 기준 정보가 담긴 페이지를 읽기 전용으로 명시하세요.
• 접근 권한 구조를 기억하세요. MCP를 통해 에이전트는 여러분의 권한을 사용해요. 여러분이 접근하거나 수정할 수 있는 모든 항목에 에이전트도 똑같이 접근하거나 수정할 수 있어요. 이를 고려해 범위를 정하세요(자세한 내용은 MCP 가이드의 보안 섹션에서 확인하세요).

피드백 루프 완성하기: 구조의 변화를 확인하세요

텍스트 결과만으로는 몇 달에 걸쳐 유일하게 중요한 질문에 답할 수 없어요. 지식 베이스가 실제로 더 촘촘하게 연결되고 있을까요? 그래프는 답할 수 있어요. 자료 반영과 상호 연결을 몇 차례 반복한 뒤 IVGraph에서 워크스페이스를 열어 보세요. 클러스터는 더 촘촘해지고, 연결 없이 고립된 페이지는 네트워크에 합류하며, 허브 페이지가 나타나요. 세컨드 브레인의 변경 전후 차이를 시각적으로 보여 주는 거예요. 에이전트도 IVGraph LLM API로 같은 구조를 조회해 다음 상호 연결 후보를 고를 수 있어요.

자주 묻는 질문