Notion MCP 설정 도우미
노션은 mcp.notion.com에서 공식 MCP 서버를 운영해요. 사용하는 AI 앱을 선택하면 정확한 명령어 또는 설정 파일과 로그인 절차를 안내해 드려요. 워크스페이스 권한은 그대로 유지돼요.
1사용하는 AI 앱
연결 범위
2Claude Code 설정
claude mcp add --transport http notion https://mcp.notion.com/mcp
- 터미널에서 명령어를 실행하세요.
- Claude Code를 실행하고
/mcp를 입력하세요. - notion을 선택하고 새로 열린 노션 창에서 접근을 승인하세요(OAuth).
- 터미널에서 명령어를 실행하세요.
- Claude Code를 실행하고
/mcp를 입력하세요. - notion을 선택하고 새로 열린 노션 창에서 접근을 승인하세요(OAuth).
- 설정 → 커넥터를 여세요.
- 목록에서 노션을 추가하거나, 위 URL로 사용자 지정 커넥터를 추가하세요.
- 노션 창에서 접근을 승인하세요. 채팅의 도구 메뉴에 노션 도구가 표시돼요.
- ChatGPT 설정을 열고 커넥터(앱) 섹션을 찾으세요.
- 노션을 연결하세요. 사용 중인 요금제에서 사용자 지정 커넥터를 지원한다면 위 URL로 사용자 지정 MCP 커넥터를 추가해도 돼요.
- 노션 창에서 접근을 승인하세요.
- 코드 위에 표시된 파일을 만들거나 열고 코드를 붙여 넣으세요(파일에 내용이 있다면 기존 서버 설정과 합쳐 주세요).
- Cursor 사이드바에서 사용자 지정을 열고 노션을 활성화하세요.
- 노션 로그인을 완료하세요(OAuth).
- 워크스페이스에
.vscode/mcp.json을 만들고 코드를 붙여 넣으세요. - 명령 팔레트에서 MCP: 서버 목록을 실행하고 notion을 시작하세요.
- 노션 로그인을 완료하세요(OAuth).
- 명령 팔레트에서 MCP: 사용자 구성 열기를 실행하고 서버 설정을 붙여 넣으세요.
- MCP: 서버 목록을 실행하고 notion을 시작하세요.
- 노션 로그인을 완료하세요(OAuth).
- 코드 위에 표시된 설정 파일에 해당 코드를 추가하세요.
- 터미널에서
codex mcp login notion을 실행하세요. - 노션 창에서 접근을 승인하세요.
- 클라이언트가 원격 MCP 서버를 지원한다면 Streamable HTTP URL을 사용하세요.
- 구형 클라이언트는 SSE URL을, 로컬 명령어만 실행하는 클라이언트는 STDIO 브리지를 사용하세요.
- 클라이언트에서 요청하면 노션에 로그인하세요(OAuth).
연결 후에는 이렇게 요청할 수 있어요
- 1“내 지난주 회의록을 찾아서 아직 완료하지 않은 후속 작업을 목록으로 정리해 줘.”
- 2“프로젝트 데이터베이스에 출시용 페이지를 만들고 체크리스트도 넣어 줘.”
- 3“리서치 위키에서 가격 책정에 관한 내용을 모두 요약해 줘.”
호스팅형과 자체 호스팅형의 차이, 에이전트가 할 수 있는 일과 없는 일, 보안까지 자세한 내용은 Notion MCP 가이드에서 확인하세요. Claude Code를 매일 사용하시나요? Claude Code + Notion MCP를 살펴보세요.
자주 묻는 질문
Notion MCP 서버 URL은 무엇인가요?
https://mcp.notion.com/mcp(Streamable HTTP)예요. 구형 클라이언트는 https://mcp.notion.com/sse를 사용할 수 있고, 로컬 명령어만 실행하는 클라이언트는 npx -y mcp-remote https://mcp.notion.com/mcp 브리지를 사용할 수 있어요.
API 키나 통합 토큰이 필요한가요?
아니요. 호스팅형 Notion MCP에서는 OAuth로 로그인해요. 노션 창에서 접근을 승인하면 돼요. 토큰은 오픈 소스 자체 호스팅 서버에만 필요하며, 노션은 이 서버를 더 이상 적극적으로 유지 관리하지 않아요.
연결은 됐는데 AI가 내 페이지를 볼 수 없어요
AI는 내 노션 권한으로 작동해요. 올바른 워크스페이스에 로그인했는지 확인하세요. Enterprise 요금제를 사용한다면 관리자에게 해당 앱의 MCP 사용이 승인되었는지 문의하세요.
이 도우미는 무료인가요? 내 데이터에 접근하나요?
무료이며 계정도 필요 없어요. 브라우저에서 텍스트만 구성하며, 내 노션이나 AI 앱에는 전혀 접근하지 않아요.
MCP는 페이지를 읽고, IVGraph는 페이지 사이의 연결을 보여줘요
워크스페이스의 모든 페이지, 백링크, 데이터베이스 관계를 인터랙티브 3D 그래프로 살펴보세요. 노드 500개까지 무료예요.
노션으로 로그인