MCP 기반 AI 웹 플랫폼 구축: 11일간 69개 기능 구현 및 UX 최적화

Building an AI-native web platform: 69 features in 11 days (solo dev log)

Michael Egberts2026년 4월 28일1분intermediate

AI 요약

Context

AI 어시스턴트를 통한 웹사이트 생성 과정에서 단순 오타 수정 시 전체 페이지 패치가 필요한 비효율적 UX 발생. MCP 기반 도구들과 외부 서비스 연동 시 세션 불안정 및 DNS 전파 지연으로 인한 SSL 인증 실패 문제 직면.

iframe 기반 Visual Editor(WPE v2) 설계를 통한 Click-to-edit 및 Drag-and-drop 인터페이스 구현
AI 어시스턴트와 동일한 PAPI 엔드포인트를 공유하여 데이터 일관성 확보 및 편집 효율 증대
Internal Integration Cookbook 정의를 통해 Manifest JSON 기반의 표준화된 IAPI 핸들러 구조 확립
OAuth 2.1 및 PKCE 도입 후 Token Refresh와 Session Persistence를 포함한 6단계 계층 방어 전략으로 401 에러 해결
Certbot 호출 전 CNAME Resolution 선제 검증 로직을 추가하여 SSL 인증 실패 방지 및 에러 메시지 구체화

AI 기반 생성 시스템에서도 세밀한 편집을 위한 Human-in-the-loop Visual Editor의 분리 설계가 필수적이며, 외부 연동 인터페이스의 표준화(Cookbook)를 통해 기능 확장 속도를 극대화 가능함.

실천 포인트

1. AI 생성 콘텐츠 수정 시 전체 재생성이 아닌 부분 편집 가능한 Visual Editor 레이어 검토

2. 외부 API 연동 시 Manifest 기반의 표준 핸들러 구조를 설계하여 개발 리드타임 단축

3. OAuth 기반 세션 관리 시 Token Refresh 및 Error Boundary를 포함한 다층적 복구 전략 수립

4. 인프라 자동화 단계에서 DNS 전파 확인 후 다음 프로세스를 진행하는 Pre-validation 단계 추가

태그