제출이 거부된 경우, 대부분 코드 문제보다는 다음 항목들 때문입니다: 네임스페이스 오류, TXT 레코드 위치 오류, 설명(description) 초과, 버전 중복.
우리는 자체 x402 데이터 마켓을 제출할 때 이러한 함정들을 모두 경험했습니다—동일한 버전 번호로 중복 게시할 수 없음(1.0.0 → 1.0.1로 반드시 변경해야 함), TXT 레코드는 반드시도메인 루트대신 _mcp-auth 이러한 선택기 하에서는 description이 100자 이상일 경우 즉시 거부됩니다. 이 도구는 공식 규칙에 따라 항목별로 검사하고 직접 실행 가능한 명령어 시퀀스를 생성합니다.
—
—
| 오류 / 현상 | 실제 원인 | 어떻게 수정하나요? |
|---|---|---|
| version already exists | 동일한 버전 번호로 중복 게시할 수 없음 | 버전 번호를 +1 증가시킨 후(1.0.0 → 1.0.1) 다시 게시하세요 |
| generic signature error | TXT 레코드가 다음 위치에 배치됨 _mcp-auth.도메인 이러한 선택기 하에서 | 반드시 다음 위치에 배치해야 함도메인 루트(apex), DKIM 방식이 아닌 SPF 방식으로 배치하세요 |
| 키를 변경한 후에도 검증이 여전히 실패함 | 이전 TXT 레코드가 삭제되지 않아 우선적으로 읽힘 | 키를 교체할 때 이전 TXT 레코드도 동기적으로 삭제하세요. |
| HTTP 검증 시 로컬 curl은 통과하지만 공식 서버는 실패함 | 공식적으로는 자체 서버에서 풀링합니다. 또한3xx를 따르지 않음 | 검증 파일은 반드시 200 응답을 직접 반환해야 하며, 리디렉션해서는 안 됩니다. IPv6 AAAA 레코드가 접근 가능한지 확인하세요. |
| 네임스페이스 검증 실패 | name은 도메인 이름의 역순 형식이 아닙니다. | feegate.org 대응 org.feegate/* |
| description가 거부됨 | 100자 초과 | 100자 이내로 압축하고, 자세한 내용은 README에 남기세요 |
| macOS에서 키 생성에 실패함 | 시스템 LibreSSL은 Ed25519를 지원하지 않습니다 | OpenSSL 3.0+를 사용하세요(brew install openssl@3） |
1 · 동일한 버전 번호로 재배포할 수 없습니다.게시 성공 후 description을 수정하려면 버전을 반드시 1.0.0에서 1.0.1로 올려야 하며, 그렇지 않으면 바로 거부됩니다.
2 · TXT 레코드는 도메인 루트에 있어야 합니다.직관적으로 기록이 다음 위치에 추가될 것으로 예상됨 _mcp-auth.example.com, 공식적으로는 apex만 인식함(example.com), 선택기(selector)를 추가하면 일반화된 서명 오류가 발생하며, 위치 오류임을 파악하기 어렵습니다
3 · PR을 제출하는 것이 아니라 릴리스합니다.공식 저장소에 server.json을 추가하거나 seed.json을 수정해도 등록되지 않으며, 반드시 CLI를 사용하여 자신의 프로젝트 디렉터리에서 게시해야 합니다.
4 · 공식 서버의 풀링과 본인의 curl 실행은 서로 다른 작업임.공식 인프라에서 접근하며 리디렉션을 따르지 않으며, IPv6 레코드가 도달 불가능한 주소를 가리키면 바로 실패합니다(브라우저에서 IPv4는 정상 작동하더라도).