[IT_Tips] 채팅으로 맞춤형 Notion Template 자동 제작 AI Agent 소개 (Notion Forge)

1. 들어가며

노션(Notion)은 현존하는 최고의 생산성 도구입니다. 하지만 너무 자유도가 높다 보니, 새 프로젝트를 시작할 때 빈 페이지를 마주하면 어디서부터 손을 대야 할지 막막해지는 경우가 많습니다.

"이번엔 다이어트 트래커를 만들어볼까?" >>> 데이터베이스 속성(Property) 고민 30분 >>> 뷰(View) 배치 30분 >>> 수식(Formula) 짜다가 1시간... 정작 본질적인 일은 시작도 못 하고, 노션 세팅에 주말을 다 날려버리는 현상을 업계에서는 "Notion Paralysis(노션 마비)"라고 부릅니다.

기존의 'Notion AI' 역시 글쓰기나 요약을 도와줄 뿐, 이런 복잡한 워크스페이스 구조를 설계해 주지는 못합니다.

이러한 문제를 해결하기 위해 제가 직접 개발하여 오픈소스로 공개한 프로젝트가 바로 'Notion Forge'입니다. "CRM 대시보드 하나 만들어줘"라는 자연어 한 줄이면, AI 에이전트가 알아서 DB를 설계하고, 10가지 뷰를 배치하며, 관계형(Relation) 수식을 연결하고, 샘플 데이터까지 채워주는 놀라운 경험을 선사합니다. 이번 포스팅에서는 Notion Forge의 개요부터 아키텍처, 그리고 직접 내 컴퓨터에 구축하는 방법까지 완벽하게 정리해 드리겠습니다.

---

2. Notion Forge란? (개요 및 정의)

Notion Forge는 자연어 프롬프트 단 한 줄을 분석하여, 전문가 수준의 노션 템플릿과 워크스페이스를 1~3분 만에 완전히 자동으로 생성해 내는 자율형 AI 에이전트 오픈소스 프로젝트입니다.

• https://github.com/JaylenAI/Notion_Forge

GitHub - JaylenAI/Notion_Forge: AI Agent that auto-generates professional Notion templates(workspaces) from natural language.

 

2-1. 핵심 차별점

• 자율성(Plan-Execute-Reflect): 단순한 텍스트 변환기가 아닙니다. AI가 목표를 분해해 계획을 세우고, 11가지 도구를 자율적으로 호출하며, 결과를 스스로 검증하여 오류가 있으면 재수정(최대 3회)하는 고도화된 에이전트입니다.
• 완벽한 Notion API 커버리지: 30여 종의 블록(Block), 10가지 데이터베이스 뷰(Table, Board, Chart 등), 그리고 2026년 최신 노션 API(Workers, External Agents)까지 모두 지원합니다.
• 셀프 호스팅(무료): 제3자 서버를 거치지 않고 내 컴퓨터나 사내 서버에 구축하므로 데이터 주권이 100% 보장되며, GitHub Copilot 구독자라면 GPT-4.1 수준의 AI를 무료로 사용할 수 있습니다.

---

3. 핵심 아키텍처: 12단계 파이프라인

Notion Forge는 사용자 입력부터 최종 생성까지 매우 정교한 12단계 파이프라인을 거칩니다.

1. Input Guardrail: 악의적인 프롬프트 인젝션을 막는 보안 필터입니다.
2. Intent Analyzer: 사용자의 의도를 분석합니다. (생성, 수정, 단순 질문)
3. Skill Router: 48개의 도메인 스킬 중 가장 적합한 것을 매칭합니다. (예: diet >>> track/diet)
4. Episodic Memory: 과거의 성공/실패 패턴과 사용자의 선호도를 불러옵니다.
5. Layout Router: 8가지 대시보드 레이아웃 패턴을 자동 선택합니다.
6. Prompt Assembler: 위의 정보들을 모아 시스템 프롬프트를 동적으로 조립합니다.
7. AI Generation (Provider Strategy): Copilot, Claude, Gemini 등 5개 AI 중 설정된 것을 통해 청사진(Blueprint)을 생성합니다.
8. Gen-Eval Loop: 만들어진 청사진이 노션 API 구조에 맞는지 검증하고 피드백합니다.
9. Post-Processor: 이모지, 다국어(i18n) 등 13가지 자동 보정을 거칩니다.
10. Approval Gate: 🌟 사용자가 미리보기를 확인하고 '승인(Approve)'을 눌러야 실제 생성이 시작됩니다.
11. Agent Loop: (가장 핵심) 에이전트가 11개의 노션 제어 도구를 자율적으로 호출하며 워크스페이스를 조립합니다.
12. 5-Pass Creation & Rollback: 페이지 >>> 하위 페이지 >>> DB >>> View >>> 샘플 데이터 순서로 생성하며, 중간에 에러가 나면 찌꺼기를 남기지 않고 즉시 삭제(Rollback)합니다.

 

