Notion 30초 연결 가이드
Claude 앱에서 클릭 한 번

두 가지 길이 있습니다 — 빠른 길로 가세요

Anthropic이 노션 연결 방법 두 가지를 제공합니다. 거의 모든 경우 빠른 길이면 충분해요. 강의 청중 분들도 빠른 길로 시작하시면 됩니다.

Claude 앱 커넥터로 연결하기 (30초)

왜 이게 가능한가? Anthropic이 OAuth 백엔드를 호스팅해서, 토큰 발급·페이지 권한·키 저장을 다 자동 처리합니다. 사용자는 OAuth 팝업에서 페이지 선택 + 허용 클릭만 하면 끝.

따라하기

1. Claude Desktop 앱 실행 → 좌하단/우상단의 본인 프로필 → 설정 (Settings)
   또는 메뉴바 Claude → 설정… (Settings…) (⌘ ,)
2. 좌측 메뉴에서 커넥터 (Connectors) 클릭
3. 목록에서 Notion 찾기 → 우측 연결 (Connect) 버튼 클릭
4. 브라우저 팝업이 열리며 노션이 묻습니다 — "Claude(Anthropic)에 어떤 페이지 접근 권한을 줄까?"
   • 전체 워크스페이스에 권한 주기 — 어디든 자유롭게 쓰고 싶을 때
   • 특정 페이지만 골라 권한 주기 — "MCP 실습장" 같은 페이지만 노출하고 싶을 때
   💡 마음에 드는 옵션 선택 후 허용 (Allow / Confirm) 클릭
5. 브라우저 팝업이 닫히고 Claude 앱으로 돌아옴 → 커넥터 옆에 "연결됨" 표시
   이제 도구 권한 영역에 notion-fetch, notion-search, notion-get-comments 같은 항목이 보입니다. 각 도구를 "항상 허용" / "물어보고 허용" / "차단" 으로 설정 가능. 마케팅 용도면 "항상 허용" 추천.

(고급) 정밀 제어 길 — 통합 토큰 + JSON 편집

위 "빠른 길" (커넥터)로 연결을 끝내셨다면 이 섹션은 건너뛰셔도 됩니다. 워크스페이스의 특정 페이지만 정확히 분리·제어해야 하는 보안 요구가 있을 때만 진행하세요. 약 10분.

Notion에서 통합(Integration) 만들기

왜 이걸 하나요? Claude(또는 다른 AI)가 내 Notion에 들어올 수 있도록 "출입증"을 발급받는 단계예요. 이 출입증을 Integration Token이라고 부릅니다.

따라하기

1. 브라우저에서 notion.so/profile/integrations 접속
2. 우상단 + 새 통합 (+ New integration) 버튼 클릭
3. 다음 항목 입력
   • 이름 (Name): Claude Desktop (원하는 이름 아무거나 OK)
   • 연결된 워크스페이스 (Associated workspace): 본인 워크스페이스 선택
   • 유형 (Type): 내부용 (Internal) (기본값)
4. 저장 (Save) 클릭
5. 생성된 통합 페이지에서 구성 (Configuration) 탭 → 내부 통합 시크릿 (Internal Integration Secret) 항목 → 표시 (Show) → 복사 (Copy)
   secret_ 또는 ntn_으로 시작하는 긴 문자열이 토큰입니다.
6. 메모장이나 임시 파일에 토큰을 잠깐 붙여놓기 (3단계에서 씁니다)

사용할 Notion 페이지에 통합 연결하기

왜 이걸 하나요? 토큰이 있어도 "어느 페이지에 들어가도 되는지"는 별도로 허락해줘야 해요. Notion은 보안상 명시적으로 연결한 페이지에만 접근을 허용합니다.

따라하기

1. Notion에서 자동화 실습용 페이지를 1개 새로 만들기
   제목 예: MCP 실습장 · 이미 있는 페이지에 연결해도 되지만, 처음엔 깨끗한 새 페이지 추천
2. 그 페이지를 열고 우상단 ··· (점 세 개) 클릭
3. 메뉴 맨 아래 연결 (Connections) → 연결 대상 (Connect to) 클릭
4. 검색창에 1단계에서 만든 통합 이름(Claude Desktop) 입력 → 클릭
5. 확인 팝업이 뜨면 확인 (Confirm)

