MCP
Notion 연결 — MCP
MCP로 Notion을 연결하고 페이지 하나를 읽어 접근 범위를 확인할 수 있습니다.
단계 1 / 4
반복하는 작업 하나를 적고 그 작업에 필요한 외부 도구 하나만 정합니다
이 카드에서는 Notion으로 실습합니다.
확인
Notion에서 읽어 볼 페이지 하나와 연결이 필요한 이유 한 문장이 정해집니다.
단계 2 / 4
Claude Code 또는 Codex에서 연결을 요청합니다
아래 직접 실행 명령은 Claude Code용이며 Codex에서는 현재 환경의 연결 방법을 확인합니다.
그대로 붙여넣기
현재 쓰는 Claude Code 또는 Codex에서 Notion 연결 상태와 연결 방법을 확인해 주세요. MCP(Model Context Protocol)는 AI 도구와 외부 앱을 연결하는 규격이며 Notion 공식 서버 주소는 https://mcp.notion.com/mcp 입니다. 이미 연결되어 있으면 중복으로 추가하지 말고 새 연결이 필요하면 접근 범위와 설정 위치를 설명한 뒤 제 승인을 받아 진행해 주세요. 로그인과 계정 승인은 제가 직접 하며 비밀번호나 토큰 값을 채팅에 쓰도록 요청하지 마세요.
확인
현재 연결 상태와 필요한 설정이 나오고 새 연결의 권한과 로그인은 직접 확인한 뒤 진행합니다.
명령어로 직접 하기
일반 터미널(Claude Code 세션 밖)에서 실행합니다. Added HTTP MCP server 같은 확인 문구가 나오면 성공입니다.
그대로 붙여넣기
claude mcp add --transport http notion https://mcp.notion.com/mcp
단계 3 / 4
서버가 인증을 요구하면 현재 도구의 안내에 따라 로그인 화면을 열고 직접 승인합니다
Claude Code에서는 /mcp로 연결 상태를 확인할 수 있습니다.
확인
본인이 로그인과 공유 범위를 확인한 뒤 Notion 연결 상태가 표시됩니다.
단계 4 / 4
연결 상태를 확인하고 페이지 하나를 실제로 조회해 테스트합니다
그대로 붙여넣기
지금 연결된 외부 도구 목록과 각각의 연결 상태를 확인해 주세요. Notion에서는 제가 지정한 [페이지 주소] 하나만 읽고 제목과 첫 부분을 보여 주세요. 페이지를 수정하지 말고 접근할 수 없으면 필요한 권한을 알려 주세요.
확인
서버 목록에 notion이 연결 상태로 보이고 페이지 하나의 제목과 내용 일부가 나옵니다.
명령어로 직접 하기
일반 터미널(Claude Code 세션 밖)에서 실행합니다. notion 항목에 Connected 표시가 나오면 성공입니다.
그대로 붙여넣기
claude mcp list