코드로 구동하는 호스팅

하나의 API. 모든 인터페이스가 그것으로 구동됩니다.

대부분의 호스팅 업체는 제어판에 나중에 API를 덧붙이며, 그 결과 제어판 기능의 절반은 제대로 구현되지 않습니다. 저희는 반대로 만들었습니다. 대시보드, 관리자 콘솔, CLI, Terraform 공급자, MCP 서버 및 사용자 고유의 통합 기능 모두가 동일한 엔진 API를 사용합니다. 제어판에서 할 수 있는 일이라면 코드로도 할 수 있습니다.

인증, 범위 설정, 그리고 대규모 운영 시 발생하는 문제들

접속 방법은 두 가지이지만, 그 이면에는 하나의 일관된 원칙이 적용됩니다. 어떤 방법을 사용하든 동일한 권한 검사와 동일한 데이터베이스 수준의 격리가 보장됩니다.

데모용이 아닌, 머신을 위해 구축되었습니다

README에서는 API를 그럴싸하게 보이게 만들기 쉽지만, 실제 트래픽 환경에서 제대로 작동하게 만들기는 어렵습니다. 바로 이 부분들을 우리가 공들여 해결했습니다. 새벽 세 시에 연동을 깨뜨리는 주범이 바로 이 지점들이기 때문입니다.

대량 작업의 작동 방식에 영향을 미치므로 짚고 넘어가야 할 세부 사항이 있습니다. 중복 도메인에 대한 409 응답은 모든 테넌트를 대상으로 "이 호스트 이름이 여기에 호스팅되어 있는가?"에 답하며, 이는 열거 오라클(enumeration oracle)이자 Footprint-Free에 대한 실제적인 비익명화 위험입니다. 사이트 생성을 제한하는 것은 게으른 해결책이었을 것이며 대량 프로비저닝 제품을 완전히 망가뜨렸을 것입니다. 대신 거부된 중복 도메인 시도에 대해서만 주체(principal)별로 예산이 부과됩니다. 성공적인 생성에는 절대 부과되지 않으므로 하루 종일 대량으로 프로비저닝할 수 있으며, 탐색 시도는 거의 즉시 차단됩니다.

• 모든 실패에 대해 일관된 오류 응답 형식이 제공됩니다: 코드, 사람이 읽을 수 있는 메시지, 선택적인 필드 수준의 세부 정보, 그리고 지원팀에 문의할 때 인용할 수 있는 request_id가 포함됩니다. 유효성 검사 오류는 문제가 된 필드 이름과 함께 422 상태 코드를 반환합니다.
• POST 요청의 멱등성 키는 인라인 대신 커밋 시점에 재생 레코드가 기록되므로, 재시도가 커밋되지 않은 행을 가리키는 캐시된 201을 결코 재생하지 않습니다. 실패한 요청은 진행 중인 락을 즉시 해제하므로, 422 오류로 인해 수정된 재시도가 차단되지 않습니다.
• UUIDv7 기반의 키셋을 이용한 커서 페이지네이션 — 동시 쓰기 작업 시에도 안정적이며, 스캔 중에 행이 중간에 삽입되어도 페이지 밀림 현상이 없습니다.
• 응답에 RateLimit-Remaining이 포함되어 있어, 생성된 클라이언트가 추측하는 대신 스마트하게 백오프할 수 있습니다.
• 범위 외의 리소스는 403 대신 404를 반환합니다. 403은 해당 리소스가 존재함을 확인시켜 주기 때문입니다. 마찬가지 이유로 범위 외의 조직을 기준으로 필터링하면 빈 페이지가 반환됩니다.
• 사이트 생성은 프로비저닝이 아닌 등록입니다. POST /v1/sites는 상태가 pending인 201을 반환하며 빌드 작업으로 인해 블로킹되지 않습니다. 이벤트는 행과 동일한 트랜잭션 내에서 트랜잭셔널 아웃박스(transactional outbox)에 기록되므로, 사이트의 프로비저닝 요청이 보장되는 경우에만 사이트가 존재하게 됩니다.

엔드포인트가 다운되어도 안전하게 유지되는 웹훅