---

4. 스킬 시스템 (Skill System)과 확장성

Notion Forge는 AI가 백지에서 모든 걸 상상하게 두지 않습니다. 48개의 도메인 특화 스킬(Tier 1 12개 + Tier 2 36개)을 장착하고 있어, 사용자가 "독서 기록장 만들어줘"라고 하면 collect/reading 스킬을 꺼내어 완벽한 스키마를 짭니다.

💡 코드 한 줄 없이 스킬 추가하기:

누구나 기여(Contribute)할 수 있습니다! 파이썬 코드를 짤 필요 없이, SKILL.md라는 마크다운 파일 하나만 작성해서 app/skills/ 폴더에 넣으면 AI가 즉시 새로운 템플릿(예: 암호화폐 포트폴리오, 꿈일기 등)을 만들 줄 아는 능력을 얻게 됩니다.

---

5. 특징 및 장단점

 

5-1. ✅ 장점 (Pros)

• Notion Paralysis 완벽 해결: 빈 페이지에서 허덕이던 주말을 3분으로 압축해 줍니다.
• 멀티턴 수정 (채팅 기반): "Daily Log에 '물 섭취량' 속성 추가해 줘", "캘린더 뷰를 주간으로 바꿔줘"처럼 만들어진 후에도 채팅으로 손쉽게 수정할 수 있습니다.
• 5가지 AI Provider 지원: Copilot SDK(무료), Claude, Gemini, Groq, OpenAI를 모두 지원하며, API 키만 넣으면 알아서 최적의 모델을 선택하는 Fallback 구조를 가집니다.
• 실시간 스트리밍 UI: React + WebSocket 조합으로 AI가 지금 무슨 뷰를 만들고 있는지 텍스트 생성 과정을 실시간으로 구경하는 재미가 있습니다.

 

5-2. ❌ 단점 및 한계 (Cons)

• API 호출 속도 제한: Notion API의 초당 3회 제한으로 인해, 매우 거대한 워크스페이스를 만들 때는 약간의 대기 시간(Rate limit)이 발생할 수 있습니다.
• 로컬 환경 구축 필수: SaaS 형태가 아니기 때문에, 사용자가 직접 Docker 등을 이용해 컴퓨터에 환경을 띄워야 하는 진입 장벽이 존재합니다.
• 보안 노출 금지: 리버스 프록시(Nginx 등) 없이는 API에 자체 인증이 없으므로 공개 인터넷에 직접 노출해서는 안 됩니다.

 

---

6. 주요 활용 분야 (Use Cases)

1. 개인 지식 관리(PKM): 다이어트 트래커, 운동 일지, 가계부 등을 순식간에 찍어내어 개인 노션에 세팅합니다.
2. 스타트업 및 작은 팀: 새로운 직원이 왔을 때 '온보딩 위키', '스프린트 백로그', '채용 파이프라인' 등을 즉시 생성하여 표준 워크스페이스로 제공합니다.
3. 콘텐츠 크리에이터: 블로그 캘린더, SNS 기획, 유튜브 스크립트 관리 대시보드를 AI의 도움을 받아 체계적으로 관리합니다.
4. 에이전시 및 프리랜서: 클라이언트마다 제각각인 관리 보드와 대시보드 템플릿을 빠르게 복제하고 커스텀합니다.

 

---

7. [실전 구축] Docker로 3분 만에 Notion Forge 띄우기

내 컴퓨터에 직접 Notion Forge 에이전트를 띄우는 방법입니다. (Python, Node.js, Docker가 설치되어 있어야 합니다.)

 

7-1. 1단계: 소스코드 다운로드 및 환경 변수 설정

