Notion MCP 서버

Claude와 다른 AI 어시스턴트를 Notion 작업 공간에 연결하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 통합을 통해 AI 어시스턴트가 Notion 데이터베이스, 페이지 및 블록과 상호 작용할 수 있습니다.

이게 뭔가요?

이 도구는 Claude와 같은 AI 어시스턴트와 Notion 작업 공간을 연결하는 다리 역할을 합니다. AI가 다음과 같은 작업을 수행할 수 있도록 지원합니다.

• Notion 데이터베이스를 보고 검색하세요
• 페이지 생성 및 업데이트
• 콘텐츠 블록 관리
• 그리고 훨씬 더 많은 것들!

단계별 설정 가이드

필수 조건

• Node.js (버전 14 이상)
• Notion 계정
• Claude 데스크톱 앱(Claude와 함께 사용하는 경우)

1. Notion API 키 받기

1. https://www.notion.so/my-integrations 로 이동하세요
2. 파란색 "+ 새 통합" 버튼을 클릭하세요.
3. 자세한 내용을 입력하세요:
   • 이름 : "Claude Assistant" 또는 "AI Helper"와 같은 이름을 선택하세요.
   • 로고 : 선택 사항
   • 연관된 작업 공간 : Notion 작업 공간을 선택하세요
4. "제출"을 클릭하세요
5. 다음 페이지에서 "내부 통합 토큰" 섹션을 찾으세요.
6. "표시"를 클릭하고 토큰을 복사합니다( secret_ 로 시작).

2. 이 서버 설정

저장소 다운로드

옵션 A: ZIP으로 다운로드(초보자 권장)

1. GitHub 저장소로 이동하세요: https://github.com/Sjotie/notionMCP/
2. 오른쪽 상단의 녹색 "코드" 버튼을 클릭하세요
3. "ZIP 다운로드"를 선택하세요
4. 다운로드가 완료되면 ZIP 파일을 컴퓨터의 원하는 위치로 추출합니다.
   • Windows: ZIP 파일을 마우스 오른쪽 버튼으로 클릭하고 "모두 추출"을 선택하세요.
   • Mac: ZIP 파일을 두 번 클릭하여 압축을 풉니다.

옵션 B: Git으로 복제(Git에 익숙한 사용자의 경우)

1. 명령 프롬프트나 터미널을 엽니다
   • Windows: Win+R 누르고 cmd 입력한 후 Enter를 누릅니다.
   • Mac: 응용 프로그램 > 유틸리티에서 터미널을 엽니다.
2. 저장소를 저장할 위치로 이동합니다.지엑스피1
3. 저장소를 복제합니다
   git clone https://github.com/Sjotie/notionMCP/

프로젝트 디렉토리로 이동

다운로드 또는 복제 후 cd (디렉토리 변경) 명령을 사용하여 프로젝트 폴더로 이동해야 합니다.

ZIP 파일을 다운로드한 경우(옵션 A):

1. 명령 프롬프트나 터미널을 엽니다
2. cd 명령을 사용하여 ZIP 파일을 추출한 위치로 이동합니다.
   cd path/to/extracted/folder/notionMCP
   예를 들어:
   • Windows의 경우: cd C:\Users\YourName\Downloads\notionMCP
   • Mac의 경우: cd /Users/YourName/Downloads/notionMCP

Git으로 복제한 경우(옵션 B):

1. 저장소는 "notionMCP"라는 이름의 폴더에 복제되어야 합니다.
2. 복제 후에도 여전히 같은 터미널 창에 있다면 다음을 입력하세요.
   cd notionMCP

올바른 디렉토리에 있는지 확인하는 방법:

• cd 명령을 사용하면 현재 위치를 확인할 수 있습니다.
  • Windows의 경우: dir 입력하고 Enter를 누르면 server.js 와 같은 파일이 표시됩니다.
  • Mac의 경우: ls 입력하고 Enter를 누르면 server.js 와 같은 파일이 표시됩니다.

종속성 설치

notionMCP 디렉토리에 들어가면 필요한 종속성을 설치하세요.

