Notion Developer Platform으로 설계하는 AI 에이전트 자동화

2026년 5월 13일 공개된 Notion Developer Platform은 기능 몇 개를 덧붙인 업데이트가 아니다. 서버리스 코드 실행 환경인 Workers, 외부 AI 에이전트를 연결하는 External Agents API, 멀티스텝 자동화 워크플로우를 묶어 Notion의 역할 자체를 바꾸려는 시도다.

Notion은 2026년 2월 Custom Agents를 출시한 뒤 100만 개 이상의 에이전트가 생성될 만큼 빠른 확산을 경험했다. 다만 Custom Agents만으로는 Notion 밖의 AI 도구를 연결하거나 별도의 비즈니스 로직을 실행하기 어려웠다. Notion 3.5 업데이트인 Developer Platform은 이 제약을 코드 실행과 외부 에이전트 연동으로 풀어낸다.

문서 저장소에서 에이전트 작업 레이어로

Developer Platform의 방향은 Notion을 AI 에이전트가 데이터를 읽고 쓰는 표준화된 작업 레이어로 만드는 데 있다. 외부 에이전트는 Notion 데이터베이스를 직접 조회하고, 커스텀 코드는 Notion 인프라에서 실행된다. 외부 시스템에서 발생한 이벤트는 웹훅을 통해 자동화 흐름을 시작할 수 있다.

⤢✕

이 구조에서는 Notion 데이터베이스가 여러 에이전트 사이의 공유 작업 메모리가 된다. Workers가 실행과 이벤트 처리를 맡고, Custom Agents와 외부 에이전트가 같은 데이터 위에서 작업을 이어간다.

Workers가 맡는 코드 실행과 이벤트 처리

Notion Workers는 Notion 인프라에서 실행되는 서버리스 런타임이다. 개발자는 별도 서버를 관리하지 않고 CLI로 코드를 배포하며, 배포된 코드는 보안 샌드박스 안에서 동작한다.

Workers의 핵심 용도는 세 가지다.

Database Sync는 외부 API의 데이터를 Notion 데이터베이스와 동기화한다. GitHub Issues, Jira 티켓, Salesforce 레코드 같은 데이터를 Worker 하나로 Notion에 실시간 반영할 수 있다. 기존에는 Zapier나 n8n 같은 외부 자동화 플랫폼을 거쳐야 했던 흐름을 Notion 안에서 끝낼 수 있게 된 것이다.

Custom Agent Tools는 Notion Custom Agents의 실행 범위를 넓힌다. 특정 계산, 외부 API 호출, 복잡한 데이터 변환이 필요하다면 해당 로직을 Worker로 작성한 뒤 에이전트 도구로 등록할 수 있다.

Webhook Triggers는 외부 애플리케이션의 이벤트를 자동화 시작점으로 사용한다. Worker가 웹훅을 받은 뒤 비즈니스 로직을 실행하고, Notion 데이터베이스를 갱신하거나 외부 API를 호출하는 방식이다.

배포부터 실행 결과까지 이어지는 경로

Workers 코드는 CLI를 거쳐 등록되고 버전 관리된다. 실행 시에는 샌드박스가 외부 API와 Notion 데이터베이스 사이에서 로직을 처리한다.

⤢✕

Workers는 Notion 인프라의 에지 노드에서 코드를 실행해 외부 서버를 왕복하는 지연을 없앤다. 실패한 Worker는 내장된 에러 처리에 따라 자동 재시도되며, 실행 로그는 Notion 대시보드에 보존된다.

베타 기간에는 무료로 제공되고, 2026년 8월 11일부터 Notion Credits 시스템으로 전환된다. 코드 실행 비용은 AI 추론보다 훨씬 낮게 구성됐다. 일일 사용 기준으로 월 약 0.01달러부터, 집중적으로 사용할 때는 월 13달러 수준이다.

Zapier·n8n과 역할이 갈리는 지점

항목	Notion Workers	Zapier / n8n
코드 실행	직접 JavaScript 코드	노코드 액션 블록
Notion 통합	네이티브 DB 직접 접근	REST API 경유
지연 시간	에지 실행, 저지연	외부 서버 왕복
버전 관리	CLI 기반 배포	없음(버전 스냅샷 제한적)
에이전트 도구 등록	네이티브 지원	불가

Workers가 기존 자동화 플랫폼의 모든 역할을 가져가는 것은 아니다. 여러 애플리케이션을 복잡하게 연결하거나 비기술 사용자가 노코드로 자동화를 구성해야 한다면 Zapier와 n8n이 더 적합하다. 반면 Notion 데이터베이스와 AI 에이전트가 워크플로우의 중심이라면 Workers의 네이티브 접근 방식이 유리하다.

