지난 포스팅에서 MCP(Model Context Protocol)의 이론과 아키텍처를 다뤘다면, 오늘은 실제로 Notion을 Cursor IDE에 연결하여 사용하는 실전 과정을 공유하려 합니다.

“이론은 알겠는데, 막상 해보려니 막막하다”는 분들을 위해, 단계별로 차근차근 설명하겠습니다. 제가 실제로 사용 중인 설정을 바탕으로 작성했으니, 따라하시면 바로 활용하실 수 있을 겁니다.

1. 왜 Notion을 MCP로 연결하는가?

Notion은 이미 강력한 지식 관리 도구입니다. 하지만 AI와 연결하면 그 활용도가 배가 됩니다.

  • AI가 내 Notion 데이터를 읽고 분석: “지난 달 특허 출원 현황을 요약해줘”라고 하면, Notion 데이터베이스를 직접 조회하여 답변합니다.
  • Notion에 직접 작성: “오늘 회의록을 Notion에 저장해줘”라고 하면, AI가 자동으로 페이지를 생성하고 내용을 정리합니다.
  • 실시간 동기화: Cursor에서 작업한 내용을 Notion에 자동으로 기록하거나, Notion의 변경사항을 Cursor에서 즉시 확인할 수 있습니다.

이 모든 것이 MCP 서버 하나로 가능해집니다.

2. Step 1: Notion API 키 발급받기

먼저 Notion에서 API 키를 발급받아야 합니다. 이 과정은 약 5분이면 충분합니다.

2.1 Notion Integration 생성

  1. Notion 웹사이트 접속: notion.so에 로그인합니다.
  2. Settings & Members 메뉴로 이동: 좌측 사이드바 하단의 “Settings & Members”를 클릭합니다.
  3. Connections 탭 선택: “Connections” 섹션에서 “Develop or manage integrations” 링크를 클릭합니다.
  4. New integration 버튼 클릭: 우측 상단의 “New integration” 버튼을 눌러 새 통합을 생성합니다.

2.2 Integration 설정

  • Name: 원하는 이름을 입력합니다 (예: “Cursor MCP Integration”).
  • Associated workspace: 연결할 워크스페이스를 선택합니다.
  • Type: “Internal”을 선택합니다 (개인용이므로).
  • Capabilities: 필요한 권한을 선택합니다.
    • Read content: Notion 페이지를 읽기 위해 필수
    • Update content: Notion에 작성하기 위해 필수
    • Insert content: 새 페이지 생성 시 필수

2.3 API 키 복사

설정을 완료하면 “Internal Integration Token”이 생성됩니다. 이 토큰이 바로 API 키입니다.

⚠️ 중요: 이 토큰은 한 번만 표시되므로, 반드시 안전한 곳에 복사해두세요. 나중에 다시 확인할 수 없습니다.

3. Step 2: Notion 페이지에 Integration 연결

API 키만으로는 부족합니다. Notion의 각 페이지나 데이터베이스에 이 Integration을 명시적으로 연결해야 합니다.

  1. 연결할 Notion 페이지 열기: Cursor에서 접근하고 싶은 페이지를 엽니다.
  2. 페이지 우측 상단의 “…” 메뉴 클릭: “Connections” 옵션을 선택합니다.
  3. 생성한 Integration 선택: 방금 만든 “Cursor MCP Integration”을 찾아 연결합니다.

이 과정을 각 페이지마다 반복해야 합니다. 또는 상위 페이지에 연결하면 하위 페이지들도 자동으로 접근 가능합니다.

4. Step 3: Cursor IDE에 MCP 서버 설정

이제 Cursor IDE에서 Notion MCP 서버를 연결하겠습니다.

4.1 Cursor 설정 파일 열기

Cursor는 MCP 서버 설정을 JSON 파일로 관리합니다. 설정 파일 위치는 운영체제마다 다릅니다.

  • Windows: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • macOS: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Linux: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

파일이 없으면 직접 생성하시면 됩니다.

4.2 MCP 서버 설정 추가

설정 파일에 다음 JSON 구조를 추가합니다:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion"
      ],
      "env": {
        "NOTION_TOKEN": "여기에_발급받은_토큰_입력"
      }
    }
  }
}

