Notion MCP 서버

AI 모델이 Notion 작업 공간과 상호 작용할 수 있도록 하는 공식 Notion SDK를 제공하는 MCP(Model Context Protocol) 서버입니다.

빠른 시작

1. Notion 통합 설정

1. https://www.notion.so/my-integrations 로 이동하세요
2. 새로운 통합을 만듭니다
3. API 키를 복사하세요

2. Notion 페이지를 통합에 연결합니다.

Notion 콘텐츠에 액세스하려면 통합을 통해 페이지나 데이터베이스를 명시적으로 공유해야 합니다.

1. 통합을 통해 액세스하려는 Notion 페이지 또는 데이터베이스로 이동합니다.
2. 오른쪽 상단의 "공유" 버튼을 클릭하세요
3. "사람, 그룹 또는 통합 추가" 필드에서 드롭다운 목록에서 통합을 선택하세요.
4. "초대"를 클릭하세요
5. 접근 가능하게 만들고 싶은 각 페이지나 데이터베이스에 대해 반복합니다.

참고: 통합은 명시적으로 공유된 페이지 및 데이터베이스에만 접근할 수 있습니다. 자식 페이지는 부모 페이지의 접근 권한을 자동으로 상속받습니다.

3. AI 어시스턴트에 추가

다음 구성 형식 중 하나를 사용하여 이 MCP 서버를 Claude Desktop, Cursor AI 또는 Claude.ai에 추가할 수 있습니다.

명령줄 형식

지엑스피1

JSON 구성 형식

1단계의 API 키로 your-notion-integration-key 바꾸세요.

설치 지침

• Claude Desktop : 설정 > 고급 > 모델 컨텍스트 프로토콜
• 커서 AI : 설정 > AI > MCP 서버
• Claude.ai(웹) : 프로필 > 설정 > API 및 통합 > 모델 컨텍스트 프로토콜

사용 가능한 도구

서버는 Notion과 상호 작용하기 위한 도구를 제공합니다.

• 검색 : 페이지 또는 데이터베이스 찾기
• 데이터베이스 : 데이터베이스 항목 쿼리 및 검색
• 페이지 : 페이지 생성, 검색 및 업데이트
• 블록 : 콘텐츠 블록(단락, 목록 등)을 관리합니다.
• 사용자 : 사용자 목록을 작성하고 사용자 정보를 가져옵니다.
• 댓글 : 댓글을 생성하고 나열합니다
• 링크 미리보기 : URL에 대한 링크 미리보기를 만듭니다.

대체 설정 방법

환경 변수 사용

API 키를 직접 전달하는 대신 .env 파일을 사용할 수 있습니다.

1. 다음을 사용하여 .env 파일을 만듭니다.

2. 서버를 실행합니다:

환경 변수를 사용한 JSON 구성(Claude Desktop용)

JSON 구성 형식으로 환경 변수를 사용할 수도 있습니다.

명령줄 옵션

문제 해결

"클라이언트 생성 실패" 오류가 발생하는 경우:

• Windows에서는 npx 명령 전에 cmd /c 사용해 보세요.
• macOS/Linux에서는 npx의 전체 경로를 사용해 보세요.
• AI 어시스턴트에 추가하기 전에 터미널에서 명령을 테스트하세요.

일반적인 문제

• "리소스에 액세스할 수 없음" 오류 : 통합을 통해 특정 Notion 페이지 또는 데이터베이스를 공유했는지 확인하세요(2단계 참조).
• 공유 메뉴에 통합이 나타나지 않습니다 . 페이지를 새로 고치거나 브라우저를 다시 시작해 보세요.
• 제한된 기능 : Notion 통합 설정에서 통합에 적절한 기능이 활성화되어 있는지 확인하세요.

특징

• 공식 SDK를 통한 전체 Notion API 지원
• 원활한 AI 통합을 위한 MCP 호환
• 모든 Notion 작업을 위한 포괄적인 도구
• 자세한 메시지를 통한 강력한 오류 처리
• 환경 변수를 사용한 간편한 구성

각 도구에 대한 자세한 내용은 도구 설명서를 참조하세요.

특허

이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.