목표
Claude에게 “이 내용 정리해서 노션에 써줘”라고 하면 내 노션 페이지에 직접 글이 써지게 만듭니다. 복사·붙여넣기를 사람이 대신하던 일을 MCP(AI와 서비스를 잇는 연결 규격)가 해 줘요.
준비물
- Claude 데스크톱 앱 (Claude) — 비개발자에게는 화면이 익숙하고 빠른 Claude 데스크톱, 개발자는 여러 모델을 쓸 수 있는 Cursor가 추천됐어요
- 노션 계정
- MCP 찾는 곳: Smithery 또는 GitHub의 MCP 서버 목록
- 설정 파일을 열 편집기 (메모장도 되지만, 괄호 실수를 줄이려면 VS Code 추천)
순서
- MCP 고르기 — Smithery에서 “notion”을 검색합니다. 비슷한 게 여러 개면 설치 횟수가 많은 것을 고르세요. 개인이 만든 서버가 많아서 안 되는 것도 있어요.
- 노션 키 받기 — 노션 개발자 페이지(developers.notion.com)에서 새 인테그레이션(연결 앱)을 만들고, 내 워크스페이스를 고른 뒤 저장합니다.
- 읽기·업데이트·생성 권한을 체크해야 AI가 작업할 수 있어요.
- 생성된 키(토큰)를 복사합니다. 이 키는 비밀번호처럼 다루세요.
- 설정 JSON 받기 — Smithery의 노션 MCP 페이지에서 JSON 방식을 고르고 키를 붙여 넣으면 설정 코드가 나옵니다. (Smithery 회원가입이 필요해요)
- Claude 설정 파일에 붙이기 — Claude 데스크톱 → 설정 → 개발자 → 설정 편집 →
claude_desktop_config.json을 열어 붙여 넣고 저장합니다. - 완전히 껐다 켜기 — 창만 닫으면 안 되고 앱을 종료한 뒤 다시 켜야 반영돼요. 입력창 근처의 도구 목록에 노션 MCP가 보이면 성공입니다.
- 글 쓸 페이지 연결 — 노션에서 AI가 쓸 페이지를 만들고, 페이지 메뉴(···) → 연결에서 2번에서 만든 인테그레이션을 추가합니다. 연결한 페이지에만 AI가 쓸 수 있어요.
- 요청하기 — 페이지 주소 끝의 ID를 함께 주면서 요청합니다.
이 노션 페이지(ID: …)에 내가 좋아하는 노래 목록을 표로 정리해서 써줘
결과
Claude 대화창에서 요청하면 노션 페이지에 정리된 글이 생겨요. 반대로 “이 페이지 읽고 요약해줘”처럼 노션 내용을 가져와 분석하는 것도 됩니다.
MCP 하나 더 붙일 때
설정 파일의 mcpServers 안에 새 서버 항목만 추가합니다. 앞 항목 뒤에 쉼표(,)를 꼭 붙이세요. 빠지면 오류가 나요.
알아둘 점
- 노션은 직접 운영하는 원격(Remote) Notion MCP를 권장한다고 안내합니다. 위 방법이 안 되면 Notion MCP의 공식 문서 방법을 써 보세요.
- 영상에서 함께 시도한 유튜브 MCP는 촬영 당일 동작하지 않았어요. MCP는 만든 사람에 따라 품질 차이가 크니, 안 되면 다른 서버로 바꿔 보세요.
막히면
- 도구 목록에 안 보여요 → JSON의 괄호·쉼표 오류가 가장 흔해요. 그리고 앱을 완전히 종료했는지 확인하세요.
- “권한이 없다”고 해요 → 노션 페이지에 인테그레이션을 연결했는지(6번), 인테그레이션 권한을 체크했는지(2번) 확인하세요.
- 처음 MCP를 써 본다면 → 파일로 바로 결과가 보이는 MCP 처음 연결해보기 — 폴더 하나로 개념 잡기부터 해 보는 것도 좋아요.