"다음 콘텐츠 만들어줘" 한 마디로 돌아가는 노션 자동화 설계기

도입

콘텐츠 하나를 발행하기까지 실제로 손이 가는 부분은 글쓰기 자체보다 그 앞뒤에 있는 잡무인 경우가 많습니다. 이번 주제를 고르고, 초안을 쓰고, 메타데이터를 정리하고, 결과물을 노션에 옮겨 저장하는 과정을 매번 반복하다 보면 정작 본문을 다듬는 데 쓸 에너지가 줄어듭니다. 저는 이 반복 구간을 Notion API(정확히는 Notion MCP 연동)와 Claude를 엮어서 자동화해봤고, 이번 글에서는 그 설계 구조와 실제로 걸린 시행착오를 정리합니다.

핵심 개념: Notion MCP란

Notion MCP는 Claude 같은 AI 모델이 노션 워크스페이스의 페이지와 데이터베이스를 대화 안에서 직접 읽고 쓸 수 있게 해주는 연결 방식입니다. 기존에는 노션 Public API를 코드로 직접 호출해서 토큰 발급, 권한 설정, 엔드포인트 호출을 일일이 짜야 했다면, MCP는 Claude 대화 창에서 도구 호출 몇 번으로 같은 작업을 처리합니다. 최근에는 데이터베이스 생성·업데이트 시 토큰 효율이 크게 개선됐고, 페이지를 마크다운으로 그대로 읽고 쓸 수 있는 마크다운 API도 추가돼서, 에이전트가 노션 콘텐츠를 다루는 진입장벽이 눈에 띄게 낮아졌습니다.

실전 적용 구조

실전에서 적용한 구조는 이렇습니다.

첫째, 자동화 대상이 될 노션 데이터베이스부터 스키마를 고정합니다. 제목, 카테고리, 형식(블로그/쇼츠), 상태(아이디어/작성중/발행), 발행일 같은 속성을 미리 정의해두고, 새로운 옵션을 임의로 추가하지 않는다는 규칙을 문서로 남겨둡니다. 이 부분을 느슨하게 두면 실행할 때마다 AI가 속성명을 조금씩 다르게 해석해서 데이터가 지저분해집니다.

둘째, 항목 선택 규칙을 명시합니다. "상태가 아이디어인 항목 중 발행일이 가장 이른 것을 고른다" 같은 식으로 우선순위를 정해두면, 사람이 매번 지정하지 않아도 AI가 알아서 다음 작업을 고를 수 있습니다.

셋째, 반복되는 절차 — 주제 범위 정의, 초안 생성, 메타데이터 정리, 자가검수 — 를 프롬프트 템플릿 문서 하나로 고정해둡니다. 이 문서에는 실행 순서뿐 아니라 "이건 하지 마라"는 금지사항도 같이 적어둬야 합니다. 예를 들어 상태를 발행으로 바꾸는 것, 존재를 확인하지 않은 링크를 지어내는 것, 브랜드명을 혼동하는 것 같은 항목입니다.

넷째, 결과물은 반드시 해당 캘린더 항목의 하위 페이지로만 저장하도록 규칙을 정합니다. 이렇게 하면 나중에 어떤 글이 어떤 단계까지 진행됐는지 캘린더만 봐도 파악할 수 있습니다.

실제로 걸린 부분

이 구조를 실제로 돌려보면서 걸린 부분도 있었습니다. 하나는 노션 Integration 권한 범위입니다. 토큰을 발급받았다고 워크스페이스 전체를 마음대로 읽고 쓸 수 있는 게 아니라, 접근이 필요한 페이지나 데이터베이스에 Integration을 개별적으로 초대해줘야 합니다. 실무에서 "토큰은 만들었는데 데이터가 안 읽힌다"는 문제의 대부분은 이 공유 설정 누락입니다.

또 하나는 SQL 형태로 데이터베이스를 조회할 때 한글 속성명을 다루는 방식입니다. 속성명에 공백이나 한글이 들어가면 반드시 큰따옴표로 감싸야 하고, 쿼리 하나에 여러 조건을 결합할 때는 파라미터 바인딩을 쓰는 편이 안전합니다. 문법이 살짝만 어긋나도 파싱 에러가 나기 때문에, 처음 설계할 때 쿼리 형식을 통일해두는 게 좋습니다.

주의할 점

주의할 점도 정리합니다. 초안 생성까지는 자동화해도 최종 검수와 수정은 반드시 사람이 직접 해야 합니다. AI가 쓴 티가 나는 콘텐츠는 검색 노출이나 독자 신뢰 양쪽에서 불리하기 때문입니다. 또한 자동화 파이프라인이 상태값을 "발행"까지 바꾸지 않도록 막아두는 것도 중요합니다. 실제 게시 여부는 사람이 확인한 뒤에만 반영돼야 사고를 막을 수 있습니다.

마무리

정리하면, Notion MCP와 Claude를 엮은 자동화는 글쓰기 자체를 대신해주는 도구가 아니라, 글쓰기 앞뒤에 붙는 반복 잡무를 덜어주는 도구에 가깝습니다. 데이터베이스 스키마와 실행 규칙을 문서로 고정해두는 초기 설계에 시간을 들일수록, 이후에는 "다음 콘텐츠 만들어줘" 한 마디로도 일관된 결과가 나옵니다.

---

[핵심요약] Notion MCP+Claude로 콘텐츠 제작 반복 잡무 자동화