필요한 모든 Node.js 패키지가 설치됩니다. 진행률 표시줄이 나타나고, 설치가 완료되면 "X개의 패키지가 자금을 모집하고 있습니다"와 같은 메시지가 표시될 수 있습니다. 이는 완전히 정상적인 현상이며, 정상적으로 설치되었음을 의미합니다.

3. Notion 페이지에 연결하기

보안을 위해 Notion에서는 각 페이지나 데이터베이스에 대한 액세스 권한을 명시적으로 부여해야 합니다.

1. Notion을 열고 AI가 액세스할 수 있는 페이지나 데이터베이스로 이동합니다.
2. 오른쪽 상단 모서리에 있는 "•••" (세 개의 점)을 클릭하세요.
3. "연결 추가"를 선택하세요
4. 이전에 만든 통합을 찾아 선택하세요
5. 접근 가능하게 만들고 싶은 다른 페이지나 데이터베이스에 대해서도 반복합니다.

4. Claude Desktop에 연결

1. Claude Desktop 구성 파일을 찾으세요.
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (파일 탐색기 주소 표시줄에 이 경로를 입력하세요)
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (Finder에서 Cmd+Shift+G를 누르고 이 경로를 붙여넣으세요)
2. 텍스트 편집기에서 파일을 여세요. 파일이 없으면 다음 내용으로 새로 만드세요.
   { "mcpServers": { "notion": { "command": "node", "args": [ "C:\\path\\to\\notion-mcp-server\\server.js" ], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
3. 바꾸다:
   • C:\\path\\to\\notion-mcp-server\\server.js server.js 파일의 실제 경로를 입력합니다.
     • Windows: 경로에 두 개의 백슬래시(\\)를 사용하세요.
     • Mac: 슬래시(/)를 사용하세요
   • your_notion_api_key_here 에 Notion API 키를 입력하세요.
4. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

5. 연결 테스트

1. Claude에서 새로운 대화를 시작하세요
2. 예를 들어 Claude에게 Notion 작업 공간과 상호 작용하도록 요청하세요.
   • "내 Notion 데이터베이스 목록을 보여주세요"
   • "내 작업 데이터베이스에 '테스트 작업'이라는 제목의 새 페이지를 만듭니다."

사용 가능한 도구

서버는 AI 도우미에게 다음과 같은 도구를 제공합니다.

• list-databases : 접근 가능한 모든 데이터베이스 보기
• query-database : 데이터베이스에서 항목을 가져옵니다
• create-page : 데이터베이스에 새 페이지를 추가합니다.
• update-page : 기존 페이지 수정
• create-database : 새로운 데이터베이스를 생성합니다
• update-database : 데이터베이스 구조 수정
• get-page : 특정 페이지 보기
• get-block-children : 콘텐츠 블록 보기
• append-block-children : 페이지에 콘텐츠 추가
• update-block : 콘텐츠 블록 편집
• get-block : 특정 블록 보기
• 검색 : 작업 공간 전체에서 콘텐츠 찾기

문제 해결

일반적인 문제:

1. Claude에서 "연결에 실패했습니다"
   • claude_desktop_config.json의 서버 경로가 올바른지 확인하세요.
   • Notion API 키가 유효한지 확인하세요
   • Node.js가 설치되어 있는지 확인하세요
2. Notion 콘텐츠에 접속 시 "접근 거부" 발생
   • 통합을 통해 페이지/데이터베이스를 공유했는지 확인하세요.
   • API 키에 필요한 권한이 있는지 확인하세요.
3. 서버가 시작되지 않습니다
   • 모든 종속성이 설치되었는지 확인하세요( npm install )
   • API 키와 함께 .env 파일이 있는지 확인하세요.

도움 받기

여기에 언급되지 않은 문제가 발생하면 다음을 수행하세요.

• 오류 메시지에 대한 콘솔 출력을 확인하세요.
• Notion API 키가 유효한지 확인하세요
• 통합이 페이지/데이터베이스에 액세스할 수 있는지 확인하세요.

특허

MIT