⚠️ 주의사항:

  • NOTION_TOKEN 값에 앞서 복사해둔 Internal Integration Token을 붙여넣습니다.
  • 따옴표 안에 정확히 입력해야 합니다.
  • 파일 저장 후 Cursor를 재시작해야 설정이 적용됩니다.

4.3 Cursor 재시작 및 확인

  1. Cursor 완전 종료: 모든 창을 닫고 프로세스를 종료합니다.
  2. Cursor 재실행: 다시 실행합니다.
  3. MCP 연결 확인: Cursor 채팅창에서 “Notion” 관련 도구가 사용 가능한지 확인합니다.

정상적으로 연결되었다면, Cursor의 AI가 Notion 페이지를 읽거나 작성할 수 있는 도구를 자동으로 인식합니다.

5. Step 4: 실제 활용 예시

설정이 완료되었다면, 이제 실제로 사용해봅시다.

예시 1: Notion 페이지 읽기

"내 Notion의 '프로젝트 대시보드' 페이지 내용을 요약해줘"

Cursor의 AI가 자동으로 Notion API를 호출하여 해당 페이지를 읽고, 내용을 분석하여 요약해줍니다.

예시 2: Notion에 새 페이지 생성

"오늘 회의에서 논의한 'Q1 특허 출원 계획'을 Notion에 새 페이지로 만들어줘. 
제목은 '2026 Q1 특허 전략'으로 하고, 오늘 날짜를 메타데이터로 추가해줘"

AI가 Notion API를 통해 새 페이지를 생성하고, 요청한 내용을 구조화하여 작성합니다.

예시 3: Notion 데이터베이스 조회

"Notion의 '특허 포트폴리오' 데이터베이스에서 상태가 '출원 완료'인 항목들을 찾아서 
표 형식으로 정리해줘"

Notion 데이터베이스를 쿼리하여 조건에 맞는 항목들을 필터링하고, 결과를 보기 좋게 정리해줍니다.

6. 트러블슈팅: 자주 발생하는 문제들

문제 1: “Notion API key is invalid” 오류

원인: API 키가 잘못 입력되었거나, Integration이 페이지에 연결되지 않았을 수 있습니다.

해결책:

  1. 설정 파일의 NOTION_TOKEN 값을 다시 확인합니다.
  2. Notion 페이지의 Connections 메뉴에서 Integration이 연결되어 있는지 확인합니다.
  3. Cursor를 재시작합니다.

문제 2: “You don’t have access to this page” 오류

원인: 해당 Notion 페이지에 Integration이 연결되지 않았습니다.

해결책: 접근하고 싶은 각 페이지의 Connections 메뉴에서 Integration을 명시적으로 연결해야 합니다.

문제 3: MCP 서버가 인식되지 않음

원인: 설정 파일의 JSON 형식이 잘못되었거나, Cursor가 재시작되지 않았을 수 있습니다.

해결책:

  1. JSON 형식이 올바른지 확인합니다 (쉼표, 중괄호 등).
  2. Cursor를 완전히 종료한 후 다시 실행합니다.
  3. Cursor의 개발자 도구에서 MCP 서버 로그를 확인합니다.

마치며: 지식이 살아 움직이는 순간

Notion과 Cursor를 MCP로 연결하면, 단순한 지식 저장소가 살아 움직이는 지능형 시스템으로 변합니다.

“내가 저장한 정보를 AI가 읽고, 분석하고, 새로운 인사이트를 도출해준다”는 경험은 정말 신기합니다. 특히 특허나 법률 문서처럼 구조화된 데이터를 다루는 분야에서는 그 효용이 더욱 크게 느껴집니다.

이제 여러분의 Notion도 AI와 함께 호흡하게 되었습니다. 지식이 단순히 쌓이는 것이 아니라, 활용되고 증폭되는 새로운 경험을 시작해보세요.

참고: Notion MCP 서버는 공식 MCP 서버 레지스트리에서 제공되는 오픈소스 프로젝트입니다. 더 자세한 설정 옵션이나 고급 기능은 MCP 공식 문서를 참고하시기 바랍니다.