Claude로 Notion 작성하기 (Notion MCP)

안녕하세요 ! 오랜만입니다 😊ㅎㅎ저번 포스팅에서는 MCP에 대해 알아봤었는데오늘은 실제로 이 MCP로 무엇을 할 수 있냐!에 대해 알아보도록 하겠습니다
#mcp#claude#notionMcp#notion
avatar
2025.06.03
·
11 min read

안녕하세요 ! 오랜만입니다 😊ㅎㅎ

저번 포스팅에서는 MCP에 대해 알아봤었는데

오늘은 실제로 이 MCP로 무엇을 할 수 있냐!에 대해 알아보도록 하겠습니다.

일반인들 기준으로는 가장 유용한 플랫폼은 Notion이라 생각되어

Claude로 Notion을 연결시켜 한 번 작성해보도록 하겠습니다 !

또한 일반인들도 충분히 따라하실 수 있도록 일반인 관점에서 작성해보도록 하겠습니다 !

🌟본 포스팅은 Window 환경에서 진행합니다 !!🌟


📦 우선 준비물은 다음과 같습니다 !

1. Node.js

- Notion과 연결시키기 위한 통로라고 보시면 됩니다.

2. Claude Desktop (유료 버전)

- 크롬 브라우저에서 사용하는 것이 아닌, 내 컴퓨터에 클로드 프로그램을 설치합니다 !

- 또한 무료버전은 제약이 많기 때문에 유료 버전을 추천 드립니다 !!

- 스마트폰으로 클로드 앱으로 결제하시면 원화로 결제해서 더 저렴합니다 ㅎㅎ

3. Notion Desktop (선택)

- 굳이 설치를 안해도 되지만 편의성을 위해 Notion도 프로그램으로 설치합니다 !

4. VS Code (선택)

- MCP 연결을 위해 수정해야되는 부분이 있는데 그냥 코드 편집기라고 생각하시면 됩니다 !


1⃣ node.js를 설치해줍니다

