Agentic Inbox는 Cloudflare 계정 하나로 모든 것을 자체 운영할 수 있는 이메일 클라이언트다. 수신은 Cloudflare Email Routing으로 처리하고, 메일박스는 각자 독립된 Durable Object(SQLite DB)에 격리되며, 첨부 파일은 R2에 저장된다. 내장 AI 에이전트는 수신함을 읽고, 검색하고, 초안을 작성하며, 새 메일이 도착하면 자동으로 답장 초안을 생성한다.

아키텍처

┌──────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   브라우저    │────>│  Hono Worker     │────>│  MailboxDO      │
│  React SPA   │     │  (API + SSR)     │     │  (SQLite + R2)  │
│  에이전트 패널│     │                  │     └─────────────────┘
└──────┬───────┘     │  /agents/* ──────┼────>┌─────────────────┐
       │             │                  │     │  EmailAgent DO  │
       │ WebSocket   │                  │     │  (AIChatAgent)  │
       └─────────────┤                  │     │  이메일 도구 9개  │
                     │                  │────>│  Workers AI     │
                     └──────────────────┘     └─────────────────┘

• AI 에이전트: Cloudflare Agents SDK(AIChatAgent) + AI SDK v6
• LLM: Workers AI (@cf/moonshotai/kimi-k2.5) 기본 사용
• 프론트엔드: React 19, React Router v7, Tailwind CSS, TipTap(리치 텍스트)

주요 기능

• 완전한 이메일 클라이언트: 발송·수신·스레드 보기·폴더·검색·첨부 파일 모두 지원
• 메일박스 격리: 각 메일박스는 독립 Durable Object에서 SQLite로 운영
• AI 에이전트 사이드 패널: 9개 이메일 도구로 읽기·검색·초안 작성·발송 수행
• 수신 시 자동 초안: 새 메일 도착 시 에이전트가 자동으로 답장 초안 생성 (명시적 확인 후 발송)
• MCP 서버: /mcp 엔드포인트로 Claude Code·Cursor 등 외부 도구와 연동 가능

스택

설치

“Deploy to Cloudflare” 버튼 한 번으로 R2·Durable Objects·Workers AI가 자동으로 프로비저닝된다. 이후 Cloudflare Access 설정, Email Routing 캐치올 규칙, Email Service 바인딩을 추가로 구성해야 한다.

npm install
npm run dev   # 로컬 개발
npm run deploy  # 배포

보안 모델

Cloudflare Access 정책이 단일 신뢰 경계다. 정책을 통과한 모든 사용자는 모든 메일박스에 접근할 수 있으므로, 개인 사용이나 팀 내 공용 인박스 시나리오에 적합하다. 메일박스별 개별 권한은 지원하지 않는다.

활용 대상

• Cloudflare 인프라 위에 데이터를 보유하면서 AI 보조 이메일 워크플로를 원하는 개발자·팀
• 이메일 에이전트의 실제 구현 사례를 학습하려는 AI 에이전트 개발자
• 기존 SaaS 이메일 클라이언트 대신 직접 운영 가능한 셀프호스팅 솔루션을 찾는 팀

관련 문서

• browser-run — Cloudflare 클라우드 브라우저 인프라 (AI 에이전트용)
• agent-governance — AI 에이전트 거버넌스 및 운영 프레임워크

참고 자료

• cloudflare/agentic-inbox — GitHub 공식 저장소