노션 MCP 연동: 지금 안 하면 AI 비서 그냥 놀린다
Claude, ChatGPT, Cursor가 내 노션 워크스페이스를 직접 읽고 쓰는 시대가 왔습니다. 2026년 3월 기준 노션 MCP 연동은 OAuth 원클릭으로 끝납니다. 아직 모른다면 매일 복붙하느라 시간 낭비하고 있는 겁니다.
🤖 Claude · ChatGPT · Cursor 지원
📝 페이지 읽기·쓰기·검색 가능
⚡ 분당 180 API 호출 무료
노션 MCP란? — API 통합과 무엇이 다른가
노션 MCP 연동은 2024년 11월 Anthropic이 발표한 MCP(Model Context Protocol)를 노션이 공식 채택하면서 탄생한 기능입니다. 쉽게 말하면 AI 도구(Claude, ChatGPT 등)와 노션 사이에 USB-C 같은 표준 연결 규격을 꽂아 두는 것입니다. 기존 노션 API가 개발자가 직접 HTTP 요청을 짜야 했던 것과 달리, MCP는 AI 에이전트가 자연어 명령만으로 노션에 접근하도록 설계되었습니다.
핵심 차이를 한 줄로 정리하면 이렇습니다. 기존 API는 “개발자가 도구를 사용하는 방식”이고, MCP는 “AI 에이전트가 도구를 이해하는 방식”입니다. 노션은 2025년 7월 원격 자체 호스팅 MCP 서버를 정식 출시하면서, 기존 오픈소스 방식의 복잡한 설치 과정과 API 키 수동 입력 문제를 모두 없앴습니다. 지금은 OAuth 인증 한 번으로 끝납니다.
💡 핵심 인사이트: 기존 notion-mcp-server(오픈소스 구버전)는 Docker 설치, API 키 복사, JSON 파일 직접 수정이 필요했지만, 현재 공식 MCP 서버(https://mcp.notion.com/mcp)는 URL 하나 입력하고 OAuth로 로그인하면 모든 설정이 완료됩니다.
MCP의 기술적 구조를 간단히 설명하면, AI 도구(Claude, Cursor 등)가 MCP 클라이언트 역할을 하고 노션 서버가 MCP 서버 역할을 합니다. 사용자가 “지난주 회의록 페이지 요약해 줘”라고 입력하면, Claude가 노션 MCP 서버에서 search 툴을 호출해 관련 페이지를 찾고, fetch-page 툴로 내용을 가져와 요약합니다. 이 과정이 자연어 대화 안에서 투명하게 이루어집니다.
지원 AI 도구 전체 목록 & 기능 비교
노션 MCP는 현재 아래 AI 도구들을 공식 지원합니다. 단순히 “연결된다”는 수준이 아니라, 각 도구마다 연결 난이도와 활용 범위가 다르기 때문에 자신의 사용 패턴에 맞는 도구를 먼저 파악해야 합니다.
| AI 도구 | 연결 난이도 | 주요 특징 | 요금 |
|---|---|---|---|
| Claude Desktop | ⭐ 쉬움 | GUI 설정, OAuth 지원, 가장 안정적 | 무료/Pro |
| Claude Code | ⭐⭐ 보통 | 터미널 명령어 1줄, 개발자 최적화 | Pro 이상 |
| Cursor | ⭐ 쉬움 | 설정 → MCP 메뉴에서 URL 입력 | 무료/Pro |
| ChatGPT | ⭐⭐ 보통 | Deep Research 연동 가능, 설정 메뉴 경유 | Pro 이상 |
| VS Code (Copilot) | ⭐⭐⭐ 복잡 | Command Palette → MCP 설정 파일 수동 입력 | Copilot 구독 |
| Windsurf | ⭐⭐ 보통 | 플러그인 마켓에서 Notion 검색 후 설치 | 무료/Pro |
| 안티그래비티 | ⭐⭐ 보통 | 사전 설정 커넥터 대신 커스텀 서버 방식 권장 | 무료 |
⚠️ 중요: 안티그래비티(Antigravity)의 경우, MCP 갤러리에 사전 설정된 ‘Notion 커넥터’는 더 이상 업데이트가 중단된 구버전 notion-mcp-server를 사용합니다. 반드시 커스텀 서버 URL(https://mcp.notion.com/mcp)을 직접 입력하는 방식으로 연결해야 합니다.
Claude Desktop 연동: 초보도 5분이면 끝나는 설정법
가장 많은 사람이 사용하는 Claude Desktop 기준으로 연결 방법을 단계별로 안내합니다. 2026년 현재 Claude Desktop은 MCP 설정을 GUI로 지원하기 때문에, JSON 파일을 직접 편집할 필요가 없어졌습니다.
-
1
Claude Desktop 앱 설치: claude.ai/download에서 최신 버전을 다운로드합니다. 웹 버전(claude.ai)은 MCP를 지원하지 않으므로 반드시 데스크톱 앱이 필요합니다. -
2
설정 진입: 앱 실행 후 상단 메뉴에서 Claude → Settings → Integrations 순서로 진입합니다. (macOS: ⌘ + 콤마) -
3
MCP 서버 추가: ‘Add MCP Server’ 버튼 클릭 → 서버 URL 입력란에https://mcp.notion.com/mcp를 입력합니다. -
4
OAuth 인증: 브라우저가 열리면서 노션 로그인 화면이 나타납니다. 노션 계정으로 로그인하고, 연결할 워크스페이스와 페이지 범위를 선택한 후 ‘Allow Access’를 클릭합니다. -
5
연결 확인: Claude Desktop 대화창에서@notion을 입력하거나 “내 노션 워크스페이스에서 최근 페이지 보여줘”라고 입력해 정상 작동 여부를 확인합니다.
# Claude Desktop config.json 예시 경로
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%\Claude\claude_desktop_config.json
{
“mcpServers”: {
“notion”: {
“url”: “https://mcp.notion.com/mcp”
}
}
}
수동 설정이 필요한 경우는 GUI 메뉴가 표시되지 않는 구버전 Claude Desktop을 사용할 때뿐입니다. 위 JSON을 해당 경로의 설정 파일에 추가하면 됩니다. SSE(구형 전송 방식)가 필요한 경우에는 URL을 https://mcp.notion.com/sse로 변경하면 됩니다.
Claude Code · ChatGPT · Cursor 연동법 한눈에 정리
Claude Code (터미널 1줄로 끝내기)
개발자라면 Claude Code를 통한 연동이 가장 빠릅니다. 터미널에 아래 명령어 하나를 실행하고 OAuth 인증만 거치면 즉시 사용 가능합니다.
claude mcp add –transport http notion https://mcp.notion.com/mcp
# 모든 프로젝트에 적용 (user 범위)
claude mcp add –transport http –scope user notion https://mcp.notion.com/mcp
# 팀 공유용 (프로젝트 루트에 .mcp.json 생성)
claude mcp add –transport http –scope project notion https://mcp.notion.com/mcp
설치 후 Claude Code 세션에서 /mcp를 입력하면 연결된 MCP 서버 목록과 OAuth 인증 진행 상황을 확인할 수 있습니다. 팀 프로젝트에서 --scope project로 설치하면 .mcp.json 파일이 생성되어 팀원이 동일한 노션 워크스페이스에 접근할 수 있습니다.
Cursor 연동 (설정 UI 활용)
Cursor는 설정 화면에서 직접 MCP 서버를 추가할 수 있습니다. Cursor Settings → Features → MCP Servers → Add 순서로 진입해 서버 이름(notion)과 URL(https://mcp.notion.com/mcp)을 입력하면 됩니다. 팀 공유가 필요하다면 프로젝트 루트에 .cursor/mcp.json 파일을 아래와 같이 생성합니다.
{
“mcpServers”: {
“notion”: {
“url”: “https://mcp.notion.com/mcp”
}
}
}
ChatGPT 연동 (Pro 이상 필요)
ChatGPT의 노션 MCP 연동은 Pro 플랜 이상에서 사용 가능합니다. ChatGPT 웹 인터페이스에서 설정 → 연결된 앱 → Notion MCP 추가로 진행하면 됩니다. Deep Research 기능과 함께 사용하면 노션 내부 데이터를 외부 검색 결과와 결합한 리서치 보고서를 자동 작성할 수 있어 매우 강력합니다.
실전 프롬프트 10선 — 노션을 진짜 AI 비서로 만드는 법
노션 MCP가 지원하는 핵심 도구는 크게 search(검색), fetch-page(페이지 내용 가져오기), create-page(페이지 생성), update-page(페이지 수정), create-database(데이터베이스 생성), add-comment(댓글 추가) 등으로 구성됩니다. 이 도구들을 자연어로 조합하면 아래와 같은 실전 작업이 가능합니다.
- 📋 회의록 구조화: “오늘 회의에서 논의한 내용이야: [회의 메모]. 노션 ‘회의록’ 데이터베이스에 날짜, 참여자, 결정사항, 액션 아이템 형식으로 새 페이지 만들어줘.”
- 🔍 스마트 검색: “지난 달에 작성한 마케팅 전략 관련 페이지들 찾아서 핵심 인사이트만 요약해줘.”
- 📊 데이터베이스 자동 업데이트: “프로젝트 태스크 데이터베이스에서 ‘진행 중’ 상태인 항목들 보여주고, 각 항목에 오늘 날짜로 마감 임박 경고 댓글 달아줘.”
- ✏️ 초안 작성 & 저장: “다음 키워드로 블로그 초안 작성하고 ‘콘텐츠 캘린더’ 데이터베이스에 ‘초안’ 상태로 저장해줘: [키워드 목록]”
- 📅 일정 정리: “지금 내가 말하는 이번 주 일정을 노션 캘린더 데이터베이스에 날짜별로 정리해서 넣어줘.”
- 🔄 페이지 업데이트: “‘2026 연간 목표’ 페이지 찾아서 Q1 리뷰 섹션에 아래 내용 추가해줘: [내용]”
- 📂 정보 수집·통합: “노션에서 경쟁사 분석 관련 페이지 전부 찾아서 공통 인사이트와 차별점을 표로 정리한 새 페이지 만들어줘.”
- 🗂️ 템플릿 자동 생성: “우리 팀 프로젝트 킥오프 미팅 템플릿 페이지를 노션에 만들어줘. 섹션: 목표, 이해관계자, 마일스톤, 리스크, 액션 아이템.”
- 💬 댓글 자동화: “‘제품 로드맵’ 데이터베이스에서 우선순위 1인 항목들 찾아서 각각에 ‘2026 Q2 검토 필요’ 댓글 달아줘.”
- 📑 리포트 생성: “노션 작업 데이터베이스에서 이번 달 완료된 항목 통계 뽑아서 주간 리포트 페이지 자동으로 만들어줘.”
💡 실전 팁: 노션 MCP의 search 도구는 단순 키워드 매칭이 아니라 의미 기반 검색(semantic search)을 지원합니다. “지난 분기 OKR 회고 있어?” 같은 질문 형식 프롬프트가 “OKR 2026 Q1″처럼 구조화된 검색어보다 훨씬 정확한 결과를 반환합니다.
속도·권한·보안 주의사항 — 모르면 낭패 보는 포인트
노션 MCP를 실전에서 사용하다 보면 반드시 마주치는 제약 사항들이 있습니다. 이를 미리 알고 프롬프트를 설계하면 오류 없이 사용할 수 있습니다.
API 속도 제한 (Rate Limit)
노션 MCP의 기본 요청 한도는 분당 평균 180회(초당 3회)입니다. 단, search 도구는 분당 30회로 더 엄격하게 제한됩니다. 검색을 병렬로 대량 실행하는 복잡한 프롬프트를 작성할 경우 속도 제한 오류가 발생할 수 있습니다. 이럴 때는 AI에게 “병렬 검색 줄이고 순차적으로 실행해줘”라고 요청하면 됩니다.
권한 범위 주의
⚠️ 중요: MCP 도구는 내가 노션에서 접근 가능한 모든 페이지와 데이터베이스에 동일하게 접근할 수 있습니다. OAuth 연결 시 공유할 워크스페이스 범위를 신중하게 설정하고, 민감한 개인 정보나 기밀 데이터가 담긴 페이지는 MCP 접근에서 제외하는 것을 권장합니다.
구버전 패키지 혼용 금지
GitHub에 있는 오픈소스 notion-mcp-server 패키지(구버전)는 현재 더 이상 권장되지 않습니다. 특히 안티그래비티(Antigravity)의 MCP 갤러리에 등록된 노션 커넥터가 이 구버전을 사용하고 있어 최신 기능 지원이 누락됩니다. 반드시 공식 원격 서버 URL(https://mcp.notion.com/mcp)을 직접 입력하는 방식을 사용하세요.
웹 클라이언트 미지원 (데스크톱 필수)
Claude.ai 웹 버전은 현재 MCP를 지원하지 않습니다. 반드시 Claude Desktop 앱을 설치해야 합니다. ChatGPT 역시 웹 인터페이스 일부 버전에서 MCP 연동이 불완전하게 동작할 수 있으므로, 문제 발생 시 공식 앱이나 최신 웹 버전을 사용하는 것이 안전합니다.
페이지 제목 명확하게 작성
MCP의 AI 에이전트는 페이지 제목을 기반으로 콘텐츠 구조를 이해합니다. 노션 페이지 제목이 “미팅_2026-03-13” 처럼 구체적일수록 AI가 올바른 페이지를 찾아 작업할 확률이 높아집니다. “새 문서” 같은 모호한 제목은 AI가 혼동할 수 있습니다.
❓ Q&A 5선
노션 MCP는 무료로 사용할 수 있나요?
연결 후 노션 데이터가 AI에게 다 노출되는 건가요?
기존 오픈소스 notion-mcp-server를 이미 설치했는데, 어떻게 해야 하나요?
notion-mcp-server는 공식 원격 MCP 서버로 교체하는 것을 권장합니다. Claude Desktop의 경우 설정 파일에서 기존 설정을 제거하고, 새로운 URL(https://mcp.notion.com/mcp)로 교체하면 됩니다. 구버전과 달리 API 키를 JSON에 직접 입력할 필요가 없고 OAuth로 자동 인증되므로 보안도 더 강화됩니다.
노션 MCP로 이미지나 파일도 업로드할 수 있나요?
노션 MCP와 노션 AI는 어떻게 다른가요?
🏁 마치며 — 총평
노션 MCP 연동은 2026년 현재 AI 생산성 도구 중에서 가장 실용적인 조합 중 하나입니다. 초기에는 Docker 설치에 JSON 파일 수동 편집까지 필요했지만, 지금은 URL 하나 입력하고 OAuth 버튼 클릭이 전부입니다. 진입 장벽이 사실상 사라진 셈입니다.
개인적으로 이 조합의 가장 큰 가치는 정보가 분산되는 문제를 해결한다는 점에 있다고 생각합니다. 회의록은 노션에 있고, AI와의 대화는 Claude에 있고, 코드는 Cursor에 있는 파편화 문제를 MCP가 연결 고리로 붙여 주는 것입니다. AI가 노션을 읽고 쓸 수 있다는 것은 곧 “내 지식 베이스를 AI가 맥락으로 이해한다”는 의미입니다.
아직 지원 범위(이미지 업로드 등)에 한계가 있고, search 도구의 분당 30회 제한은 대규모 워크플로에서 병목이 될 수 있습니다. 하지만 노션이 공식 MCP 서버를 계속 업데이트하고 있으므로, 지금 당장 연결해두고 사용 습관을 만들어 두는 것이 유리합니다. 설정에 5분도 걸리지 않으니, 오늘 바로 해보세요.
본 콘텐츠는 2026년 3월 13일 기준으로 작성되었으며, 노션 및 각 AI 도구의 정책·기능은 언제든지 변경될 수 있습니다. 최신 정보는 노션 공식 개발자 문서(developers.notion.com)를 반드시 확인하시기 바랍니다.
댓글 남기기