Install guide and config at curatedmcp.com

Notion MCP Server: AI 에이전트가 팀 지식 기반에 네이티브로 접근하도록 합니다

AI 에이전트가 Notion을 읽고 쓸 수 있게 되면, 워크플로우 자체가 바뀝니다. 문서를 채팅창에 복사하는 대신, 작업 공간(workspace)에서 직접 쿼리할 수 있습니다. 수동 업데이트 대신, Claude가 데이터베이스에 글을 작성합니다. Notion MCP Server는 이 격차를 해소해 줍니다. Claude나 Cursor 같은 AI 에이전트를 전체 Notion 작업 공간과 연결하여 완전한 읽기-쓰기-검색(read-write-search) 기능을 제공합니다.

기능 설명 (What It Does)

Notion MCP Server는 AI 에이전트가 Notion을 네이티브 도구처럼 사용할 수 있게 합니다. 페이지를 즉석에서 생성하고 업데이트할 수 있습니다. 필터링을 통해 데이터베이스에 쿼리할 수 있습니다. 전체 작업 공간을 검색할 수 있습니다. 블록(텍스트, 코드, 테이블, 콜아웃)을 추가할 수 있습니다. 데이터베이스 스키마를 관리할 수 있습니다. 중첩된 계층 구조를 처리할 수 있습니다. 댓글을 읽고 쓸 수 있습니다.

이를 통해 구체적인 기능들이 활성화됩니다: 에이전트가 사용자가 붙여넣지 않아도 문서 컨텍스트를 가져올 수 있습니다. 팀 데이터베이스에 회의록을 직접 생성할 수 있습니다. 업데이트를 제안하기 전에 관련 레코드를 검색할 수 있습니다. 공유 코드 데이터베이스에 코드 스니펫을 생성할 수 있습니다. 작업 공간 구조를 감사하거나 데이터베이스 간 콘텐츠를 마이그레이션할 수 있습니다.

Notion에 지식을 저장하는 팀(대부분의 팀)에게 이는 혁신적입니다. 이제 AI는 고립되어 작동하지 않습니다. 실제 기록 시스템(system of record) 내부에서 작동합니다.

설치 방법 (How to Install)

npx를 통해 설치합니다:

npx -y @notionhq/notion-mcp-server

claude_desktop_config.json에 다음 내용을 추가하여 Claude Desktop용으로 구성합니다:

{
  

- **프로젝트 데이터베이스 자동 채우기 (Auto-populate project databases)**: Claude에게 스프린트 노트 (sprint notes)를 읽고, 작업을 추출하며, 상태(status), 담당자(assignee), 마감일(due date)을 포함한 새로운 데이터베이스 항목을 Notion에 작성하도록 요청하세요.
- **검색 증강 코드 생성 (Search-augmented code generation)**: 에이전트가 팀의 코드 스니펫 (code snippets) 데이터베이스를 쿼리하여 관련 예시를 찾은 다음, 팀이 실제로 사용하는 맥락에 맞춰 새로운 코드를 생성합니다.
- **맥락 기반 문서화 (Documentation from context)**: Claude가 워크스페이스에 흩어져 있는 회의록과 문서들을 읽고, 통합된 지식 기반 (knowledge base) 항목을 생성하여 Notion에 직접 작성합니다.

Claude Desktop, Cursor, Windsurf 등을 위한 전체 설치 가이드는 [CuratedMCP](https://curatedmcp.com/marketplace/notion-mcp-server)에서 확인하실 수 있습니다.