이전에 MCP의 모든 것라는 제목으로 MCP에 관한 포스팅을 한 적이 있습니다. 이번엔 그 MCP를 활용하여 Claude Desktop과 Notion을 연결하는 간단한 실습을 해보았는데, 코딩을 모르는 사람도 손 쉽게 할 수 있을 정도로 방법이 매우 간단합니다. 아래 순서를 따라오시면 클로드에 프롬프트를 주어 노션에 글을 생성하실 수 있습니다.
1. 클로드 데스크탑 설치
우선, 클로드 공식 홈페이지에서(https://claude.ai/download) OS(윈도우, 맥 등)에 맞는 클로드 데스크탑 앱을 설치합니다.
2. 노션에서 API 키 받기
노션 개발자 페이지(https://www.notion.so/my-integrations)에 접속하여 새 Integration을 생성(=API 키 생성)합니다.(API 통합 이름은 본인이 편한 이름으로 지정하면 됩니다.)
그리고 읽기, 쓰기 권한 포함 내가 사용하고자 하는 권한을 모두 체크합니다.
다음으로 사용 권한 탭으로 가서 오른쪽에 파란 글씨로 적힌 편집 권한을 클릭하면 아래와 같이 나의 개인페이지 목록이 뜹니다. 편집을 허용할 페이지에 체크해주면 됩니다. 저는 테스트를 위해 "GET A JOB" 이라는 페이지를 새로 만들어서 연결되도록 해봤습니다.
3. Smithery AI 회원가입 및 노션 MCP 선택
Smithery AI에 회원가입을 하고 notion을 검색하고 사용량이 가장 많은 것 중 하나를 클릭하여 위에서 발급 받은 노션 API키를 입력합니다. (이 링크는 제가 이용한 링크입니다.)
발급 받은 노션키를 입력하면 JSON 코드가 보여지는데 해당 코드를 그대로 복사합니다.
4. 클로드 데스크탑에서 설정 편집
이제 복사한 JSON 코드를 클로드 데스크탑에 붙여 넣어야 하는데요,
클로트 데스크탑을 켜서 사이드바의 내 ID → 설정 → 개발자 → 구성 편집을 누르면 claude_desktop_config.json 파일이 보입니다. 이 파일을 열어서 복사한 JSON 코드를 붙여넣어주면 됩니다.
5. 클로드 데스크탑 완전 종료 후 재시작
JSON 코드를 붙여넣은 후에는 클로드 데스크탑을 종료한 뒤 재시작 해야하는데, 단순 창 닫기가 아니라 시스템 트레이에서 완전 종료(Quit) 후 재실행 필요합니다.
MCP 서버가 정상적으로 연결 되었다면 위의 사진처럼 웹 검색 부분에 연결한 API의 이름이 보이게 됩니다.
그리고 해당 탭을 클릭하면 활성화된 메서드를 확인 가능합니다. 참고로 저의 경우엔 클로드 데스크탑을 재실행해도 바로 적용이 안돼서 노트북을 재부팅하니 정상적으로 연결이 되었습니다. 간혹 시간이 좀 필요한 경우도 있다고 하니, 클로드 데스크탑을 열었을 때 에러 메세지가 따로 뜨지 않았다면 시간을 가지고 기다려보시면 좋을 것 같습니다.
6. 노션 페이지와 통합 연결
다시 노션에서 클로드와 연동할 페이지 또는 데이터베이스 열어서 우측 상단 점 세 개(⋮) 클릭 → 연결 메뉴를 선택하고 생성한 Integration을 눌러 연결해주시면 됩니다.(저의 경우엔 claude라는 이름으로 생성해서 해당 이름이 보이네요!)
7. 노션 연동 테스트 및 사용
이제 모든 세팅이 끝났으니 테스트를 해봐야겠지요?
클로드 테스크탑을 다시 열어 생성/추가를 위한 노션 페이지 아이디와 실행하고자 하는 것을 프롬프트에 입력해봤습니다.
프롬프트로 새페이지를 만든 후 9~10월에 있는 AI 개발자 채용 공고를 정리해달라고 했는데 아래 사진처럼 아주 잘 생성된 것을 볼 수 있습니다.
또한, 페이지 ID가 없어도 "내 노션에 페이지 생성해서 '자소서 쓸 때 유의할 점'에 관한 글을 작성해줘"라는 프롬프트를 주었더니 클로드가 알아서 접근 권한을 확인하고 허용된 위치에 글을 생성하는 것도 가능했습니다.
그 밖에 달력이나 간단한 일정 관리 페이지 만들기도 가능했습니다. 아직 모든 툴을 테스트해보진 못했지만 페이지 생성, 수정, 조회, 댓글 달기 등 다양한 기능을 사용해 볼 수 있는데요, 이렇게 노션 사용법을 잘 몰라도 LLM 프롬프트로 원하는 페이지를 뚝딱 생성해주는 MCP 연결에 대해 알아봤습니다.
