claude code에 노션 MCP 붙여 문서작업 자동화한 2주 셋업 기록

노션에 쌓인 회의록과 기획 문서를 매번 손으로 정리하다 보면, 하루가 어떻게 가는지 모르게 사라져요. 나는 팀 위키와 개인 메모를 전부 노션에 두는 편인데, 문서 하나 다듬는 데만 20분 넘게 걸리는 날이 흔했거든요. 그러다 claude code에 노션 mcp를 붙이면 이 반복을 줄일 수 있다는 얘기를 듣고, 2주 동안 직접 셋업해서 써 봤습니다. 이 글은 그 실전 기록이에요.

왜 노션 mcp를 붙였나

문제는 단순했어요. 노션은 문서를 담아 두기엔 좋은데, "이 회의록에서 할 일만 뽑아 다른 페이지로 옮겨 줘" 같은 작업은 결국 사람이 복사-붙여넣기로 해야 했거든요. 이런 잔업이 하루에도 몇 번씩 생겼습니다.

claude code 같은 코딩 에이전트는 터미널에서 파일을 잘 다루지만, 노션 안의 페이지는 건드리지 못해요. 그 사이를 이어 주는 게 mcp(모델 컨텍스트 프로토콜)예요. mcp는 에이전트가 외부 도구—여기서는 노션—를 직접 읽고 쓰게 해 주는 표준 연결 규격이죠. 노션 mcp를 붙이면 "저 페이지 읽어서 요약해"라고 자연어로 시키는 게 가능해지는 거예요.

내가 노렸던 건 세 가지였어요. 회의록에서 할 일 자동 추출, 흩어진 메모를 주제별로 묶기, 그리고 매주 쓰던 주간 리포트 초안 자동 생성. 전부 노션 안에서 벌어지는 문서작업이라, claude code mcp 연결이 딱 맞아떨어졌습니다.

연결 셋업, 40분이면 됐다

셋업 자체는 생각보다 안 어려웠어요. 나처럼 코딩을 깊게 안 하는 사람 기준으로도 처음부터 끝까지 약 40분 걸렸습니다.

큰 흐름은 이래요. 먼저 노션에서 내부 통합(integration)을 하나 만들고, 연결 토큰을 발급받습니다. 그다음 claude code 설정 파일에 노션 mcp 서버를 등록하고, 그 토큰을 환경변수로 넣어 줘요. 마지막으로 자동화하고 싶은 노션 페이지를 그 통합에 "공유"해 줘야 에이전트가 접근할 수 있어요. 이 마지막 단계가 핵심인데, 나는 여기서 한 번 크게 막혔거든요. 뒤에서 따로 풀어 볼게요.

토큰 값 같은 민감한 정보는 절대 문서나 코드에 그대로 적지 않았어요. 환경변수로만 두고, 화면을 공유할 일이 있으면 반드시 가렸습니다. 이건 습관처럼 지키는 편이 안전하죠.

설정을 마치고 "내 노션에서 지난주 회의록 페이지 제목을 나열해 줘"라고 시켜 봤는데, 목록이 그대로 떠서 좀 신기했어요. mcp 셋업이 제대로 붙었다는 신호였습니다.

실제로 자동화한 문서작업 흐름

가장 자주 쓴 건 회의록 정리였어요. 예전에는 회의록 페이지를 열고 액션 아이템을 눈으로 훑어 담당자별로 나눠 옮기는 데 20~25분이 들었습니다. 지금은 "이 회의록에서 할 일만 담당자별로 묶어 '이번 주 태스크' 페이지에 정리해"라고 한 줄 시키면 6분 안팎에 끝나요. 물론 결과는 항상 내가 눈으로 확인하고요.

두 번째는 흩어진 메모 묶기였어요. 노션 여기저기 던져 둔 아이디어 메모를 주제별로 모아 달라고 하면, 초안 수준으로 그룹핑해 줍니다. 완벽하진 않아 손을 대긴 하지만, 백지에서 시작하는 것보단 훨씬 빨랐어요.

세 번째가 주간 리포트 초안이었습니다. 한 주치 문서를 읽고 "이번 주 한 일 / 다음 주 할 일" 틀로 요약 초안을 만들게 했더니, 30분 넘게 걸리던 초안이 10분대로 줄더라고요. 대신 숫자나 고유명사는 반드시 사람이 검토해요. 에이전트가 가끔 그럴듯하게 지어내니까요.

문서 자동화의 핵심은 "노션에 벌어지는 문서작업이 하검 어대더"라는 역할 분리였어요. 이 선을 지키니 속도는 얻으면서 사고는 안 나더라고요.

토큰비용과 한계

다들 궁금해할 토큰비용 얘기를 해 볼게요. 나는 하루에 문서 자동화로 claude code를 10~20번쯤 호출하는데, 페이지를 통째로 읽고 정리하는 작업이라 호출당 토큰이 좀 나가는 편이에요. 그렇게 2주를 써 본 체감으로는 하루 대략 1~2천 원 범위, 많이 쓴 날은 그 위로도 올라갔습니다. 주 단위로는 대충 1만 원 안쪽에서 움직였어요. 사용량과 문서 길이에 따라 편차가 커서 정확한 절감률을 단정하긴 어렵습니다. 그냥 커피 한두 잔 값으로 잔업 몇 시간을 덜었다, 그 정도 체감이라고 봐 주세요.

한계도 분명했어요. 페이지가 아주 길면 한 번에 다 못 읽어 나눠 시켜야 했고, 표가 복잡한 페이지는 정리 품질이 눈에 띄게 떨어졌습니다. 무엇보다 결과를 안 보고 그대로 믿으면 안 돼요. 날짜나 담당자를 헷갈려 옮긴 적이 있어서, 지금은 중요한 페이지일수록 더 꼼꼼히 확인하는 편이죠.

실패 한 번, 그리고 2주 소감

약속한 실패담이에요. 셋업 직후 "회의록 읽어 줘"를 시켰는데 계속 페이지를 못 찾겠다는 답만 돌아왔어요. 토큰도 맞고 mcp 셋업도 맞는데 왜 안 되나 20분쯤 헤맸습니다. 원인은 허무할 만큼 단순했어요. 노션 통합에 그 페이지를 "공유"해 주지 않아서, 에이전트 눈에는 페이지가 아예 없던 거였죠. 대상 페이지를 통합에 연결해 주자 바로 읽혔어요. 노션 mcp를 붙일 때 제일 흔히 걸리는 지점이라고 하니, 안 되면 여기부터 확인하시길 권합니다.

2주를 써 본 소감은 "붙이는 값이 확실히 있다"였어요. 셋업 40분에 소소한 시행착오를 빼면, 매일 하던 문서 잔업의 체감 부담이 눈에 띄게 줄었습니다. 특히 회의록 정리와 주간 리포트 초안에서 시간이 가장 많이 회수됐어요. 다음 실험으로는 slack 알림까지 연결해서, 회의록에서 뽑은 액션 아이템 마감을 자동으로 챙기는 흐름을 만들어 볼 생각이에요. 노션 mcp 하나만 붙여도 문서 자동화의 입구는 충분히 열리더라고요. 코딩이 깊지 않아도 시작할 수 있으니, 노션으로 문서를 관리하는 분이라면 한 번쯤 붙여 볼 만합니다.