(설치 주소 : https://nodejs.org/ko)

6548

위 빨간 사각형을 눌러서 설치하시고, 나온 파일을 실행시켜 줍니다 !

이후로 계속 설치를 진행해줍니다.

65496550655165526553

이 단계는 Node.js를 도와주는 보조 도구를 설치하는 과정으로

앞으로 필요한 기능이 문제 없이 작동하게끔, 한 번에 설치하는 옵션입니다 !

6554

이 과정에서 install을 누르면 예/아니오 누르는 창이 뜰텐데 반드시 '예' 를 눌러주셔야 됩니다 !!

6555

이렇게 Finsh를 누르게 되면 node.js 설치가 끝납니다 이후 cmd(까만 창)이 뜰텐데

이후에 아무런 키나 두 번 눌러주시면 아까 말씀드렸던 보조도구들을 설치하기 시작합니다

6556

이후 또 예/아니오 창이 뜰텐데 반드시 '예'를 눌러주시고 누르신 후에는

PowerShell이라는 파란창이 뜨고 설치가 시작됩니다

이 단계는 자동으로 필요한 도구들을 설치하는 화면입니다

(10분 정도 걸립니다 ! 잠시만 기다려주세요 !!!!)

6557

이후 정상적으로 설치가 끝났다면 다음 로 넘어가시면 됩니다 !


혹시나 다음과 같은 상황이라면 아래처럼 진행해주세요

6558

해당 화면을 닫기를 누르시고 작업 표시줄에 Visual Studio Installer 라고 검색해주세요

655965606561


2⃣ Claude Desktop을 설치 해주세요

(설치 주소 : https://claude.ai/download)

6562

똑같이 설치 이후 프로그램을 실행시켜 줍니다

6563

실행 이후 시작하기 버튼을 눌러 본인 계정을 로그인해주세요 !

6564

로그인 이후 빙글빙글 도는 로딩바가 지속되는 경우 종료 후 재실행 해주세요

6565

정상적으로 설치했다면 다음과 같이 Claude Desktop이 실행됩니다 !

3⃣ Notion Desktop 설치해주세요 !

(설치 주소 : https://www.notion.com/desktop)

6566

설치 후 프로그램 실행시켜주시면 됩니다 !

6567

이후 본인 계정으로 로그인해주세요 !

6568

VS 코드 설치하기

(설치주소 : https://code.visualstudio.com/)

https://velog.io/@jjoung-2j/Visual-Studio-Code-%EC%84%A4%EC%B9%98-%EB%B0%8F-%EC%84%A4

해당 VS Code는 재설치하기엔 제가 설치된 파일이 많아서 🥹 설치 방법 포스팅을 잘 해놓으신 분 링크를 남겨 놓을게요 !!


5⃣ 본격적으로 Notion MCP를 통해 Claude Desktop이랑 연결시키기 !!

https://www.notion.com/my-integrations

노션에 로그인을 한 이후 위 경로로 이동하시면 다음과 같은 화면이 나옵니다 !!

6569

이후 부터는 사진을 보고 차근차근 따라와주세요 !!

65706571

우선 API 이름에 사진과 같이 내 API 이름을 설정해주시고

워크 스페이스는 개인 워크 스페이스를 선택해줍니다

🌟반드시 유형은 프라이빗으로 해주세요 !! (개인정보 보호 목적)

6572

저장하시면 다음과 같은 알림이 뜹니다 !

6573

이후 사진과 같이 API 관리 창이 뜹니다 기본적으로 크게 수정할 부분은 없으며

절대 프라이빗 API 통합 시크릿 키는 유출되면 안됩니다 !!!

65746575

이후 사용 권한 탭으로 이동해서 Claude가 수정할 수 있도록 페이지를 열어줍니다 !

저는 그냥 모든 페이지를 다 열어주도록 하겠습니다 😀 ㅎㅎ

🌟 이후 Claude Desktop으로 이동해주세요 !

6576

6577

설정 편집을 누르게 되면 다음과 같은 폴더로 이동하게 됩니다 !

6578

이후 더블 클릭해서 VS Code로 실행시켜주시면 다음과 같은 화면이 나옵니다 !!!

6579

이 부분에 다음 코드를 복사해서 우선 붙여넣어 주세요 !

{

    "mcpServers": {

      "notionApi": {

        "command": "npx",

        "args": ["-y", "@notionhq/notion-mcp-server"],

        "env": {

          "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer [Notion 프라이빗 키를 넣어주세요요]\", \"Notion-Version\": \"2022-06-28\" }"

        }

      }

    }

  }

🌟 이후 노션 API 관리 사이트로 이동해주세요 !

6580

사진의 표시하기 버튼을 누르면 Key가 보입니다 ! 해당 부분을 복사해주세요 !

복사 후 "[Notion 프라이빗 키를 넣어주세요]" 부분(대괄호 포함)을 지우고 복사한 키를 넣어주세요 !

Bearer과 Key 사이에는 반드시 공백 하나가 있어야됩니다 !

Ex) "Bearer ntn_xxxxx"

이후 Ctrl + S를 눌러주시고 VS Code를 종료해주세요 그 다음 Claude Desktop을 재실행 해줍니다 !!

6581

이제 화면과 같이 도구 모양 버튼을 눌러주시면 notionApi라고 뜨게 됩니다 ㅎㅎ


🎉축하드립니다 ! Notion MCP 연결이 되었습니다 !!

이제 실습을 하러 가볼까요? 👨‍🔬

6582

사진과 같이 "Notion MCP가 연결되어있어?"라는 질문으로 대화를 시작합니다

6583

👀 이렇게 정상적으로 연결이 완료된 것을 볼 수 있습니다 !

이후 이 포스팅을 보시는 분들을 위해 환영 인사글의 페이지를 생성해보도록 하겠습니다 !

65846585

권한은 요청 단위별로 허용해주시거나 귀찮으시면 그냥 항상 허용 누르셔도...ㅎㅎ 대신 요청 단위별로 수락해주시는 게 더 안전합니다 !

6586

이렇게 클로드가 직접 페이지를 만들어서 새로운 글을 작성해줬습니다 !

6587

😀 이렇게 오늘은 Claude를 사용한 Notion 연결을 통해 MCP에 대해서 알아보았습니다 ㅎㅎ 다들 차근차근 따라해보시면 금방 성공하실 거예요 !!

다음에도 좋은 글로 다시 등장하겠습니다 !! 수고하셨습니다 !!!!







- 컬렉션 아티클