Notion MCP의 개요
Notion MCP는 Notion이 https://mcp.notion.com/mcp에서 호스팅하는 원격 서버입니다(/sse의 SSE 엔드포인트도 아직 제공됩니다). Claude Code, Cursor, Codex 같은 클라이언트에 URL을 추가하고 OAuth로 로그인하면, 클라이언트는 사용자가 Notion에서 이미 접근할 수 있는 것만 읽고 바꿀 수 있습니다. 모든 플랜에서 쓸 수 있습니다.
도구 목록은 깁니다. 지원 도구 페이지에 50개가 넘습니다. notion-search와 notion-fetch는 콘텐츠를 찾고 읽으며, notion-create-pages, notion-update-page, notion-move-pages, notion-duplicate-page는 편집하고, notion-create-database, notion-create-view, notion-query-data-sources는 SQL 방식 쿼리를 포함해 데이터베이스를 다룹니다. 댓글, 파일, 사용자, 캘린더, Notion Skills, 에이전트 메모리, Custom Agent 세션을 위한 도구도 있고, Notion AI가 있는 플랜에서는 Slack, Google Drive, GitHub, Jira를 위한 notion-connector-search가 있습니다.
통합 토큰으로 실행하는 이전의 오픈소스 서버(@notionhq/notion-mcp-server)는 2026년 1월의 v2.1.0으로 여전히 작동하지만, README에 따르면 더 이상 적극적으로 유지보수되지 않으며 Notion이 저장소를 종료할 수도 있습니다.
Notion MCP 설치 방법
https://mcp.notion.com/mcpNotion MCP, 쓸 만한 가치가 있습니까?
Notion이 힘을 쏟은 곳은 호스팅 서버이며, 세부 사항에서 그것이 드러납니다. 접근 권한은 각 사용자의 기존 권한을 따르므로 페이지를 손으로 공유할 통합이 필요 없고, 삭제는 이례적으로 신중하게 다룹니다. notion-delete-pages는 한 번에 최대 20개 페이지를 휴지통으로 옮기며, 호출에 user_confirmed가 설정되지 않으면 동작을 거부하고, 파괴적 작업으로 표시되어 어노테이션을 따르는 클라이언트는 먼저 묻습니다. notion-restore-pages로 되살릴 수 있습니다.
체감 품질은 플랜에 따라 갈립니다. Notion AI가 있는 Business와 Enterprise에서는 검색이 Slack, Google Drive, GitHub, Jira까지 닿고, 여러 데이터 소스에 걸친 SQL이 무제한이며, 편집자, 날짜, 여러 팀스페이스로 거르는 필터가 작동합니다. 다른 플랜은 키워드 검색과, 크기가 공개되지 않은 워크스페이스 공유 할당량 안에서 한 번에 하나의 데이터 소스만 쓰며, 지원되지 않는 필터는 조용히 빠진 채 안내문과 함께 결과가 돌아옵니다. 에이전트가 그 안내문을 읽어야 합니다. 그렇지 않으면 더 넓은 결과를 정확한 결과로 다루게 됩니다.
요청 한도는 대화형 사용에는 넉넉하지만 대량 작업에는 빠듯합니다. Notion은 대부분의 플랜에서 연결당 분당 180회, Business와 Enterprise에서 600회를 주고, 데이터 소스 쿼리는 초당 약 3회로 제한되며, 일부 MCP 도구에는 자체적인 짧은 한도가 있습니다. 수천 행을 옮기는 에이전트는 429를 만나게 되므로 Retry-After를 지켜야 합니다.
거버넌스는 Atlassian보다 얇습니다. 워크스페이스 소유자는 연결된 클라이언트를 볼 수 있고 Admin API로 연결을 나열하고 취소할 수 있지만, 멤버가 연결할 수 있는 클라이언트를 제한하는 기능은 Enterprise 전용이며, Notion 도움말 센터에 따르면 사용자별 도구 수준 가시성은 아직 없습니다. 허용 목록에서 앱을 빼면 호출은 막히지만, 그 앱이 이미 가진 토큰은 취소할 수 없습니다.
제 역할을 하는 곳
사양과 ADR을 Notion에 두고 Claude Code로 코딩하는 엔지니어
현재 사양을 코딩 세션에 불러오고, 작업이 출시되면 상태 갱신하기
notion-fetch가 페이지를 Markdown으로 읽고, notion-update-page가 속성을 바꿉니다. 어떤 플랜에서도 추가 비용이 없고, 작업당 몇 번의 호출은 분당 180회 요청에 한참 못 미칩니다.
2,000행짜리 기능 요청 데이터베이스를 운영하는 프로덕트 운영 리드
에이전트가 매주 새 요청을 분류하고 태그 달게 하기
notion-query-data-sources가 행을 가져오고 notion-update-page가 태그를 답니다. Notion AI가 있는 Business와 Enterprise에서는 SQL이 무제한이고, Plus에서는 공개되지 않은 공유 할당량에서 차감되며 대량 갱신은 요청 한도 아래에 머물러야 합니다.
Notion Enterprise를 쓰는 300명 규모 회사의 IT 관리자
Claude와 ChatGPT는 허용하고, 검증되지 않은 MCP 클라이언트는 막기
Connections에서 AI 앱을 "Only approved list"로 설정합니다. 기존 연결은 자동으로 추가됩니다. Admin API로 연결을 나열하고 취소하되, 사용자별 도구 사용은 아직 볼 수 없다는 점을 감수해야 합니다.
도입 전 확인할 점
- 설정
- Claude Code, Cursor, Codex 등의 클라이언트에 https://mcp.notion.com/mcp를 추가하고 브라우저에서 OAuth를 마치면, 몇 분 안에 첫 도구 호출을 할 수 있습니다. Okta 고객은 엔터프라이즈 관리형 인가를 써서 멤버가 클라이언트마다 승인하지 않아도 되게 할 수 있습니다.
- 연동
- 50개가 넘는 도구입니다. 읽기(search, fetch, get-comments, query-data-sources), 쓰기(create-pages, update-page, move-pages, create-view, create-comment), 파괴적 작업(delete-pages, delete-databases, 둘 다 확인 필요)으로 나뉩니다. 관리자 소유 연결은 24개 도구 중 선택한 일부만 노출할 수 있습니다.
- 데이터와 개인정보
- 호스팅 서버는 로그인한 사용자가 할 수 있는 모든 것을 읽고 씁니다. Notion은 페이지 내용, 댓글, 연결된 앱 결과에 프롬프트 인젝션 지시가 담겨 클라이언트가 데이터를 유출하거나 바꾸게 할 수 있다고 경고합니다. 오픈소스 서버에 대해 공개된 GitHub 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 서버 요금은 없습니다. 비용은 플랜입니다. 전체 검색과 무제한 SQL에는 연간 결제 시 멤버당 월 $20의 Business가 필요하므로, 50명이면 연 $12,000입니다. Notion 크레딧 도움말 페이지에 따르면 일상적인 연결된 앱과 API 사용은 크레딧을 쓰지 않고 요청 한도만 적용되지만, 이를 통해 에이전트를 실행하면 Notion 크레딧을 씁니다.
- 제한
- Free와 Plus는 연결당 분당 180회, Business와 Enterprise는 600회 요청이고, 데이터 소스 쿼리는 초당 약 3회이며, 도구별 한도도 있습니다. 최상위 비공개 페이지는 MCP로 되살릴 수 없습니다.
좋은 점
- OAuth로 로그인하며, 접근 권한은 각 사용자의 Notion 권한을 따릅니다
- 데이터베이스 뷰와 SQL 방식 쿼리를 포함해 50개가 넘는 도구가 있습니다
- 삭제는 휴지통으로 가고, user_confirmed가 필요하며, 되살릴 수 있습니다
- 모든 Notion 플랜에서 쓸 수 있습니다
아쉬운 점
- 연결된 앱 검색과 다중 소스 SQL에는 Notion AI가 있는 Business나 Enterprise가 필요합니다
- 클라이언트 허용 목록은 Enterprise 전용이고, 사용자별 도구 가시성은 아직 없습니다
- Business 미만에서는 연결당 분당 180회 요청입니다
- 자체 호스팅 오픈소스 서버는 유지보수되지 않습니다
추천 대상
문서, 위키, 프로젝트 데이터베이스를 Notion에 두고 어시스턴트가 이를 읽고 갱신하기를 원하는 팀.
Notion MCP 대안
Notion MCP: 자주 묻는 질문
- Notion MCP, 쓸 만한 가치가 있습니까?
- Notion은 호스팅 서버에 실질적인 공을 들였고, 그 결과 워크스페이스를 다루는 유능한 에이전트 인터페이스가 되었습니다. 다만 쓸모 있는 검색과 쿼리 도구는 Business 플랜 이상에 묶여 있습니다. 평점은 5점 만점에 4.5점입니다.
- Notion MCP의 가격은 얼마입니까?
- 모든 플랜에서 무료입니다. 연결된 앱 검색, 무제한 SQL 쿼리, 고급 검색 필터에는 Business(연간 결제 시 멤버당 월 $20)나 Enterprise가 필요합니다.
- Notion MCP의 단점은 무엇입니까?
- 연결된 앱 검색과 다중 소스 SQL에는 Notion AI가 있는 Business나 Enterprise가 필요합니다; 클라이언트 허용 목록은 Enterprise 전용이고, 사용자별 도구 가시성은 아직 없습니다; Business 미만에서는 연결당 분당 180회 요청입니다; 자체 호스팅 오픈소스 서버는 유지보수되지 않습니다.
- Notion MCP에 적합한 사람은 누구입니까?
- 문서, 위키, 프로젝트 데이터베이스를 Notion에 두고 어시스턴트가 이를 읽고 갱신하기를 원하는 팀.
- 팀이나 프로덕션 환경에서 Notion MCP의 비용은 얼마입니까?
- 서버 요금은 없습니다. 비용은 플랜입니다. 전체 검색과 무제한 SQL에는 연간 결제 시 멤버당 월 $20의 Business가 필요하므로, 50명이면 연 $12,000입니다. Notion 크레딧 도움말 페이지에 따르면 일상적인 연결된 앱과 API 사용은 크레딧을 쓰지 않고 요청 한도만 적용되지만, 이를 통해 에이전트를 실행하면 Notion 크레딧을 씁니다.
- Notion MCP에 회사 데이터를 맡겨도 안전합니까?
- 호스팅 서버는 로그인한 사용자가 할 수 있는 모든 것을 읽고 씁니다. Notion은 페이지 내용, 댓글, 연결된 앱 결과에 프롬프트 인젝션 지시가 담겨 클라이언트가 데이터를 유출하거나 바꾸게 할 수 있다고 경고합니다. 오픈소스 서버에 대해 공개된 GitHub 보안 권고는 없습니다.
- Notion MCP의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Atlassian Rovo MCP Server, Google Workspace MCP servers 및 Linear MCP입니다.
답변 확인일: 2026년 10월 26일.
Notion MCP 개발사입니까? 이 평점을 사이트에 표시하십시오
