Notion MCP 서버

Notion 작업 공간과 통합하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 모델이 Notion의 콘텐츠에 접근하고, 쿼리하고, 수정할 수 있는 표준화된 인터페이스를 제공합니다.

필수 조건

• Node.js(v16 이상)
• Notion API 키( Notion 통합 에서)
• 적절한 권한이 있는 연결된 Notion 작업 공간

설치

1. 이 저장소를 복제하세요:지엑스피1
2. 종속성 설치:
   npm install
3. Notion API 키로 루트 디렉토리에 .env 파일을 만듭니다.
   # Required NOTION_API_KEY=your_notion_api_key_here # Optional settings DEBUG=false REQUIRE_CONFIRMATION_FOR_CREATE=true REQUIRE_CONFIRMATION_FOR_UPDATE=true REQUIRE_CONFIRMATION_FOR_DELETE=true UPDATE_POLLING_INTERVAL=60000 MAX_BLOCK_DEPTH=3 BACKUP_DIR=./backups BACKUP_RETENTION_DAYS=30 MAX_BACKUPS_PER_PAGE=5
4. 프로젝트를 빌드하세요:
   npm run build
5. 서버를 시작합니다:
   npm start

Claude와 함께 데스크톱 사용

Claude for Desktop과 함께 이 Notion MCP 서버를 사용하려면:

1. Claude for Desktop이 설치되고 최신 버전으로 업데이트되었는지 확인하세요.
2. Claude for Desktop의 구성 파일을 엽니다.
   • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json
3. 서버 구성을 추가합니다.
   { "mcpServers": { "notion": { "command": "node", "args": ["/path/to/notion-mcp-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
4. 파일을 저장하고 Claude for Desktop을 다시 시작하세요.

자원

서버는 다음과 같은 리소스를 제공합니다.

도구

서버는 다음과 같은 도구를 제공합니다.

프롬프트

서버에는 다음과 같은 사전 구성된 프롬프트가 포함되어 있습니다.

예제 쿼리

Claude에 연결되면 Notion 작업 공간에 대한 자연어 질문을 할 수 있습니다.

1. "오늘 내 작업 공간에서 어떤 작업을 마감해야 하나요?"
2. "프로젝트 X의 상태를 보여주세요"
3. "'아이디어' 데이터베이스에 '새로운 기능 컨셉'이라는 제목으로 새 페이지를 만드세요."
4. "작업 Y의 상태를 '완료'로 업데이트"
5. "지난 24시간 동안 내 작업 공간에 어떤 변경 사항이 있었나요?"
6. "다음 주 마감일을 요약해 보세요"
7. "abc123 페이지의 모든 백업을 보여주세요"
8. "백업 파일 page_abc123_2023-01-01.json에서 페이지 abc123을 복원합니다."

서버 확장

새로운 기능을 추가하려면:

1. 리소스 추가 : index.ts 에서 리소스 핸들러 확장
2. 도구 추가 : index.ts 에 새 도구 정의를 만듭니다.
3. 프롬프트 추가 : index.ts 에 새 프롬프트 템플릿 정의
4. API 통합 강화 : notion-api.ts 에 새로운 API 함수 추가

로그

자세한 오류 정보는 서버 로그에서 확인하세요.

• 데스크톱 로그용 Claude : MCP 관련 로그를 보려면 Claude 로그 디렉토리를 찾으세요.
• 서버 출력 : 서버 로그에 대한 표준 출력 및 오류 스트림을 확인합니다.