UCP 검사기

스토어 주소를 입력하고 UCP 검색 파일이 실제로 존재하는지, 그리고 실제로 유효한지 확인하세요.

UCP(Universal Commerce Protocol)는 AI 어시스턴트가 스토어를 대신해 쇼핑할 수 있게 하는 개방형 표준입니다. UCP를 지원하는 스토어는 /.well-known/ucp에 기계가 읽을 수 있는 JSON 프로파일을 게시합니다. 프로토콜 버전, 제공하는 서비스, 허용하는 결제 핸들러, 서명에 사용하는 공개 키입니다. 이 검사기는 당사 서버에서 해당 파일을 가져와 공식 사양의 호스팅 및 프로파일 규칙에 따라 검사하고, 선언된 엔드포인트를 프로브합니다. 에이전트 준비 상태 검사기는 검색 파일을 여러 신호 중 하나로 찾지만, 이 도구는 UCP에 대한 심층 검사입니다. 함께 제공되는 글 UCP란 무엇이며 어떻게 검사하는가에서는 실제 문서를 직접 살펴봅니다.

마지막 업데이트:

스토어 검사

도메인(allbirds.com) 또는 전체 URL(https://allbirds.com). 검사기는 https://<도메인>/.well-known/ucp를 요청합니다. 항상 HTTPS로, 리디렉션을 절대 따라가지 않습니다.

🔒 대상은 검사 서버가 가져오며, 사용자의 브라우저가 가져오지 않습니다. CORS 차단이 없고, 스토어가 보는 것은 검사기의 요청이지 사용자의 요청이 아닙니다. 사용자에 대한 어떤 정보도 스토어에 전송되지 않습니다.

/.well-known/ucp에는 무엇이 있나

UCP 프로파일은 필수 ucp 멤버를 가진 JSON 객체입니다. 그 안에서 ucp.version, ucp.services, ucp.payment_handlers는 필수이며, 뒤의 두 항목은 비어 있어도 반드시 존재해야 합니다. ucp.capabilities는 선택 사항이지만, 유용한 커머스 프로파일은 보통 최소 하나를 선언합니다. 최상위 keys[] 배열에는 스토어의 공개 서명 키를 RFC 7517 JWK 집합으로 게시할 수 있습니다.

버전은 날짜이며 "draft" 같은 단어가 아닙니다. 첫 릴리스는 2026-01-11이고 최신 안정 버전은 2026-08-25입니다. 이전 버전을 선언하는 프로파일도 검증은 통과하지만, 이 검사기는 경고를 표시하고 아래의 호환성이 깨지는 변경 사항을 나열합니다. 상대방이 프로파일 자체 버전과 일치하지 않는 항목을 거부할 수 있기 때문입니다. 이전 버전을 계속 제공하는 스토어는 이를 supported_versions에 나열하며, 각 항목은 자체 버전 프로파일을 가리킵니다.

2026-08-25의 호환성이 깨지는 변경 사항 중 게시된 프로파일에 영향을 주는 것은 다음과 같습니다. 기존 signing_keys[] 필드가 삭제되고 최상위 keys[] JWK 집합으로 대체되었습니다. 이행 설정이 재구성되었습니다(플래그에서 allows_ 접두사가 사라지고, multi_destination이 맵에서 배열로 바뀌었습니다). 구매자 동의가 고정된 불리언 플래그에서 역방향 DNS 식별자를 키로 하는 동적 맵으로 바뀌었습니다. 결제 확장이 dev.ucp.shopping.*에서 dev.ucp.common.payment.*로 이동했습니다.

호스팅 규칙이 엄격한 이유는 프로파일이 신뢰 자료이기 때문입니다. 프로파일은 HTTPS로 제공되어야 하고, 리디렉션해서는 안 되며(3xx는 모두 실패), Cache-Control: public과 최소 60초의 max-age를 포함해야 합니다. private, no-store, no-cache는 안 됩니다. Shopify 스토어는 기본적으로 /.well-known/ucp에 2026-08-25 프로파일을 제공합니다. 데모 버튼으로 시도해 보세요.

이 검사기가 하는 일 — 하지 않는 일

서버에서 가져오고, 검증하고, 프로브합니다. 검사기는 https://<도메인>/.well-known/ucp를 직접 요청하고(한 번만, 리디렉션을 따라가지 않음), 이 페이지의 규칙에 따라 문서를 검증하며, 선언된 각 엔드포인트를 HEAD 요청으로 프로브합니다(HEAD가 거부되면 GET). 사용자의 브라우저는 대상에 직접 연결하지 않으므로 CORS로 차단되지 않습니다.

주문하지 않고, 구매자로 인증하지 않으며, 결제 핸들러의 암호를 검증하지 않습니다. 여기서 통과한 프로파일이 증명하는 것은 스토어를 발견할 수 있고 엔드포인트에 도달할 수 있다는 것뿐입니다. 결제가 성공한다거나, 가격이 맞는다거나, 결제 핸들러가 신뢰할 수 있다는 것을 증명하지 않습니다.

ACP, AP2, x402 문서는 검사하지 않습니다. UCP만 검사합니다. 선언된 엔드포인트에 도달할 수 없으면 경고이지 오류가 아닙니다. 엔드포인트가 인증을 요구할 수 있으며, 401이나 404 응답도 서버가 응답했으므로 도달 가능으로 간주합니다. 연결 자체가 완전히 실패한 경우에만 도달 불가입니다.

프로파일을 신뢰하기 전에 자신에게 솔직해지기

유효한 프로파일이 동작하는 결제와 같은 것은 아닙니다. 검색은 첫 단계일 뿐입니다. 프로파일이 알려주는 것은 스토어가 무엇을 제공하고 엔드포인트가 어디에 있는지입니다. 해당 엔드포인트가 실제 요청을 받아들이고, 실제 가격을 반환하며, 실제 주문을 완료하는지는 별개의 문제이며 이 검사기는 답하지 않습니다.

이전 버전이 실패가 아니라 경고인 데는 이유가 있습니다. 2026-04-08 버전의 스토어는 2026-04-08을 사용하는 플랫폼과 여전히 거래할 수 있습니다. 그러나 2026-08-25만 사용하는 플랫폼은 버전이 일치하지 않는 항목을 거부해야 하므로, 오래된 프로파일은 그곳에서 쇼핑할 수 있는 대상을 좁힙니다.

404는 보통 "여기에 UCP가 없음"을 의미하며 "스토어가 고장남"을 의미하지 않습니다. 인터넷상의 대부분의 사이트는 UCP 프로파일을 전혀 게시하지 않습니다. 부정적 데모가 정확히 그것을 보여줍니다. 프로파일이 없다는 것을 스토어 자체의 오류가 아니라 스토어의 에이전트 준비 상태에 대한 사실로 받아들이세요.

핵심 사실

Universal Commerce ProtocolAI 어시스턴트가 스토어의 카탈로그, 결제, 애프터서비스를 검색하고 구매자를 대신해 거래할 수 있게 하는 개방형 표준.
검색 파일스토어 자체 도메인의 /.well-known/ucp에 게시되는 JSON 프로파일.
최신 버전2026-08-25. 버전은 날짜입니다. 첫 릴리스는 2026-01-11이었습니다.
필수 필드ucp.version, ucp.services, ucp.payment_handlers. 뒤의 두 항목은 비어 있어도 반드시 존재해야 합니다. ucp.capabilities는 선택 사항입니다.
캐시 규칙Cache-Control: public과 최소 60초의 max-age. private, no-store, no-cache는 안 됩니다.
리디렉션 규칙프로파일은 HTTPS로 리디렉션 없이 제공되어야 합니다. 3xx 응답은 모두 실패입니다.
공식 사양Universal Commerce Protocol (UCP) Official Specification

자주 묻는 질문

검사가 브라우저가 아니라 서버에서 실행되는 이유는 무엇인가요?

브라우저가 교차 출처 읽기를 차단하기 때문입니다. sysosx.com의 페이지는 다른 스토어의 /.well-known/ucp를 직접 가져올 수 없습니다. 스토어 서버가 CORS 헤더로 허용해야 하는데, 대부분의 스토어는 허용하지 않습니다. 검사기는 해당 제한이 적용되지 않는 자체 서버에서 파일을 가져와 결과를 브라우저로 반환합니다.

제 스토어는 Shopify에 있습니다. 직접 게시해야 할 것이 있나요?

아니요. Shopify는 모든 스토어에 기본적으로 /.well-known/ucp에 2026-08-25 프로파일을 제공합니다. allbirds.com을 검사하는 데모 버튼을 시도해 보세요. Shopify 스토어에서 검사가 실패한다면 원인은 다른 곳에 있습니다(스토어 앞의 리디렉션, 또는 스토어를 가리키지 않는 사용자 지정 도메인).

문서는 있는데 판정이 "부분적"입니다. 무엇을 먼저 수정해야 하나요?

먼저 실패로 표시된 항목을 수정하세요. 누락된 필수 필드(버전, 서비스, 결제 핸들러), 유효하지 않은 JSON 문서, 또는 리디렉션입니다. 경고(60초 미만의 캐시 헤더, 이전 버전, 도달할 수 없는 엔드포인트)는 참고 사항이며 그 자체로는 UCP 준비 완료 판정을 막지 않습니다.