WooCommerce UCP는 Shopify와 달리 플러그인 기반 수동 설정 방식으로 캐시 무효화, REST API 접근 등 WordPress 인프라 관련 문제 발생 가능성 높음

Context

WooCommerce는 전 세계 이커머스 점포의 25~30%를 점유하지만 UCP는 플랫폼 코어에 내장되지 않아 별도 플러그인 설치와 구성이 필수다. Shopify는 앱 설치만으로 UCP가 자동 활성화되는 반면 WooCommerce는 매니페스트 생성, MCP 전송, 자동 기능 감지를 수동 설정해야 한다.

Technical Solution

• WooCommerce UCP 구현 시 UCPReady by Zologic 플러그인을 설치하고 매니페스트 키 생성 후 기능 구성 수행
• /.well-known/ucp 경로에 대한 캐시 플러그인 HTML 캐싱 비활성화 및 보안 플러그인 접근 허용 설정
• /wp-json/ucp/v1/mcp REST API 엔드포인트를 보안 설정에 화이트리스트 등록하여 외부 에이전트 접근 허용
• 결제 게이트웨이 추가 시 매니페스트 수동 리싱크 또는 게이트웨이 변경 시 자동 재생성 구성
• PHP 메모리 할당량 확인 및 MCP 도구 탐색 시 전송되는 인증되지 않은 요청 처리 설정 검증

Impact

모니터링 데이터 기준 WooCommerce UCP 점포 중 다수에서 /.well-known/ 경로 404 또는 캐시된 HTML 오류 반환, MCP 엔드포인트 401/403 응답 발생 확인

Key Takeaway

WooCommerce UCP는 WordPress 인프라 복잡성으로 인해 관리형 플랫폼보다 구성 실패 지점이 많으므로 지속적인 모니터링과 알림 설정이 필수적이다.