E2a: SPF/DKIM 검증 및 웹후크/웹소켓 전송을 지원하는 AI 에이전트용 오픈소스 이메일 게이트웨이

E2a는 AI 에이전트가 트리거로 이메일을 주고받을 수 있도록 설계된 오픈소스 이메일 게이트웨이입니다. 인증된 전송을 제공하며, 인바운드 메일은 SPF/DKIM으로 확인되고, 모든 배달에는 HMAC 서명된 X-E2A-Auth-* 헤더가 포함됩니다. 에이전트는 웹훅(클라우드 모드) 또는 WebSocket(로컬 모드, 공개 URL 불필요)을 통해 메일을 수신합니다. 아웃바운드 메일은 HTTP API를 통해 전송되며, 에이전트 간(SMTP 릴레이) 및 에이전트-사람 간(상위 SMTP, 예: SES 또는 Resend) 흐름을 지원합니다.

주요 기능:

• 이메일 스레딩이 에이전트 대화 스레딩과 일관성을 유지합니다.
• 휴먼 인더 루프 검토 기능: 아웃바운드 이메일은 대시보드, 매직 링크 이메일, 또는 CLI를 통해 승인받을 수 있습니다.
• 빠른 온보딩/오프보딩: 몇 분 내에 에이전트 이메일 주소를 추가/제거할 수 있습니다.
• WebSocket은 로컬 에이전트용, 최소 한 번 이상 전달되는 웹훅은 클라우드 에이전트용입니다.
• 선택적 HITL 보류 기능을 갖춘 아웃바운드 API.
• 공유 agents.e2a.dev 도메인과 함께 호스팅 버전 e2a.dev를 제공하여 즉시 슬러그 기반 온보딩이 가능합니다.

셀프 호스팅에는 Docker가 필요합니다. 저장소를 클론하고 다음을 실행하세요:

git clone https://github.com/Mnexa-AI/e2a.git
cd e2a
docker compose up -d

이렇게 하면 Postgres(자동 마이그레이션 포함), 포트 8080의 API 서버, 포트 2525의 SMTP 릴레이, 포트 3000의 대시보드(Caddy + Next.js)가 시작됩니다. 상태 확인: curl http://localhost:8080/api/health.

사용자 및 API 키 생성(OAuth 불필요):

docker compose exec e2a e2a -config /etc/e2a/config.yaml -bootstrap-email [email protected]

에이전트 등록 및 확인:

KEY=e2a_...
curl -X POST http://localhost:8080/api/v1/agents \
  -H " Authorization: Bearer $KEY " -H " Content-Type: application/json " \
  -d ' {"slug":"my-bot","agent_mode":"local"} '
curl -H " Authorization: Bearer $KEY " http://localhost:8080/api/v1/agents

실제 인바운드 메일을 수신하려면 도메인의 MX 레코드를 릴레이 호스트로 지정하세요. 현재 이 프로젝트는 DMARC 지원(SPF/DKIM만 지원), 범위가 지정된 API 키, HA/멀티 리전, 애플리케이션 계층 이메일 데이터 암호화, 규정 준수 인증(SOC 2/HIPAA)이 부족합니다.