피드로 돌아가기
Sub-Agent Documents Everything in Notion
Dev.toDev.to
Backend

개발자가 OpenClaw 내 전용 AI 에이전트(Escriber)와 14개 Notion 도구를 조합해 자동 문서화 시스템 구축

Sub-Agent Documents Everything in Notion

John A Madrigal2026년 3월 26일7intermediate

Context

개발자가 많은 아이디어, 프로젝트, 노트를 관리하면서 문서화가 체계적으로 이루어지지 않는 문제 직면. 과거 Notion 워크스페이스에 "ideas v3 FINAL", "project notes DO NOT DELETE" 같은 제목의 페이지들이 3줄짜리 메모로만 남겨져 있는 상황 발생.

Technical Solution

  • Escriber라는 단일 목적 AI 에이전트를 OpenClaw의 멀티 에이전트 팀 내 두 번째 에이전트로 배포: SOUL.md 파일로 "I document. Beautifully. In Notion."이라는 정체성 정의
  • mcporter MCP 릴레이를 통해 모든 Notion 상호작용을 일관된 패턴으로 프록시: mcporter call notion.<tool_name> --args '{ ... }' 형식 통일
  • 14개 Notion 도구 체계화: 검색(notion.search), 페이지 생성(notion.create_page), 데이터베이스 조회(notion.query_database), 블록 추가(notion.append_block_children) 등을 아키텍처에 통합
  • 에이전트 레벨 워크플로우 규칙 3가지 내재화: (1)생성 전 검색 수행, (2)쓰기 전 읽기, (3)의사결정은 Callout, 세부사항은 Toggle, 구조화는 Heading으로 구분
  • Synap 봇과의 연계: 프로젝트 요약 작성 후 Escriber가 결과물을 Notion에 저장하는 워크플로우 구성

Key Takeaway

단일 책임을 가진 초점화된 AI 에이전트에 명확한 정체성(personality)과 도메인 전용 도구 세트(14개 Notion 도구)를 부여하면, 스위스 아미 나이프 형태의 범용 솔루션보다 더 실용적인 자동화 시스템을 구현할 수 있다.


복잡한 문서화 프로세스를 자동화해야 하는 팀 환경에서 MCP 서버와 단일 책임 에이전트 패턴을 조합하면, 도구 선택 결정 오버헤드를 줄이고 일관된 문서 구조를 유지할 수 있다. 특히 사용자가 Discord 봇이나 웹 인터페이스로 접근할 수 있는 구조는 문서화의 진입장벽을 낮춘다.

원문 읽기