Weft
KO

Notion MCP: Claude, Cursor, Codex, ChatGPT에 Notion을 연결하는 방법

Weft 창업자 Andrei Finogeev ·

Notion의 공식 MCP 서버는 https://mcp.notion.com/mcp에 호스팅되어 있고(Streamable HTTP, SSE 대체 방식 포함) OAuth로 로그인합니다. Business와 Enterprise 워크스페이스는 MCP 토큰도 쓸 수 있습니다. 모든 Notion 요금제에서 작동합니다. 비서의 커넥터나 플러그인 라이브러리를 열어 Notion을 검색하고 로그인하거나, Claude Code, Cursor, VS Code, Codex에서 URL을 추가하세요. 예전 오픈 소스 로컬 서버는 더 이상 관리되지 않습니다.

Notion MCP 한눈에 보기

서버 URLhttps://mcp.notion.com/mcp. SSE 대체 방식은 /sse
로그인OAuth. Business와 Enterprise에서는 MCP bearer 토큰
무료 요금제가능. “Notion MCP works on every plan”
요청 한도분당 180회(Business와 Enterprise는 600회). 데이터 소스 쿼리는 초당 약 3회
삭제있음. 페이지와 데이터베이스는 휴지통으로
유료 요금제Plus 멤버당 월 $10(연간, 월간 $12). Business $20($24)

“명시 없음”은 Notion이(가) 밝히지 않았다는 뜻입니다. 가격은 좌석당 미국 달러 정가이며, 세금과 지역별 가격은 다를 수 있습니다.

비서별 Notion MCP 설정 방법

Claude(웹과 데스크톱)

Customize → Connectors(또는 채팅에서 “+” → Connectors)에서 디렉터리의 Notion을 고르고 로그인합니다.

Claude Code

서버를 추가한 다음 Claude Code에서 /mcp를 실행하고 로그인하세요. Notion은 Claude Code 플러그인(makenotion/claude-code-notion-plugin)도 제공합니다.

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

Cursor

.cursor/mcp.json에 Notion을 추가하고 켠 다음 로그인을 마칩니다.

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

VS Code(Copilot)

.vscode/mcp.json에 "type": "http"로 서버를 추가한 다음 “MCP: List Servers”를 실행하고 서버를 시작합니다.

Codex

~/.codex/config.toml에 추가한 다음 로그인합니다.

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

# then: codex mcp login notion

ChatGPT

Notion 문서에는 ChatGPT 설정 단계나 요금제 목록이 없습니다. OpenAI는 ChatGPT에서 Notion 앱을 제공하지만, 그 앱이 무엇을 쓸 수 있는지는 OpenAI의 현재 페이지에서 확인하지 못했습니다.

AI가 Notion에서 할 수 있는 일

  • 페이지 검색과 가져오기. 페이지 만들기(데이터베이스 템플릿에서도)와 내용, 속성 수정.
  • 데이터베이스를 작업 목록으로 쓰기: 행 만들기, 속성 수정, 저장된 보기와 데이터 소스 쿼리, 보기 만들기.
  • 데이터베이스와 데이터 소스 만들기. 댓글과 수정 제안. 페이지 이동, 복제, 삭제, 복원.
  • 최대 20 MiB의 이미지와 파일 업로드. 캘린더 일정과 회의록.

알아 둘 한계

  • 워크스페이스 멤버만 연결할 수 있고 게스트는 안 됩니다.
  • 요청 한도는 모든 도구 호출에 적용됩니다. 분당 180회, Business와 Enterprise는 600회.
  • SQL 스타일 쿼리는 Notion AI가 있는 Business 또는 Enterprise에서만 무제한이며, 커넥터 검색도 같은 조건이 필요합니다.
  • 위치를 지정하지 않고 만든 페이지는 비공개 페이지가 됩니다.
  • Notion 데이터베이스는 당신이 작업 목록으로 다듬는 표입니다. 에이전트가 작업을 맡거나 진행을 보고한다는 개념은 기본으로 없습니다.

AI와 일할 때 Notion인가, Weft인가?

작업이 문서와 위키 옆에 있고 비서 하나가 양쪽을 모두 다루길 원한다면 Notion을 고르세요. MCP 서버의 범위가 넓고, Notion이 호스팅하며, 모든 요금제에서 무료입니다.

직접 설계하는 데이터베이스가 아니라 AI가 운영하는 작업 보드를 원한다면 Weft를 고르세요. Weft는 바로 쓸 수 있는 Scrumban(백로그, 스프린트, 검토를 기다리는 완료 작업 한도)이고, 도구는 비서가 일을 직접 하도록 만들어졌습니다. 작업 맡기, 진행 보고, 받은 편지함에서 당신을 기다리는 질문, 결정 기록. Free를 포함한 모든 요금제의 ChatGPT에서 작동합니다.

휴대폰에 띄운 Weft 보드의 Doing 컬럼: AI 비서가 맡은 작업 세 개, 각각 AI 표시가 붙어 있음
비서가 다음 작업을 맡습니다. 카드마다 누가 작업 중인지 보입니다.
AI가 만든 Weft 작업이 완료된 모습. 비서가 남긴 결과: 무엇을 고쳤는지, 테스트 실행 40회가 통과했다는 내용
비서는 일을 마치면 영수증을 남깁니다. 무엇을 했고 어떻게 확인했는지.
Weft 무료로 써 보기MCP 지원 작업 관리자 12개 비교

Weft 설정: ChatGPT에서 Weft · Claude에서 Weft · Claude Code에서 Weft · Cursor에서 Weft · Codex에서 Weft

자주 묻는 질문

Notion MCP 서버 URL은 무엇인가요?

https://mcp.notion.com/mcp입니다. 클라이언트가 Streamable HTTP를 지원하지 않을 때만 https://mcp.notion.com/sse를 쓰세요.

Notion MCP 서버는 무료인가요?

네. Notion은 Notion MCP가 모든 요금제에서 작동한다고 합니다. 일부 검색 기능은 Notion AI가 있는 Business 또는 Enterprise가 필요합니다.

오픈 소스 notion-mcp-server를 써야 하나요?

Notion에 따르면 makenotion/notion-mcp-server는 더 이상 활발히 관리되지 않으며, 호스팅 서버를 권장합니다. 로컬 서버는 최후의 수단이라고 합니다.

AI가 Notion 데이터베이스의 작업을 관리할 수 있나요?

네. 호스팅 서버로 행을 만들고, 속성을 수정하고, 저장된 보기를 쿼리할 수 있으므로 데이터베이스가 작업 목록 역할을 합니다.

출처

2026년 11월 11일에 읽음.

다른 MCP 설정 가이드