Notion 연결 — MCP

이 카드를 다루는 수업 자료를 잘 정리하는 법 Codex부터 GitHub 저장까지

주황색 퍼핏이 문서 장치와 노트북 사이에 연결 케이블을 꽂는 그림 — MCP를 연결하면 Notion 자료를 복사해 붙이지 않고 Claude가 직접 읽을 수 있습니다

Claude Code는 로컬 파일만 다루지 않습니다. Notion, Slack, 데이터베이스처럼 파일 시스템 밖에 있는 데이터를 매번 복사해 옮기면 서식이 깨지거나 최신 값을 놓치기 쉽습니다.

MCP는 Claude Code가 외부 서비스와 대화하는 표준 통로입니다. 추천 목록에 나온 MCP를 모두 연결할 필요는 없으며, 선택 기준은 스킬·플러그인·MCP 구분 카드에서 확인할 수 있습니다.

이 카드에서는 Notion 공식 MCP 하나만 연결하고 지정한 페이지를 수정하지 않은 채 읽어 봅니다. 연결 목록에 이름이 보이는 것만으로 끝내지 않고 실제 페이지 조회와 공유 범위를 함께 확인합니다.

설정 파일을 직접 만질 필요는 없습니다. “Notion 연결해 줘” 같은 요청으로 설치와 인증 과정을 Claude Code에게 맡길 수 있습니다.
연결이 끝나면 Notion 페이지 검색·조회·작성 같은 요청을 문장으로 할 수 있습니다.

기본 연결은 지금 열어 둔 폴더(프로젝트) 단위로 저장됩니다.

같은 도구를 다른 폴더에서도 쓰려면 그 폴더에서 다시 연결해야 합니다.
모든 폴더에서 공용으로 쓰고 싶으면 “이 연결을 모든 프로젝트에서 쓸 수 있게 해 줘”라고 요청하면 되고 이 경우 새 폴더를 열 때마다 다시 연결하지 않아도 됩니다.

순서 아래 실행 요청을 그대로 붙여넣어 지금 연결된 외부 도구부터 확인해 보세요.

이미지나 영상 생성이 필요한 사람은 이 실습을 마친 뒤 Higgsfield 연결 카드로 이어갑니다. 그 연결은 생성 전에 잔여 크레딧과 한 건의 예상 비용부터 확인합니다.

실행 순서

반복하는 작업 하나를 적고 그 작업에 필요한 외부 도구 하나만 정합니다. 이 카드에서는 Notion으로 실습합니다.

확인Notion에서 읽어 볼 페이지 하나와 연결이 필요한 이유 한 문장이 정해집니다.
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
```
확인현재 연결 상태와 필요한 설정이 나오고 새 연결의 권한과 로그인은 직접 확인한 뒤 진행합니다.
서버가 인증을 요구하면 현재 도구의 안내에 따라 로그인 화면을 열고 직접 승인합니다. Claude Code에서는 /mcp로 연결 상태를 확인할 수 있습니다.

확인본인이 로그인과 공유 범위를 확인한 뒤 Notion 연결 상태가 표시됩니다.
연결 상태를 확인하고 페이지 하나를 실제로 조회해 테스트합니다.
```
지금 연결된 외부 도구 목록과 각각의 연결 상태를 확인해 주세요. Notion에서는 제가 지정한 [페이지 주소] 하나만 읽고 제목과 첫 부분을 보여 주세요. 페이지를 수정하지 말고 접근할 수 없으면 필요한 권한을 알려 주세요.
```
명령어로 직접 하기

일반 터미널(Claude Code 세션 밖)에서 실행합니다. notion 항목에 Connected 표시가 나오면 성공입니다.
```
claude mcp list
```
확인서버 목록에 notion이 연결 상태로 보이고 페이지 하나의 제목과 내용 일부가 나옵니다.

직접 해보기

그대로 붙여넣기

지금 연결된 MCP 서버 목록을 보여주고 각각 정상 연결 상태인지 확인해 줘.

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

내 상황에 맞춰

[Notion 같은 자주 쓰는 외부 도구]를 아직 연결 안 했어. 연결하는 방법을 알려주고 가능하면 지금 바로 연결해 줘.

한 단계 더

방금 연결한 도구가 어디까지 접근할 수 있는지 확인해 줘. 공유된 페이지·데이터베이스 범위를 정리해 줘.

연결한 도구에서 페이지 하나를 실제로 불러와 확인해 보세요.

헷갈리기 쉬운 것

연결이 어느 날 401 오류로 갑자기 끊기는 경우가 있습니다. 인증 토큰이 만료된 것이므로 채팅창에 /mcp를 입력해 다시 로그인하면 됩니다. 어느 페이지·데이터베이스까지 공유했는지 확인하지 않고 쓰면 원치 않는 범위까지 접근이 열려 있을 수 있으므로, 연결 직후 접근 범위를 확인해 달라고 요청해 둡니다.

용어 풀이

전체 용어집 →

MCP: Model Context Protocol의 줄임말입니다. Claude Code가 Notion·Slack 같은 외부 서비스에 직접 접근할 수 있게 해 주는 연결 규격입니다.
인증: 그 서비스 계정이 본인 것이 맞는지 브라우저에서 로그인으로 확인하는 절차입니다.

2026-09-03 기준 · 출처 · Claude Code — MCP, Notion MCP overview

Notion 연결 — MCP

실행 순서

직접 해보기

헷갈리기 쉬운 것

관련 카드

용어 풀이