Rate Limits & Quotas
WPControl의 플랜별 사용 한도와 제한 정책입니다.
플랜별 한도
| 항목 | Free | Pro | Agency |
|---|---|---|---|
| 월간 도구 호출 | 500회 | 10,000회 | 무제한 |
| 최대 사이트 수 | 1개 | 10개 | 무제한 |
| API 키 수 | 2개 | 10개 | 50개 |
| 분당 요청 (rate limit) | 20 req/min | 60 req/min | 120 req/min |
| 가격 | 무료 | $15/월 | $39/월 |
월간 쿼터
월간 쿼터는 성공한 MCP 도구 호출 수를 기준으로 집계됩니다. 실패한 호출(오류 응답)은 카운트되지 않습니다.
- 쿼터는 매월 1일 UTC 00:00에 리셋됩니다 (KST 기준 오전 9:00).
- 대시보드 → Usage에서 현재 월의 사용량을 확인할 수 있습니다.
- 쿼터 초과 시 MCP 도구 호출은
429 Too Many Requests로 거부됩니다. - 쿼터를 초과하지 않으려면 대시보드에서 사용량을 모니터링하거나 플랜을 업그레이드하세요.
i
쿼터는 API 키 단위가 아닌 테넌트(계정) 단위로 집계됩니다. 여러 API 키를 사용하더라도 같은 계정이라면 쿼터를 공유합니다.
분당 요청 제한 (Rate Limiting)
MCP 도구 호출은 플랜별로 분당 요청 수가 제한됩니다. 제한을 초과하면 429 Too Many Requests가 반환됩니다.
| 플랜 | 분당 제한 | 처리 방식 |
|---|---|---|
| Free | 20 req/min | 초과 시 즉시 거부 |
| Pro | 60 req/min | 초과 시 즉시 거부 |
| Agency | 120 req/min | 초과 시 즉시 거부 |
i
분당 요청 제한은 슬라이딩 윈도우 방식으로 계산됩니다. 잠시 기다린 후 재시도하면 자동으로 해제됩니다.
대시보드 API 제한
대시보드에서 사용하는 REST API (/api/dashboard/*)도 별도의 rate limit이 적용됩니다.
| 엔드포인트 | 제한 |
|---|---|
| /api/dashboard/* | 60 req/min (계정당) |
플랜 다운그레이드 정책
Pro(10개 사이트) → Free(1개 사이트)로 다운그레이드 시:
- 대시보드에 "사이트 한도 초과" 경고 배너가 표시됩니다.
- 가장 먼저 등록한 1개 사이트만 활성 상태를 유지합니다.
- 나머지 사이트는 비활성화되지만 데이터는 삭제되지 않습니다.
- Pro로 업그레이드하면 모든 사이트가 즉시 복구됩니다.
!
다운그레이드 후 비활성 사이트의 MCP 도구 호출은 차단됩니다. 업그레이드 전까지 해당 사이트의 WordPress 관리 기능을 사용할 수 없습니다.
Grace Period (결제 유예)
구독을 취소하거나 결제가 실패한 경우, 결제일까지 유예 기간이 적용됩니다. 유예 기간 동안에는 이전 플랜의 모든 기능을 계속 사용할 수 있습니다. 유예 기간 만료 후 Free 플랜으로 자동 다운그레이드됩니다.