# 1. 깃허브에서 클론
git clone https://github.com/JaylenAI/Notion_Forge.git
cd Notion_Forge

# 2. 환경 변수 파일 복사
cp .env.example .env

 

7-2. 2단계: Notion API 통합(Integration) 토큰 발급

1. notion.so/my-integrations에 접속하여 새 통합(Integration)을 생성하고, Internal Integration Secret (ntn_...)을 복사합니다.
2. .env 파일을 열고 다음과 같이 설정합니다.

# [필수 설정]
NOTION_API_KEY=ntn_xxxxxxxxxxxx  # 복사한 토큰
NOTION_PARENT_PAGE_ID=xxxxx      # 템플릿이 만들어질 빈 페이지의 ID

# [AI 설정 - GitHub Copilot 구독자라면 무료!]
COPILOT_ENABLED=true
# (또는 CLAUDE, GEMINI, GROQ 중 하나의 API 키 입력)

🚨 중요: 노션에 들어가서 템플릿이 만들어질 페이지 우측 상단의 ··· >>> 연결(Connections) 메뉴에서 방금 만든 통합 앱을 반드시 추가해주셔야 합니다!

 

7-3. 3단계: Docker Compose로 실행

터미널에 아래 명령어를 치면 백엔드와 프론트엔드가 자동으로 구축됩니다.

docker compose up --build

 

7-4. 4단계: 접속 및 첫 템플릿 만들기

브라우저를 열고 http://localhost:9501에 접속합니다. 아름다운 채팅 UI가 나타납니다.

입력창에 이렇게 쳐보세요!

"다이어트 트래커 만들어줘. 매일 체중, 식사, 운동 기록할 수 있게."

그러면 AI가 실시간으로 스킬을 매칭하고, 청사진을 검증한 뒤, 사용자에게 미리보기를 제공합니다. 'Approve(승인)'을 누르는 순간, 노션에 마법처럼 다이어트 트래커가 쫙 펼쳐집니다!

 

---

8. 한 눈에 비교: 노션 템플릿 도구 비교

비교 항목	Notion Forge	Notion AI	일반 템플릿 복제
본질	자율형 AI 에이전트	텍스트 보조 AI (챗봇)	남이 만든 정적 템플릿 복사
작동 방식	자연어 프롬프트로 새로운 DB/뷰 창조	기존 텍스트/표의 내용 요약 및 수정	마켓플레이스에서 검색 후 복제
비용	무료 (셀프 호스팅)	월 $10 / 1인당	유/무료 다양함
유연성	채팅으로 "여기 속성 하나 더 넣어줘" 등 실시간 커스텀	워크스페이스 구조 변경 불가	구조 변경 시 사용자가 직접 뜯어고쳐야 함
필요 역량	초기 Docker 설치 지식 필요	클릭만으로 사용 가능	노션 구조에 대한 이해 필요

 

---

9. 마치며

지금까지 우리는 내 입맛에 맞는 노션 템플릿을 찾기 위해 구글과 마켓플레이스를 몇 시간씩 뒤지곤 했습니다. 맘에 드는 걸 찾아도 내 업무 스타일과 딱 맞지 않아 결국 수동으로 이리저리 뜯어고쳐야 했죠.

하지만 Notion Forge의 등장으로 우리는 더 이상 '템플릿 쇼핑'을 할 필요가 없습니다. 그저 머릿속에 있는 아이디어를 말하기만 하면, 2026년 최신 에이전트 기술(Plan-Execute-Reflect)이 탑재된 똑똑한 비서가 완벽한 워크스페이스를 지어(Forge) 줍니다.

Notion Forge는 제가 두 도구 사이에서 고민하던 수많은 주말의 시간을 아끼기 위해 직접 만든 오픈소스 프로젝트입니다. 현재 v0.1.6 릴리즈를 통해 매우 안정적으로 구동되며, 누구나 SKILL.md 하나로 새로운 템플릿 스킬을 기여할 수 있는 열린 생태계입니다.

지금 바로 깃허브 저장소(JaylenAI/Notion_Forge)를 방문해 별(Star)을 눌러주시고, 직접 에이전트를 띄워 여러분만의 상상력을 노션이라는 도화지 위에 1분 만에 펼쳐보세요! 🚀