플랫폼의 이면에는 견고한 이벤트 스파인(event spine)이 자리 잡고 있습니다. 모든 상태 변경은 데이터베이스 변경과 원자적으로 Postgres의 트랜잭셔널 아웃박스(transactional outbox)에 이벤트를 기록하고, 릴레이가 이를 NATS JetStream으로 발행합니다. 이벤트는 타입과 버전이 지정되어 있으며 site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending 및 기타 항목들이 이에 해당합니다.

사이트에 코드 추가하기

API는 개발자 이야기의 절반에 불과합니다. 나머지 절반은 배포입니다.

• GitHub, GitLab 또는 Bitbucket을 OAuth를 통해 연결하고, 배포 키는 설정 파일이 아니라 자격 증명 저장소에 보관하세요.
• 푸시는 빌드 및 배포 파이프라인을 트리거하며, 브랜치와 환경 간 매핑(main은 production으로, staging은 staging으로)과 composer 및 npm을 위한 스택별 빌드 단계를 지원합니다.
• 배포에 문제가 발생할 경우 이전 릴리스로 되돌립니다.
• 방문객에게 도달하기 전에 실제 환경에서 변경 사항을 검증할 수 있도록 지원하는 스테이징 복제 및 라이브 푸시 기능입니다.
• CageFS 격리를 적용하여 사이트별로 Jailed SSH, SFTP 및 FTP를 지원하므로, 각 테넌트는 자신의 파일만 볼 수 있습니다.
• 패널 터미널 및 SSH를 통한 wp-cli.
• code-server를 통한 브라우저 환경의 VS Code — 확장 프로그램, 통합 터미널, git을 갖춘 완전한 편집기로, 사이트의 파일을 직접 편집합니다.
• 사이트별 PHP 버전, 수정 가능한 PHP 설정, 사이트별 확장 기능, 환경 변수, 그리고 WP-cron과 함께 제공되는 실제 크론(cron).

AI 에이전트가 사용할 수 있는 동일한 API

당사는 본 플랫폼을 호스팅된 MCP 서버 형태로 제공합니다. 이는 엔진 API 위에 구축된 얇은 프로토콜 어댑터로서, 동일한 액션 카탈로그, RBAC 및 감사 추적을 그대로 재사용합니다. Claude Code, Cursor, ChatGPT, Claude Desktop 또는 기타 MCP 호환 클라이언트를 한 번만 연결하면, 당사가 API에 추가하는 모든 기능이 자동으로 해당 클라이언트에서 사용 가능해집니다.

에이전트는 세 가지 요소를 받습니다. 도구(동일한 API 엔드포인트, 분산될 병렬 로직 없음), 리소스(실제 데이터를 기반으로 조치 전에 진단할 수 있도록 읽기 전용 사이트 상태, 설정, 최근 로그, 지표, 가동 시간 및 KB 문서 제공), 그리고 프롬프트(이 사이트 진단 또는 마이그레이션 준비와 같은 게시된 워크플로 템플릿)입니다.

보안도 인증과 마찬가지입니다. OAuth 2.1, 조직에 바인딩된 토큰 및 행 수준 보안이 적용된 RBAC 권한, 도구별로 범위가 지정되고 철회 가능한 권한, 프로덕션과 격리된 샌드박스가 적용됩니다. 삭제, 일시 중지, 결제, 대규모 지출과 같은 파괴적인 작업에는 명시적 확인 또는 사람의 승인 정책이 필요합니다. 속도 제한과 지출 상한선이 AI가 트리거하는 유료 작업을 제한하며, 모든 MCP 호출은 신원, 도구, 인자 및 결과와 함께 감사 로깅됩니다.

우리는 개별 앱을 하나씩 연동하는 대신 프로토콜을 지원하므로, 호스팅 연동을 변경하지 않고도 원하는 AI 툴링을 자유롭게 바꿀 수 있습니다.

관련 상품

• AI 및 MCP →
• 스테이징 및 실서비스 배포 →
• 에이전시 호스팅 →
• 맞춤형 개발 →
• 파이썬 개발 →