노션 MCP: AI를 워크스페이스에 연결하는 완벽 가이드

Notion MCP란?

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구와 데이터 소스를 사용할 수 있게 해주는 개방형 표준이에요. Notion MCP는 노션이 공식적으로 구현하고 호스팅하는 MCP 서버예요. AI 도구와 워크스페이스 사이에서, 에이전트가 직접 사용법을 파악해야 하는 API를 그대로 제공하는 대신 검색, 페이지 읽기, 페이지 편집, 데이터베이스 쿼리처럼 타입이 정의된 도구 모음으로 노션을 제공해요.

실제 사용 경험은 기존 통합 토큰 방식과 하늘과 땅 차이예요. OAuth로 한 번 인증하면 에이전트가 사용 가능한 도구를 자동으로 파악하고, 페이지 콘텐츠는 마크다운으로 전달돼요. 모델이 다루기 쉬울 뿐 아니라 노션의 블록 JSON보다 토큰 비용도 훨씬 적게 들어요.

호스팅 서버와 자체 호스팅 서버 비교

공식 실행 방식은 두 가지이며, 기본으로 선택할 방식은 명확해요.

접근 범위를 읽기 전용으로 제한하거나 외부 네트워크와 완전히 분리된 환경이 꼭 필요한 경우가 아니라면 호스팅 서버를 사용하세요. 노션은 오픈 소스인 GitHub의 notion-mcp-server가 더 이상 우선순위가 아니며, 운영이 종료될 수 있다고 명확히 밝혔어요.

설정: Claude Code, Claude Desktop, Cursor, ChatGPT

Claude Code (명령어 하나로 설정)

claude mcp add --transport http notion https://mcp.notion.com/mcp

다음에 실행하면 Claude Code에서 OAuth 인증 절차가 시작돼요. 접근을 승인하면 노션 도구가 자동으로 표시돼요.

Claude Desktop

설정 → 커넥터 → 디렉터리에서 노션을 추가하거나(클릭 한 번), URL https://mcp.notion.com/mcp로 사용자 지정 커넥터를 추가하세요.

Cursor

.cursor/mcp.json(프로젝트) 또는 전역 MCP 설정에 추가하세요.

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

ChatGPT 및 기타 도구

MCP 클라이언트로 작동할 수 있는 도구라면 모두 연결할 수 있어요. ChatGPT는 커넥터를 통해 MCP 연결을 지원해요. MCP를 지원하지 않는 도구는 Notion MCP를 전혀 사용할 수 없으며, 이는 설정이 “작동하지 않는” 가장 흔한 이유예요.

자체 호스팅 방식

notion.so/profile/integrations에서 내부 통합을 만들고, 에이전트에 제공하려는 특정 페이지에 대한 접근 권한을 부여한 다음 토큰으로 서버를 실행하세요.

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_****" }
    }
  }
}

에이전트가 실제로 할 수 있는 일

• 검색 — 내 페이지와 연결된 콘텐츠 전반을 검색해요. 사용자가 내용을 붙여 넣는 대신 에이전트가 필요한 맥락을 찾아요.
• 페이지를 마크다운으로 읽기 — 한 번의 호출로 페이지 전체 콘텐츠를 가져와요. 토큰 효율이 높고, 회의 노트의 녹취록도 포함돼요.
• 작성 및 편집 — 페이지를 만들거나, 콘텐츠를 덮어쓰거나, 특정 부분을 찾아 바꿀 수 있어요.
• 데이터베이스 작업 — 필터와 정렬을 적용해 데이터 소스를 쿼리하고, 속성을 업데이트하고, 항목을 만들어요.
• 이동 및 정리 — 페이지의 상위 페이지를 변경하고 구조를 관리해요.

실제로 이 기능이면 LLM 위키의 전체 작업 흐름을 처리할 수 있어요. 에이전트가 자료를 읽어 들이고, 요약을 노션에 작성하고, 페이지를 서로 연결한 뒤, 이렇게 쌓아 둔 내용을 바탕으로 질문에 답해요. 저희도 매일 바로 이 구성을 사용해요. 복사해서 붙여 넣을 수 있는 실행 예시는 Claude Code + 노션: 다섯 가지 워크플로에, 한계까지 솔직하게 담은 전체 구축 과정은 노션용 LLM 위키에 있어요.

보안과 권한

• 내 권한이 접근 범위의 상한선이에요. Notion MCP로 연결된 에이전트는 내 계정이 접근할 수 있는 내용에만 접근할 수 있어요. 그 이상은 접근할 수 없으며, 페이지별 권한을 우회할 수도 없어요.
• 최소 접근 범위는 직접 정해야 해요. 호스팅 서버는 항상 내 접근 권한 전체로 작동하므로, 민감한 데이터가 있는 워크스페이스에 실험적인 에이전트를 연결하기 전에는 신중히 검토하세요. 읽기 전용 접근이 필요하면 “콘텐츠 읽기” 권한만 있는 통합 토큰으로 자체 호스팅 서버를 사용하세요.
• Enterprise 관리 기능. Enterprise 요금제의 워크스페이스 관리자는 MCP 거버넌스를 활성화할 수 있어요. 승인된 AI 앱 목록, 연결 감사, 모든 연결을 해제하는 스위치를 제공해요.
• 데이터는 모델로 전달돼요. 에이전트가 읽는 모든 내용은 해당 에이전트의 컨텍스트에 포함돼요. AI 도구 자체의 데이터 정책도 보안 검토 범위에 포함하세요.

빠져 있는 지도: MCP가 제공하지 않는 것

MCP는 에이전트에게 검색하고, 읽고, 쓰는 손을 줘요. 하지만 눈은 주지 않아요. 모든 쿼리는 열쇠 구멍으로 들여다보는 것과 같아요. 에이전트가 보는 것은 이번에 가져온 페이지뿐이지, 워크스페이스 전체의 모습은 아니에요. 어떤 페이지가 허브인지, 어떤 군집이 있는지, 연결 없이 고립된 페이지가 어디에 있는지는 볼 수 없어요. 이는 검색의 문제가 아니라 그래프의 문제예요.

IVGraph는 바로 이 계층을 노션 + MCP 구성에 더해요. 사용자에게는 워크스페이스를 상호작용 가능한 3D 지식 그래프로 보여주고, 에이전트에게는 IVGraph LLM API를 통해 같은 구조를 프로그래밍 방식으로 제공해요. 검색, 노드 주변의 연결 구조, 페이지 간 최단 경로를 활용할 수 있어요. 에이전트는 MCP로 편집하고, 그래프는 사용자와 에이전트 모두에게 워크스페이스의 실제 모습을 보여줘요.

자주 묻는 질문