Claude - Notion MCP 연결하기 2 (공식 Notion MCP)

 

개요 

25.04.11 작성   
notion 공식 mcp 가 나옴 
https://github.com/makenotion/notion-mcp-server?tab=readme-ov-file

GitHub - makenotion/notion-mcp-server: Official Notion MCP Server

 

출처 : https://github.com/makenotion/notion-mcp-server?tab=readme-ov-file

 

설치방법 

1. Notion API 설정

• Notion API 통합 페이지(https://www.notion.so/my-integrations) 에서 API 키 발급
• 발급받은 API 키 복사해두기

출처 : https://github.com/makenotion/notion-mcp-server/blob/main/tutorial0.png

 

2. Notion 페이지와 통합 연결

• Claude와 연결하고 싶은 Notion 페이지 열기
• 우측 상단의 점 세 개(⋮) 클릭
• "연결"을 선택하고 방금 생성한 통합 기능 추가

출처 : https://github.com/makenotion/notion-mcp-server/blob/main/tutorial.png

 

3. Claude 데스크톱 설정

• Claude 데스크톱 애플리케이션 설치 (mcp 기능 사용하려면 데스크톱 필요) https://claude.ai/download
• (맨처음이라면 필요?) 좌측상단 버튼 - Help - Enable Developer Mode 
• 좌측상단 버튼 - File - Settings → Developer 개발자 → Edit Config 설정 편집
• "claude_desktop_config.json" 파일 열기 - 다음 내용 복붙:
• (표시해놓은 위치에 위에서 복사해놓은 API키 붙여넣기~ `\"Bearer ntn_****\"`이런식으로 )

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ---여기에ntn_으로시작하는 API키붙여넣기---\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

 

Claude를 완전히 껐다가 켜야됨 (그냥 창닫기 말고, 우측하단 아이콘 - quit 으로 완전종료) 

 
nodejs도 설치안되어있으면 따로 설치 필요 
https://nodejs.org/en

Node.js — Run JavaScript Everywhere

 

제공하는 기능 

 

제공하는 기능 목록 

API-create-a-comment	Create comment	notionApi
API-create-a-database	Create a database	notionApi
API-delete-a-block	Delete a block	notionApi
API-get-block-children	Retrieve block children	notionApi
API-get-self	Retrieve your token's bot user	notionApi
API-get-user	Retrieve a user (Error Responses: 400: 400)	notionApi
API-get-users	List all users (Error Responses: 400: 400)	notionApi
API-patch-block-children	Append block children	notionApi
API-patch-page	Update page properties	notionApi
API-post-database-query	Query a database	notionApi
API-post-page	Create a page	notionApi
API-post-search	Search by title	notionApi
API-retrieve-a-block	Retrieve a block	notionApi
API-retrieve-a-comment	Retrieve comments	notionApi
API-retrieve-a-database	Retrieve a database	notionApi
API-retrieve-a-page	Retrieve a page	notionApi
API-retrieve-a-page-property	Retrieve a page property item	notionApi
API-update-a-block	Update a block	notionApi
API-update-a-database	Update a database	notionApi

 
정리해보자면 이런것들인 것 같음 
1. 페이지 관리
API-post-page: 새 페이지 생성
API-retrieve-a-page: 페이지 정보 조회
API-patch-page: 페이지 속성 업데이트

2. 블록 관리
API-retrieve-a-block: 블록 정보 조회
API-get-block-children: 블록의 자식 요소 조회
API-patch-block-children: 블록에 자식 요소 추가
API-update-a-block: 블록 내용 업데이트
API-delete-a-block: 블록 삭제

3. 데이터베이스 관리
API-create-a-database: 새 데이터베이스 생성
API-retrieve-a-database: 데이터베이스 정보 조회
API-update-a-database: 데이터베이스 속성 업데이트
API-post-database-query: 데이터베이스 쿼리 실행

4. 댓글 관리
API-create-a-comment: 댓글 생성
API-retrieve-a-comment: 댓글 정보 조회

5. 사용자 관리
API-get-self: 현재 API 토큰의 봇 사용자 정보 조회
API-get-user: 특정 사용자 정보 조회
API-get-users: 모든 사용자 목록 조회

6. 검색 기능
API-post-search: 제목으로 페이지/데이터베이스 검색

7. 속성 관리
API-retrieve-a-page-property: 페이지 속성 항목 조회