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. 이 서버 설정

1. 이 저장소를 컴퓨터에 다운로드하세요
   • Git이 있는 경우: git clone [repository-url]
   • 또는 ZIP 파일을 다운로드하고 압축을 푸세요
2. 명령 프롬프트나 터미널을 엽니다
   • Windows: Win+R 누르고 cmd 입력한 후 Enter를 누릅니다.
   • Mac: 응용 프로그램 > 유틸리티에서 터미널을 엽니다.
3. 이 저장소를 다운로드한 폴더로 이동합니다.지엑스피1
4. 필요한 종속성을 설치하세요:
   npm install
5. 구성 파일을 만듭니다.
   • .env.example 의 복사본을 만들고 이름을 .env 로 지정하세요.
   • 텍스트 편집기에서 .env 파일을 엽니다.
   • your_notion_api_key_here 이전에 복사한 토큰으로 바꾸세요.
   • 파일을 저장하세요

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