Claude Desktop에 MCP 등록하기

왜 이걸 하나요? Claude Desktop에게 "Notion이라는 도구를 쓸 수 있다"고 알려주는 마지막 단계입니다. 설정 파일(JSON)을 한 번만 편집하면 끝.

3-1. 설정 파일 열기

1. Claude Desktop 실행
2. 메뉴바 Claude → 설정… (Settings…) (⌘ ,)
3. 좌측 개발자 (Developer) 탭 클릭
4. Config 편집 (Edit Config) 버튼 → 설정 파일이 들어있는 폴더가 열림
5. claude_desktop_config.json 파일을 우클릭해서 OS에 맞는 기본 편집기로 열기
   • Windows: 파일 우클릭 → 연결 프로그램 → 메모장 (Notepad)
   • macOS: 파일 우클릭 → 다음으로 열기 → 텍스트 편집기 (TextEdit)
   ⚠️ macOS의 "메모 (Notes)" 앱과 헷갈리지 마세요. 메모는 노란 포스트잇 같은 앱이라 JSON이 깨집니다. 반드시 "텍스트 편집기 / TextEdit"입니다.

3-2. Notion MCP 설정 추가하기

파일이 비어 있거나 {}만 있다면 아래 내용으로 전체 교체:

// claude_desktop_config.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_여기에_토큰_붙여넣기\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

이미 다른 MCP가 등록되어 있다면 mcpServers 안에 "notion": { … } 블록만 추가하세요. (앞 항목 끝에 쉼표 잊지 말기)

3-3. 토큰 끼워넣기

위 JSON의 ntn_여기에_토큰_붙여넣기 부분을 1단계에서 복사한 실제 토큰으로 교체:

"Bearer ntn_AbCd1234EfGh5678IjKl9012MnOp3456QrSt7890UvWx"

저장 (⌘ S 또는 Ctrl S)

3-4. Claude Desktop 완전히 재시작

• macOS: ⌘ Q로 완전 종료 후 다시 실행 (창만 닫으면 안 됨!)
• Windows: 작업 표시줄 우클릭 → 종료 후 재실행

3-5. 연결 확인

1. Claude Desktop 새 채팅 창
2. 입력창 아래쪽에 🔌 아이콘 (또는 검색 및 도구 (Search and tools) 메뉴)를 보면 notion이 떠 있어야 함
3. 클릭해보면 사용 가능한 도구 목록(API-post-search, API-post-page 등)이 나옴

Claude한테 "Notion 페이지 만들어줘" 시키기

이제 진짜 자동화의 맛을 봅니다. Claude Desktop 채팅창에 아래 프롬프트를 그대로 복붙해보세요.

내 Notion의 "MCP 실습장" 페이지 아래에
"오늘의 할 일"이라는 새 페이지를 만들어줘.

페이지 안에는 체크박스 형태로
할 일 3가지 샘플을 넣어줘:
- 아침 스트레칭
- 이메일 답장
- 30분 산책

무슨 일이 일어나나요?

1. Claude가 도구 사용 권한을 묻는 팝업을 띄움 → 한 번 허용 (Allow once) 또는 항상 허용 (Always allow) 클릭
2. Claude가 Notion API를 호출해서 페이지 생성
3. Notion으로 가서 새로고침 → MCP 실습장 안에 오늘의 할 일 페이지가 생겨있음 🎉

다음 단계로 확장해볼 만한 것들

다른 도구와 엮어서 진짜 자동화 만들기

Notion 연결만으로는 "내가 Claude한테 시키는 것"까지만 됩니다. 사람이 안 시켜도 알아서 돌아가게 하려면 한 단계 더 필요해요.

이 부분은 별도 가이드에서 다룹니다.

부록 · Claude Code CLI 사용자라면

터미널 기반 Claude Code를 쓰시는 분은 3단계가 다음으로 바뀝니다.

# 한 줄 명령
claude mcp add notion \
  --env OPENAPI_MCP_HEADERS='{"Authorization":"Bearer ntn_여기에_토큰","Notion-Version":"2022-06-28"}' \
  -- npx -y @notionhq/notion-mcp-server

# 확인
claude mcp list

또는 프로젝트 루트에 .mcp.json 파일을 만들고 위의 3-2 JSON을 그대로 넣어도 됩니다.

자주 묻는 질문