MCP Notion Server

mcp-notion-server

Notion 통합을 위한 모델 컨텍스트 프로토콜 서버

이 TypeScript 기반 MCP 서버는 Claude와 Notion 간의 브릿지를 구현하여 Notion의 데이터베이스 및 페이지와 원활하게 상호 작용할 수 있도록 합니다. 다음을 통해 핵심 MCP 개념을 보여줍니다.

• Notion 페이지 및 데이터베이스에 대한 리소스 관리
• Notion 콘텐츠의 CRUD 작업을 위한 도구
• 콘텐츠 분석을 위한 AI 기반 프롬프트

특징

자원

• URI를 통해 Notion 페이지 및 데이터베이스에 액세스
• 일반 텍스트 및 서식 있는 텍스트 콘텐츠 유형 지원
• Notion 속성에서 메타데이터 추출

도구

데이터베이스 작업

• list_databases - 접근 가능한 모든 Notion 데이터베이스 나열
• create_database - 사용자 정의 속성을 사용하여 새 데이터베이스를 만듭니다.
• query_database - 데이터베이스 항목 검색 및 필터링
• update_database - 데이터베이스 속성 및 스키마 수정

페이지 작업

• create_page - 데이터베이스 또는 하위 페이지에 새 페이지를 만듭니다.
  • 제목, 속성 및 마크다운 콘텐츠 지원
• update_page - 기존 페이지 속성 업데이트
• get_page - 페이지 콘텐츠 및 메타데이터 검색
• delete_page - 데이터베이스 또는 부모 페이지에서 페이지 제거

블록 작업

• append_blocks - 페이지에 새 블록 추가
• delete_blocks - 페이지에서 블록 제거
• get_blocks - 블록 콘텐츠 검색
• update_blocks - 기존 블록 콘텐츠 수정

프롬프트

• summarize_notes - 노트의 간결한 요약을 생성합니다.
• analyze_content - 페이지 콘텐츠에 대한 통찰력과 분석 제공
• suggest_tags - 콘텐츠에 따라 관련 태그를 추천합니다.

설정

필수 조건

• Node.js 18 이상
• Notion API 키 및 통합 설정
• 클로드 데스크톱 애플리케이션

Claude Desktop과 통합

Notion 통합 만들기:

1. Notion 통합 페이지를 방문하세요.
2. "새로운 통합"을 클릭합니다.
3. 통합의 이름을 지정하고 적절한 권한을 선택합니다(예: "콘텐츠 읽기", "콘텐츠 업데이트").
4. 비밀 열쇠를 찾으세요:
5. 통합에서 "내부 통합 토큰"을 복사하세요. 이 토큰은 인증에 사용됩니다.
6. 작업 공간에 통합을 추가하세요:
7. Notion에서 통합에 액세스하려는 페이지나 데이터베이스를 엽니다.
8. 오른쪽 상단 모서리에 있는 탐색 버튼을 클릭하세요.
9. "연결 대상" 버튼을 클릭하고 통합을 선택하세요.

구성 설정

Claude Desktop에 서버 구성을 추가합니다.

맥OS :

지엑스피1

윈도우 :

구성 내용:

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

1. MCP 검사관

MIT 라이선스 - 자세한 내용은 라이선스를 참조하세요.