출처: 여성시대 윤선생님
MCP 활용기초 -
노션 연결하기 편
🔍 MCP (Model Context Protocol) 란?
AI 모델( Claude 등)과
외부 데이터 소스, 도구, 시스템을
안전하고 표준화된 방식으로 연결해주는
개방형 프로토콜*(Open Protocol)
*프로토콜 : 통신규약
(즉, MCP란 AI 모델이 다른 프로그램과 통신할 수 있도록 해주는 통신 규칙)
지금까지는 우리가
질문 → AI가 답변 → 사람이 도구 사용
의 흐름을 가졌다면,
이제는
질문 → AI가 도구를 직접 사용 → 결과
의 에이전트 형 AI로 사용할 수 있습니다.
단순히 말로 돕는 비서가 아니라,
직접 작업까지 해주는 에이전트로 진화!!
쉽게 말하면,
AI에게 일할 수 있는
손과 발을 달아주는 기술
입니다.
뭘 할 수 있느냐?
- 노션에 원하는 내용 정리 요청하기
- ChatGPT와 연동하여 사용하기
(똑똑한 놈 두개 사용)
등등등.... MCP 활용은 무한하다!!!
여러가지 AI를 활용해서
MCP를 사용할 수 있지만,
우리는 초보자 이기에
가장 익숙한 UI를 가진
Claude.ai (ChatGPT와 유사)
를 사용해볼게요.
🧰 시작하기 전에 ...
- 노트북 / 컴퓨터
- Notion.com 계정
학교 계정 등은 보안상 사용 불가능
개인 계정으로 준비해주세요.
- Claude.ai 계정 (무료 가능)
- Claude Desktop 앱 (다운로드)
- GitHub.com 계정
- Smithery.ai 계정
모두 준비 되셨다면,
아래 순서에 따라 진행하시면 됩니다.
본격 노션 연결하기
※ 본 글 작성자는 윈도우11 기준으로 설명합니다. ※
Smithery에 접속해서 로그인을 해줍니다.
(GitHub 계정이 필요하므로 꼭 미리 만들어주세요.)
검색창에 Notion 을 입력하면,
여러가지 MCP 들이 뜨는데요,
Smithery 에서 MCP를 고를 땐, 다운로드 횟수를 기준으로 고르면 됩니다.
우리는 첫번째(61.06K)를 골라 사용해보겠습니다.
여러가지 연결 방법이 있지만,
우리는 오늘 JSON을 활용하여 연결해보겠습니다.
JSON 버튼을 클릭하면,
notionApiKey 를 입력하라고 나오는데요,
나의 노션 워크스페이스에서
MCP를 활용해야 하기 때문에,
내 노션 계정의 API를 직접 받아와주셔야 합니다.
https://developers.notion.com
⬆️ 노션 개발자 도구 ⬆️
위 링크에 접속 후 로그인합니다.
View my integrations 클릭
새 API 통합 버튼(+) 을 누릅니다.
필수 정보 3가지만 입력 후
저장을 눌러주겠습니다.
API 통합 설정 구성
페이지로 이동합니다.
접근할 수 있는 페이지가 없어
경고메시지가 뜹니다.
사용 권한 탭으로 가서
페이지 설정을 하겠습니다.
내가 사용할 페이지를 선택하여
사용 권한 업데이트를 진행합니다.
다시 구성 탭으로 돌아와서,
권한을 모두 열어주어야
AI가 접속하여 사용할 수 있으니
꼭 권한을 허용해주세요.
프라이빗 API 통합 시크릿 키를
복사해둡니다.
오른쪽 끝 표시하기를 누르면
복사하기 버튼이 뜹니다.
(그냥 드래그 해도 복사 됨)
다시 Smithery로 돌아와
복사해둔 API 키를 입력 후
Connect 합니다.
나의 운영체제를 선택하고
옆에 있는 Copy 버튼을 클릭합니다.
(아래 모든 코드 복사됨)
이제 클로드 데스크탑으로 넘어와서,
Ctrl + 콤마(,) 를 눌러
설정창을 엽니다.
개발자 탭의
설정 편집 선택
claude_desktop_cofig.json
파일을 찾아 메모장으로 열어줍니다.
원래 있던 내용을 지운 후
복사했던 내용을 덮어써주세요.
저장 후 종료합니다.
이제 클로드 데스크탑을
완전히 종료해야 하는데요,
좌 상단 햄버거 메뉴 클릭
파일 -> 종료
를 눌러 완전히 종료시켜줍니다.
꼭 위 프로세스대로
종료해주셔야 제대로 실행됩니다.
다시 클로드 데스크탑을 실행시키고
검색 및 도구 버튼을 누르면
내가 추가한 notion MCP API가 뜨게됩니다.
거의 다 왔다.....!
다시 노션으로 들어와서,
아까 사용 권한 페이지에서
연동해줬던 페이지를 열어줍니다.
페이지 주소를 복사해주세요.
클로드 데스크탑에게 질문을 작성해봅시다.
복사한 주소를 붙여넣고
원하는 내용을 정리해달라고 해볼게요.
이런 허용창이 뜨면
모두 항상 허용을 눌러주세요.
두둥...!!!!!!!
클로드가 노션에 접속해
알아서 페이지를 작성한 모습입니다.
다음 이시간에는
MCP 기초 -
Notion 활용하기 편
으로 돌아오겠습니다.
읽어주셔서 감사합니다^^
@Jardin des Tuileries 만약 코드가 정상적인거면 api주소 복붙하고 저 코드에서 어디부분을 수정해야할까요? 아까 했던 코드가 그대로 smithery에 떠있고 사로운 api로 붙여넣을 수가 없어서요..
@윤선생님 또 이렇게 떠요 흑흑 제가 뭘 잘못 했을까요
@Jardin des Tuileries 노선에서 페이지 새로 만들어서 --key다음 부분에 API통합시크릿 다른 걸로 붙여넣었는데 그래서 그런걸까요?