Model Context Protocol(MCP)는 AI 도구와 외부 시스템을 연결하는 Claude의 Anthropic에서 2024년 말에 제안한 표준으로, 커서(Cursor)나 클로드(Claude)와 보통 연동해서 많이 쓴다. 이번 포스트에서는 내가 쓰고 있는 Cursor에서 노션(Notion) MCP를 설정하고 활용하는 방법에 대해서 자세히 설명하고, 간단한 예시를 안내하려고 한다.
MCP란?
MCP는 AI 어시스턴트가 실시간으로 다양한 시스템에 접근할 수 있도록 하여, 단순한 대화를 나누는 AI를 넘어 실제 액션을 취할 수 있는 에이전틱 AI 도구로 변화시킨다. 포스트의 주 목적은 Notion에서 활용하기 위함이니, MCP가 어떻게 구성되어 있는지 간단하게 정리만 하고 넘어가도록 하겠다.
MCP의 아키텍처와 구성 요소
MCP의 아키텍처는 네 가지 핵심 구성 요소로 이루어져 있다:
- 호스트 어플리케이션: Cursor, Claude Desktop과 같은 AI 도구
- MCP 클라이언트: 호스트 내에서 MCP 서버와의 연결을 관리
- MCP 서버: 특정 시스템(Notion, Github 등)의 기능을 노출
- 트랜스포트 레이어: HTTP+SSE 또는 STDIO를 통한 통신 매커니즘
그럼 바로 Notion MCP에 대해서 알아보자.
Notion MCP의 이해
Notion MCP가 제공하는 기능
Notion MCP는 AI 도구(호스트)가 Notion 워크스페이스와 직접 상호작용할 수 있도록 하는 다리 역할을 한다. 주요 기능을 다음과 같다:
- 페이지 생성 및 수정: 새 페이지 생성, 기존 페이지 업데이트
- 데이터베이스 조작: 레코드 추가, 수정, 삭제 및 검색
- 실시간 데이터 접근: 최신 Notion 콘텐츠에 즉시 접근
- 구조화된 데이터 처리: 데이터베이스 쿼리 및 분석
실제로 제공하는 함수들의 리스트를 Cursor 내에서 미리 살펴보면 다음과 같이 함수명이 적혀있는 것을 볼 수 있다. 함수명만 봐도 어떤 업무를 수행하는지 한눈에 확인 가능하다.
필요한 도구 및 계정
- Cursor IDE 혹은 Claude 설치
- Notion Integration 생성 및 API 토큰 획득
자 그럼 다음으로는 Notion API 토큰 생성하는 단계로 넘어가보자.
Notion API 토큰 생성
Integration 생성 단계
- Notion 개발자 페이지 접속: https://www.notion.so/profile/integrations
- 새 Integration 생성: "New Integration" 버튼 클릭
- 기본 정보 입력:
Name: "Cursor MCP Integration"
Associated workspace: 대상 워크스케이스 선택
Capabilities: Read content, Update content, Insert content (초기 세팅) 선택 - Integration 토큰 복사: 생성된 토큰을 안전한 곳에 보관 (API 키는 자신 외에 아무에게도 공유하지 말자)
API 설정을 하고나면 내 API 키와 승인할 기능을 다음과 같이 설정할 수 있다. 목적에 맞게 설정하면 된다.
이제 Cursor에 MCP 서버 설정만 하면 작업을 하기 위한 모든 기본 작업은 완료됐다. Cursor에서 MCP 서버를 설정해보자.
Cursor에서 MCP 서버 설정
Cursor에서는 Notion MCP를 직접 세팅하는 방법과 간편하게 Notion에서 버튼 클릭만으로 세팅하는 방법이 있는데, 직접 설정하는 방법에 대해서 간략하게 설명하면 File > Preferences > Cursor Settings > MCP & Integrations으로 들어가서 New MCP Server 버튼을 누르고 mcp.json에 추가하여 세팅을 하면 된다. 여기서는 Notion에서 공식으로 제공하는 방법에 대해서 좀 더 자세하게 다루겠다. 그냥 복잡한 세팅 없이 버튼만 눌러주면 되니 따라하기도 쉽다.
노션 페이지 접속
1. 아무 페이지나 들어가서 우측 상단 점 세개 클릭 후, manage connections 클릭.
2. 연결 가능한 옵션 중 Notion MCP에 해당하는 버튼 클릭 후, 사용하는 AI tool 클릭 (여기서는 Cursor connect).
MCP 설정
1. 위의 버튼을 누르면 Cursor로 넘어와 install 버튼 누르고 connect만 눌러주면 마지막 한 스텝이 남았다.
2. 그러면 이제 인증을 하라고 웹 페이지가 하나 뜨면서, MCP 연동이 마무리 된다.
Notion MCP 활용 예시
pdf 파일의 표 노션에 작성
내가 실험해본 예시는 데이터가 많이 담긴 pdf의 테이블을 노션으로 동일하게 테이블로 옮겨보는 것이었는데, 다음의 가공 과정을 거쳤다:
- 커서에서 토큰 사용량이 많이질 것 같아 데이터 가공은 퍼플렉시티(perplexity)에 pdf를 읽어서 csv로 변환하도록 했다.
- 이 csv를 cursor의 context에 추가를 해서 노션에 테이블 형태로 붙여 넣도록 했다.
퍼플렉시티에서 ac.kr 혹은 .edu 도메인의 이메일을 소지하고 있는 학생의 경우, 다음의 링크를 통해 12개월 + 1개월의 무료 사용 기간을 제공하고 있으니 적격 대상이라면 다음의 링크를 통해 가입을 하면 된다.
General하게 많은 페이지를 수정하는 경우가 아니라면, 어떤 특정 페이지를 변경하길 원하는지 AI가 알기 위해 페이지의 고유 ID를 prompt에 포함시켜줄 필요가 있다.
프롬프트에 따른 결과를 다음과 같이 공유한다.
" 노션 ID - [ID 번호]에 내가 제공한 테이블 작성해서 붙여 넣어줘"
-> csv 파일 그대로 붙여넣음. 말이 조금 애매했다. 다음 프롬프트에 잘 알아듣도록 구체적으로 지시가 필요했다.
"방금 노션 페이지에 테이블로 붙여넣어 달라는 의미였어. 그대로 텍스트를 붙여넣는게 아니고."
-> 그랬더니 테이블에 관련 데이터를 붙여넣기 시작했다. 약 1~2분 가량 소요됐다.
다음과 같이 관련 기능들(Calling MCP Tool, Calling Notion Update page)을 AI가 생각하며 적절하게 호출을 하면서 관련 작업을 수행하게 된다.
자료가 보안 자료를 활용했기 때문에 결과를 말로 대체했는데, 다음 예시에서는 조금 더 구체적인 상황을 부여했을 때 mcp로 어디까지 할 수 있는지를 살펴보겠다.