Notion MCP 자료 관리

수업 공지와 자료 목록을 매번 손으로 갱신하면 같은 내용을 여러 곳에서 확인하게 된다. Notion에 MCP를 연결하면 에이전트가 필요한 내용을 읽고, 승인한 변경을 반영하는 흐름을 만들 수 있다.

기준일: 2026-09-30.

어떤 문제를 풀었나

강의 운영에는 작지만 자주 반복되는 일이 많다. 실습 자료 링크를 모으고, 수업 일정을 확인하고, 변경된 안내를 공지 페이지에 옮긴다.

페이지 제목이 비슷하면 다른 수업 자료를 고치기 쉽다. 공지를 복사해 쓰면 이전 일정이나 링크가 남기도 한다.

이 사례에서는 다음과 같은 작업을 예시로 삼는다.

• 특정 수업의 자료 페이지에서 이번 주 내용을 읽는다.
• 실습 안내와 참고 링크를 공지 초안으로 정리한다.
• 기존 공지와 달라지는 부분을 확인한다.
• 강사가 승인한 내용만 지정한 페이지에 반영한다.

수업 내용과 공개 여부는 강사가 결정한다. 에이전트에는 읽기·정리·반복 편집을 맡긴다.

처음부터 전체 워크스페이스를 정리할 필요는 없다. 비어 있는 연습 페이지 하나에서 연결과 수정 결과를 확인한다.

무엇을 어떻게 연결하나

Notion MCP는 에이전트 실행 도구와 Notion을 연결한다. 연결 방식과 접근 범위는 Notion MCP 공식 소개에서 확인할 수 있다.

아래 Mermaid 그림은 읽기 확인과 실제 수정을 나누는 구성이다.

이 흐름에서 요청문에 적은 페이지 범위와 서비스의 접근 권한은 구분한다. “이 페이지만 수정”이라는 문장만으로 계정의 다른 페이지 접근 권한이 없어지지는 않는다.

구성 요소	역할	먼저 확인할 내용
에이전트 실행 도구	요청을 받고 도구를 호출한다	MCP 연결을 지원하는가
Notion MCP	페이지 읽기·수정 도구를 제공한다	로그인이 완료됐는가
Notion 계정	실제 접근 범위를 정한다	수업 자료 접근 권한이 적절한가
대상 페이지 URL	작업 대상을 지정한다	다른 수업 페이지와 구분되는가
변경 초안	수정 전 검토할 결과다	일정·링크·공개 범위가 맞는가

Notion 요금제와 기능 범위는 공식 가격 안내에서 확인한다. MCP 연결 예시만 보고 필요한 서비스 기능이 모두 포함됐다고 판단하지 않는다.

연결과 읽기 확인

설정 명령과 인증 순서는 공식 MCP 연결 안내에서 확인할 수 있다. 이미 사용하는 실행 도구에 맞는 방법 하나를 선택한다.

Claude Code 연결 예시

Claude Code를 쓰는 프로젝트에서 다음 명령으로 공식 원격 서버를 추가한다.

claude mcp add --transport http notion https://mcp.notion.com/mcp

Claude Code 안에서 연결 상태를 확인하고 브라우저 인증을 진행한다.

/mcp

브라우저에서 로그인한 계정과 접근 승인 내용을 확인한다. 수업에 사용할 계정과 개인 계정을 혼동하지 않도록 한다.

Codex 연결 예시

Codex를 쓰면 공식 연결 안내에 있는 서버 설정을 사용한다. 아래는 사용자 설정 ~/.codex/config.toml에 넣는 서버 항목 예시다.

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

이미 같은 이름의 서버가 있으면 중복으로 추가하지 않는다. 파일에 다른 설정이 있다면 그 내용을 유지한다.

인증은 다음 명령으로 진행한다.

codex mcp login notion

두 실행 도구를 모두 설치할 필요는 없다. 실제로 사용할 도구에서 연결과 읽기 요청이 되는지 확인하면 된다.

쓸 만한 요청 만들기

읽기 전용 첫 요청

다음 요청에서 URL은 직접 준비한 연습 페이지 주소로 바꾼다.

Notion MCP 연결 상태를 확인하고, 지정한 연습 페이지를 읽어 줘.
대상: <연습 페이지 URL>

페이지 제목과 주요 항목만 요약해 줘.
아직 페이지 생성, 수정, 이동, 삭제는 하지 마.
읽을 수 없으면 어떤 단계에서 실패했는지 알려 줘.
다른 페이지를 찾거나 접근 범위를 넓히지는 마.

반환된 제목이 맞는지 직접 확인한다. 이름이 같은 페이지가 여러 개라면 URL로 대상을 다시 지정한다.

읽고 공지 초안 만들기

아래 수업 자료 페이지를 읽고 이번 주 공지 초안을 만들어 줘.
자료 페이지: <자료 페이지 URL>
공지 대상: <공지 페이지 URL>

초안에는 수업 목표, 준비할 것, 실습 순서, 자료 링크를 넣어 줘.
일정과 장소는 페이지에 명시된 것만 쓰고,
찾을 수 없는 정보는 질문 목록으로 따로 적어 줘.

아직 Notion을 수정하지 말고, 공지 본문과 변경 요약을 보여 줘.

읽을 자료와 수정할 페이지를 나눠 적으면 작업 범위가 선명해진다. 빠진 일정을 그럴듯한 날짜로 채우지 않게 하는 조건도 함께 둔다.

