REST API · MCP · /home 광역 스킬 — 말로 글을 쓴다
콘텐츠를 다루는 REST API, 그것을 감싸는 MCP, 그리고 어디서든 부르는 /home 스킬.
엔진의 핵심은 API다. 글·프로젝트·페이지·저서·이미지·캔버스가 모두 같은 방식으로 다뤄진다.
REST API
/api/v1 아래에 자원별 엔드포인트가 있다. 글을 예로 들면 — 목록 조회, 단건 조회, 생성, 수정, 발행, 삭제가 전부 표준 HTTP 메서드로 동작한다. 본문은 Markdown으로 주면 서버가 HTML로 변환해 캐시한다. 검증과 권한 체크는 모든 입구에서 똑같이 적용된다.
MCP — AI의 손잡이
그 API를 MCP 서버로 한 번 감쌌다. 덕분에 AI 클라이언트는 "글을 써라", "이미지를 올려라" 같은 '도구'로 사이트를 다룬다. 내 PC에서 가볍게 돌아가고, 서버는 PHP만 있으면 된다.
/home 광역 스킬
여기서 한 발 더 나아갔다. 어느 프로젝트 폴더에서 개발하다가도 /home 한마디면 홈페이지를 건드릴 수 있다.
- "이 작업 블로그로 정리해줘" → 초안이 써지고, 확인하면 발행된다
- "새 프로젝트 만들어줘" → 프로젝트가 생기고 커버 이미지까지 붙는다
- "캔버스로 정리해줘" → 노드와 화살표로 된 캔버스가 만들어진다
도구를 만드는 일과 그것을 기록하는 일 사이의 거리가, 명령 한 줄로 줄었다.