Zapier와 Make는 수천 개의 앱을 연결하는 이벤트 라우팅에 강하다. Workers는 범위를 좁혀 Notion 안의 비즈니스 로직과 에이전트 도구 실행에 집중한다.

오픈소스이며 자체 호스팅할 수 있는 n8n은 복잡한 조건 분기와 루프 처리에서 앞선다. Workers는 별도 호스팅이 필요 없고 Notion과 직접 통합된다는 점이 차이다.

Notion의 Custom Agents와 Workers도 같은 사용자를 두고 경쟁하지 않는다. Custom Agents는 노코드 사용자를 위한 계층이고, Workers는 개발자가 작성한 기능을 그 에이전트에 연결하는 계층이다.

External Agents API와 권한 위임

External Agents API는 외부 AI 에이전트가 Notion을 데이터 레이어로 다룰 수 있게 만든 표준화된 인터페이스다. 출시 시점에는 Claude Code, Cursor, Codex, Decagon을 공식 지원하며, 지원 목록은 계속 확대될 예정이다.

인증에는 OAuth 2.0 위임 방식을 사용한다. 사용자가 외부 에이전트에 접근 권한을 부여하면 에이전트는 허용된 범위 안에서만 Notion 데이터베이스를 읽고 쓸 수 있다.

이 설계가 따르는 보안 원칙은 세 가지다.

최소 권한 원칙: 명시적으로 허용된 데이터베이스만 에이전트에 노출한다.
감사 추적: 에이전트가 수행한 모든 액션을 Notion 워크스페이스 로그에 기록한다.
취소 가능성: 사용자는 필요할 때 에이전트의 접근 권한을 철회할 수 있다.

⤢✕

외부 에이전트를 연결하는 실무 패턴

External Agents API로 구성할 수 있는 핵심 패턴은 네 가지다.

프로젝트 데이터베이스를 질의하는 에이전트

Claude Code가 Notion 프로젝트 데이터베이스를 조회해 스프린트 상태를 분석하고 병목 태스크를 식별한다. 개발자는 별도 대시보드를 만들지 않고 이번 스프린트의 블로커를 요약하도록 요청할 수 있다.

코드 변경과 기술 문서 동기화

Cursor가 코드 변경사항을 분석하고 Notion의 기술 문서를 갱신한다. PR이 머지되면 Worker가 웹훅을 받고, Cursor가 변경 내용을 문서에 반영하는 흐름이다.

에이전트와 자동화를 잇는 멀티스텝 작업

외부 에이전트가 여러 작업 단계를 Notion을 매개로 조율한다. Codex가 버그를 수정한 뒤 Notion 이슈 데이터베이스를 업데이트하고, Workers가 Slack 알림을 발송하는 파이프라인을 단일 에이전트 실행으로 연결할 수 있다.

여러 에이전트가 공유하는 상태 저장소

Notion을 에이전트 사이의 공유 상태 저장소로 활용할 수도 있다. 에이전트 A가 수집한 데이터를 Notion에 기록하면 에이전트 B가 그 데이터를 받아 다음 작업을 수행한다. 이 방식으로 비동기 멀티에이전트 아키텍처를 구성할 수 있다.

아직 남아 있는 API 경계

Notion API는 페이지, 데이터베이스, 블록 수준의 CRUD를 지원하지만 완전히 성숙한 개발자 플랫폼이라고 보기는 어렵다. 댓글 스레드, 서브페이지 중첩 구조, 고급 필터에는 여전히 제약이 있다. Developer Platform과 함께 API 문서와 SDK가 강화됐지만, 개발자 플랫폼으로 자리 잡으려면 API 범위가 더 확장돼야 한다.

수익화는 Notion Credits로 통합된다. AI 추론을 사용하는 Custom Agents와 코드 실행을 담당하는 Workers가 같은 크레딧 체계에서 청구되므로 비용을 예측하기 쉽다. 다만 크레딧이 소진돼 자동화가 중단되는 상황을 피하려면 임계치 알림을 설정해야 한다.

공식 지원 외부 에이전트는 2026년 연말까지 20개 이상으로 늘어날 것으로 예상된다. Devin, GitHub Copilot, Gemini 등 주요 AI 코딩 에이전트와의 통합도 로드맵에 올라 있다.

Notion Developer Platform의 핵심은 문서 기능을 늘리는 데 있지 않다. Workers의 서버리스 코드 실행, External Agents API의 외부 연결, 웹훅 기반 이벤트 처리가 결합하면서 Notion은 에이전트가 작업 상태를 공유하고 다음 단계를 실행하는 오케스트레이션 레이어로 이동한다. Claude Code, Cursor, Codex 같은 도구가 Notion을 공유 작업 메모리로 활용하는 패턴이 자리 잡는다면 Notion은 AI 네이티브 개발 워크플로우의 핵심 인프라가 될 가능성이 높다.