확인한 변경만 반영

앞서 확인한 공지 초안을 지정한 공지 페이지에 반영해 줘.
승인한 변경은 준비물 목록과 자료 링크 부분뿐이다.
기존 제목, 일정, 장소, 다른 주차 공지는 유지해 줘.

삭제나 페이지 이동은 하지 마.
작업 직전에 대상 페이지 내용을 다시 읽고,
초안 작성 이후 변경이 있으면 적용하지 말고 알려 줘.
반영 뒤에는 해당 부분을 다시 읽어 변경 결과를 보여 줘.

동시에 사람이 페이지를 수정할 수 있으므로 적용 직전에 다시 읽도록 한다. 이 절차만으로 서비스 차원의 동시 수정 충돌 방지가 보장되는 것은 아니다.

읽기에서 운영까지

1. 연습 페이지에서 시작

연습 페이지에 가상의 수업 제목과 짧은 자료 목록을 넣는다. 학생 이름, 연락처, 제출물은 연결 확인에 필요하지 않다.

제목 확인, 한 문단 요약, 짧은 항목 추가 순서로 진행한다. 읽기가 되지 않으면 쓰기 요청으로 넘어가지 않는다.

2. 반복 작업 입출력

예를 들어 “자료 정리”를 다음처럼 나눌 수 있다.

작업	입력	결과	확인 기준
자료 목록 갱신	승인한 링크 목록	자료 페이지의 목록	누락·중복이 없는가
공지 초안 작성	수업 목표와 일정	검토용 공지 본문	없는 정보를 채우지 않았는가
공지 반영	승인한 변경 내용	지정 페이지의 수정	다른 부분을 유지했는가
결과 확인	반영한 페이지	변경 요약	실제 페이지와 일치하는가

기준이 정해지면 스킬에 입력 페이지, 수정 범위, 확인 순서를 남긴다. 매번 긴 요청문을 복사하는 수고를 줄일 수 있다.

3. 페이지·표 구조 읽기

공지 본문처럼 단순한 작업부터 시작한다. 자료를 표로 관리한다면 현재 열 이름과 값의 종류를 먼저 확인한다.

“상태를 완료로 바꿔”라는 요청만으로 정확한 행이나 속성이 정해지지는 않는다. 어느 항목의 어떤 값을 바꿀지 명시한다.

도구가 해당 작업을 지원하는지도 확인한다. 필요한 수정 기능이 보이지 않으면 설정 키나 도구 이름을 추측해서 만들지 않는다.

4. 적용 전후 비교

수정 전 대상 내용과 승인한 변경안을 짧게 남긴다. 적용 후에는 같은 부분을 다시 읽어 예상한 결과와 비교한다.

페이지를 직접 열어 링크와 배치도 확인한다. 텍스트가 맞아도 안내가 잘못된 위치에 들어갈 수 있다.

5. 반복 요청의 절차화

연결이 안정된 뒤에는 “자료 읽기 → 공지 초안 → 승인 → 반영 → 다시 읽기”를 반복 절차로 만든다.

일정과 대상 페이지는 매번 입력받는다. 지난 수업에서 쓴 값을 기본값처럼 재사용하지 않는다.

컨텍스트에 오래된 공지와 새 공지가 뒤섞이면 잘못된 정보를 가져올 수 있다. 현재 주차에 필요한 자료만 지정한다.

자주 막히는 지점과 주의점

연결 후 읽기 실패

로그인한 계정, 선택한 워크스페이스, 대상 페이지 URL을 확인한다. 페이지가 이동됐거나 접근 권한이 달라졌을 수도 있다.

실패 메시지를 남기고 브라우저에서 같은 계정으로 페이지를 열어 본다. 이 단계에서 접근 범위를 무조건 넓히지 않는다.

비슷한 페이지 수정

제목 검색 결과만으로 대상을 결정하지 않는다. 읽기 결과의 제목과 URL을 확인하고, 수정 요청에는 확인한 URL을 다시 적는다.

정기 작업일수록 지난 대상 주소가 남아 있는지 확인한다. 학기나 수업이 바뀌면 작업 범위도 다시 정한다.

공지 생성 시 덮어쓰기

교체할 범위를 먼저 보여 주게 한다. 본문 전체 교체보다 준비물이나 자료 목록처럼 작은 범위부터 자동화한다.

큰 변경은 사람이 페이지에서 확인한 뒤 적용한다. 승인되지 않은 삭제·이동·공유 설정 변경을 같은 작업에 섞지 않는다.

불필요한 학생 정보 입력

공지와 자료 정리에 필요한 내용만 읽게 한다. 계정 비밀값, 학생 연락처, 공개가 허용되지 않은 제출물은 요청문이나 작업 기록에 옮기지 않는다.

학생 결과를 다루는 작업은 별도로 범위를 정한다. 수업 운영 공지와 개인별 피드백을 같은 페이지 처리에 묶지 않는다.

MCP 적용 범위

외부 페이지를 실제로 읽고 수정할 때는 연결이 유용하다. 로컬 파일을 정리하는 일까지 Notion을 경유할 필요는 없다.

도구 연결을 늘리기 전에 입력과 결과가 어디에 있어야 하는지 정한다. 공지 갱신처럼 분명한 반복 작업 하나부터 완성한다.