Notion MCP(Model Context Protocol — AI가 외부 프로그램·문서에 정식으로 연결할 때 쓰는 공통 규약) 서버를 연결하면, Claude가 여러분의 Notion 워크스페이스에 있는 문서와 데이터베이스를 직접 열어보고 요약하거나 새 페이지를 만들어 줄 수 있습니다. 마치 회사 안내데스크에서 방문증을 발급받아야 특정 층에 들어갈 수 있는 것처럼, Claude도 이 서버를 통해 정식으로 허가받은 페이지만 골라서 볼 수 있습니다. 이 글은 Claude Code(터미널)·Claude Desktop·Claude.ai 웹 세 가지 환경 모두에서 Notion MCP 서버를 연결하는 방법을 안내합니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
이 글로 할 수 있게 되는 것
이 글을 따라 하면 Claude가 여러분의 Notion 페이지를 직접 검색·요약·수정할 수 있도록 연결을 마칠 수 있습니다. 준비물이 갖춰져 있다면 예상 소요 시간은 약 10~15분입니다.
시작 전 준비물
- Notion 계정 — 연결을 허용할 페이지에 최소한 보기 권한 이상이 있어야 합니다.
- Claude 계정 — Claude.ai 웹에서는 플랜에 따라 메뉴 위치가 다릅니다. Pro·Max 개인 플랜은 Customize → Connectors, Team·Enterprise 조직은 Organization settings → Connectors에서 설정합니다(공식 지원 문서 기준).
- Claude Code로 연결하려면 터미널에서 Claude Code CLI(Command Line Interface — 글자 명령어로 프로그램을 조작하는 도구)가 실행되는 상태여야 합니다.
- Claude Desktop으로 연결하려면 데스크톱 앱이 설치되어 있어야 합니다.
용어 빠른 풀이
- MCP(Model Context Protocol) — Claude 같은 AI가 외부 프로그램·문서에 정식으로 연결할 때 쓰는 공통 규약입니다.
- 원격 MCP 서버 — 내 컴퓨터에 아무것도 설치하지 않아도, 서비스 제공사(여기서는 Notion)가 대신 운영해 주는 연결 서버입니다.
- OAuth — 비밀번호를 직접 알려주지 않고도 "이 프로그램이 내 계정 일부에 접근해도 좋다"고 허락하는 로그인 인증 방식입니다.
- 커넥터(Connector) — Claude.ai 화면에서 원격 MCP 서버를 등록·관리할 때 쓰는 메뉴 이름입니다.
- 연결(Connection) — Notion 쪽에서 부르는 이름으로, 어떤 페이지에 어떤 프로그램이 접근할 수 있는지를 결정하는 단위입니다.
- API(Application Programming Interface) — 프로그램끼리 정보를 주고받을 수 있게 정해 둔 규칙입니다.
Notion MCP 서버로 무엇을 할 수 있나요?
Notion MCP 서버를 연결하면 Claude가 Notion 페이지를 검색·읽기·생성·수정하고, 데이터베이스 항목을 조회하거나 새 뷰(표·보드·캘린더 등 보기 형식)를 만들 수 있습니다. 공식 지원 도구 기준으로 주요 기능은 다음과 같습니다.
- 페이지·데이터베이스 검색 및 내용 조회
- 속성과 본문을 채운 새 페이지 생성(템플릿 적용 가능)
- 기존 페이지의 속성·본문·아이콘·커버 수정
- 데이터베이스 생성과 필터·정렬이 적용된 뷰 만들기
- 페이지에 댓글 남기기·댓글 목록 확인
어디서 연결할 수 있나요?
Notion MCP 서버는 Claude Code·Claude Desktop·Claude.ai 웹 세 환경 모두에서 연결할 수 있으며, 환경마다 설정 위치가 다릅니다.
| 클라이언트 | 설정 위치 | 필요 조건 |
|---|---|---|
| Claude Code | claude mcp add 명령을 터미널에서 실행 | Claude Code CLI 설치 |
| Claude Desktop | Settings → Connectors → Add Connector | Desktop 앱 설치 |
| Claude.ai 웹 | Customize → Connectors(개인) 또는 Organization settings → Connectors(조직) | Claude.ai 계정(플랜별로 메뉴 위치가 다름) |
방법 1. Claude Code(터미널)에서 연결하기
Claude Code에서는 한 줄짜리 명령어로 Notion MCP 서버를 등록할 수 있습니다.
- 터미널에서 다음 명령어를 입력합니다.
이렇게 보이면 성공입니다: 터미널에claude mcp add --transport http notion https://mcp.notion.com/mcpAdded ...로 시작하는 줄이 출력됩니다. - Claude Code 안에서
/mcp를 입력해 인증을 시작합니다. 브라우저가 자동으로 열리며 Notion 로그인 화면이 나타납니다. 로그인 후 Claude가 접근해도 좋을 페이지를 선택하고 승인합니다. - 터미널에서
claude mcp list를 입력해 연결 상태를 확인합니다. 이렇게 보이면 성공입니다:notion서버 옆에✔ Connected가 표시됩니다.! Needs authentication이 보이면 2단계 인증이 끝나지 않은 것이므로/mcp를 다시 실행하세요.
주의: claude mcp add는 기본적으로 local 스코프(현재 프로젝트에서 나만 사용)로 등록됩니다. 팀 전체와 공유하려면 -s project, 모든 프로젝트에서 계속 쓰려면 -s user 옵션을 추가하세요.
방법 2. Claude Desktop에서 연결하기
Claude Desktop에서는 메뉴 클릭만으로 같은 서버를 연결할 수 있습니다.
- Settings(설정) → Connectors로 이동합니다.
- Add Connector를 선택하고, URL 입력란에
https://mcp.notion.com/mcp를 입력합니다. - OAuth 인증 창이 뜨면 Notion 계정으로 로그인하고, 접근을 허용할 페이지를 선택·승인합니다.
이렇게 보이면 성공입니다: Connectors 목록에 Notion이 연결된(활성) 상태로 표시됩니다.
방법 3. Claude.ai 웹에서 연결하기
Claude.ai 웹은 개인 플랜과 조직 플랜의 메뉴 위치가 다릅니다.
- Pro·Max 개인 플랜은 Customize → Connectors로, Team·Enterprise 조직은 Owner가 Organization settings → Connectors로 이동합니다.
- "+" 버튼을 누르고 Add custom connector를 선택합니다(또는 Add → Custom → Web).
- 원격 MCP 서버 URL 입력란에
https://mcp.notion.com/mcp를 입력합니다. Advanced settings에서 OAuth Client ID·Secret을 따로 지정할 수도 있지만, 일반적인 연결에는 비워 두어도 됩니다. - Add를 눌러 저장합니다.
- 대화창을 열고 좌측 "+" 버튼 → Connectors에서 방금 추가한 Notion 커넥터를 토글로 켭니다.
이렇게 보이면 성공입니다: 대화 중 Claude가 Notion 관련 도구를 사용할 수 있다고 안내하거나, Connectors 목록에서 Notion이 활성 상태로 표시됩니다.
OAuth 인증은 어떤 순서로 진행되나요?
세 방법 모두 인증 절차는 같은 흐름을 거칩니다. 연결 명령이나 버튼을 실행하면 브라우저에서 Notion 로그인 창이 뜨고, 접근을 허용할 페이지를 고르고 나면 바로 Claude에서 사용할 수 있습니다.
권한 범위를 최소화하려면 — 워크스페이스 전체를 열어줄 필요는 없습니다
Notion 연결은 기본적으로 워크스페이스 전체가 아니라, 사용자가 명시적으로 허용한 페이지에만 접근합니다. 새로 온 직원에게 사무실 마스터키를 통째로 주는 대신 실제로 필요한 서랍 열쇠만 건네주는 것과 같은 방식입니다.
특정 페이지에만 연결을 추가하려면 다음과 같이 합니다.
- Notion에서 연결을 허용할 페이지로 이동합니다.
- 페이지 우측 상단의 ••• 메뉴를 열고 Add connections를 선택합니다.
- 앞서 인증할 때 만들어진 연결을 검색해 선택합니다.
Enterprise 플랜이라면 Settings → Connections → Manage에서 연결별로 Manage page access를 눌러 접근 가능한 페이지를 더 세밀하게 지정할 수 있고, 이 설정을 누가 바꿀 수 있는지도 제한할 수 있습니다.
주의: 처음 연결하는 MCP 서버는 반드시 신뢰할 수 있는 곳인지 확인 후 연결하세요. 외부 콘텐츠를 가져오는 MCP 서버는 프롬프트 인젝션(prompt injection — 문서나 웹페이지 속에 숨겨진 문구가 AI에게 몰래 다른 지시를 내리는 공격) 위험이 있으므로, 출처가 불분명한 페이지의 내용을 그대로 실행하도록 두지 않는 것이 안전합니다.
자주 막히는 지점과 해결 방법
연결 과정에서 막히는 지점은 대부분 인증 미완료나 페이지 권한 누락입니다.
- 상태가 계속 "! Needs authentication"으로 표시될 때 — 원인은 OAuth 인증이 끝나지 않은 것입니다. Claude Code라면
/mcp를 다시 실행해 인증을 마치세요. - 연결은 됐는데 원하는 Notion 페이지가 안 보일 때 — 원인은 그 페이지에 연결이 추가되지 않은 것입니다. 페이지의 ••• 메뉴 → Add connections에서 연결을 추가하세요.
- 연결을 완전히 지우고 싶을 때 — Claude Code에서는
claude mcp remove notion명령으로 제거합니다. Notion 쪽에서는 페이지의 연결 이름에 마우스를 올려 Disconnect를 누르면 해당 페이지에서만 연결이 해제됩니다.
다음 단계
같은 방식으로 다른 원격 MCP 서버도 연결할 수 있습니다. 예를 들어 Claude Code에서는 claude mcp add --transport sse asana https://mcp.asana.com/sse처럼 서버 이름과 주소만 바꿔 다른 도구도 등록할 수 있습니다. 이슈 트래커·모니터링 대시보드 등 평소 복사·붙여넣기로 옮기던 정보가 있다면, 그 도구에도 MCP 서버가 있는지부터 확인해 보세요.
자주 묻는 질문
Q. Claude Code, Claude Desktop, Claude.ai 웹 중 어디에 연결해야 하나요?
평소 사용하는 클라이언트에 맞춰 선택하면 됩니다. 세 클라이언트는 각각 따로 연결 설정을 해야 하며, 하나에서 연결했다고 다른 클라이언트에 자동으로 연결되지 않습니다.
Q. 연결했는데 원하는 Notion 페이지가 Claude에서 안 보입니다. 왜 그런가요?
Notion 연결은 명시적으로 허용한 페이지에만 접근하기 때문입니다. 해당 페이지의 ••• 메뉴에서 Add connections로 연결을 추가하면 보이기 시작합니다.
Q. Notion MCP로 Slack이나 Google Drive 내용도 검색할 수 있나요?
네, 공식 문서에 따르면 검색 도구가 Notion과 연결된 Slack·Google Drive·Jira 등도 함께 찾아줍니다. 다만 이 기능은 Notion AI가 필요합니다.
Q. 연결을 끊으려면 어떻게 하나요?
Claude Code에서는 claude mcp remove notion 명령으로 제거할 수 있고, Notion 쪽에서는 페이지의 연결 이름에 마우스를 올려 Disconnect를 누르면 해당 페이지에서 연결이 해제됩니다.