Claude로 Notion 작성하기 (Notion MCP)

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

저번 포스팅에서는 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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2⃣ Claude Desktop을 설치 해주세요
(설치 주소 : https://claude.ai/download)

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

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

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

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

3⃣ Notion Desktop 설치해주세요 !
(설치 주소 : https://www.notion.com/desktop)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{

    "mcpServers": {

      "notionApi": {

        "command": "npx",

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

        "env": {

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

        }

      }

    }

  }

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