ainote

테마

OpenAPI & Domain Verification Log ​

ainote 의 OpenAPI 3.1 mirror 와 도메인 인증 상태 기록. OpenAI Custom GPT Store, marketplace 등록 심사 시 참조용.

OpenAPI 3.1 mirror ​

  • Spec URL: https://api.ainote.dev/api/mcp/openapi.json
  • Generator: Api::Mcp::OpenapiController (Rails 8)
  • Source: same tool registry as Api::McpController#tools/list
  • Tool annotations: x-mcp-annotations extension (readOnlyHint / destructiveHint / idempotentHint / openWorldHint)
  • Auth scheme: McpKeyAuth (header Authorization: McpKey <key>)
  • Tools count: 26 (2026-05-14 기준)
  • First publish: 2026-05-14 commit 4854550fa

Domain Mapping ​

DomainServiceFirst mappedStatus
app.ainote.devainote web (srv-d1h0cpripnbc73b8j6p0)2026-02-22✅ verified
api.ainote.devainote web (srv-d1h0cpripnbc73b8j6p0)2025-08-01✅ verified
docs.ainote.devainote-docs (srv-d7ttcagsfn5c73cfdi30)2026-05-07✅ verified
ainote.dev (apex)(Netlify 블로그, 별개 서비스)—본 docs 와 무관
www.ainote.dev(Netlify 블로그, 별개 서비스)—본 docs 와 무관

마케팅 + 문서 surface 는 docs.ainote.dev 가 단일 진입점. apex (ainote.dev) 와 www.ainote.dev 는 기존 Netlify 블로그가 사용 중이라 본 docs 와 분리.

OpenAI Custom GPT — Verified Domain ​

OpenAI 는 Custom GPT 의 privacy policy URL hostname 의 root domain (ainote.dev) DNS TXT 인증을 요구한다.

인증 절차 ​

  1. ChatGPT 에서 TXT 값 발급 — https://chat.openai.com → 좌하단 프로필 → Settings → Builder profile → Verified domain → Add → 도메인 ainote.dev 입력 → OpenAI 가 openai-domain-verification=dv-<랜덤> TXT record 제공
  2. GoDaddy 에 TXT 추가 — DNS 패널 → 신규 레코드 추가
    • 유형: TXT, 이름: @, 데이터: openai-domain-verification=dv-... (Step 1 값 그대로), TTL: 1시간
  3. 검증 클릭 — ChatGPT 로 돌아가 Verify → DNS 전파 (5분~24시간) → ✓ verified
  4. 그 후 모든 Custom GPT 의 Privacy policy URL = https://docs.ainote.dev/legal/privacy 가능, Action URL = https://api.ainote.dev/... 가능

Custom GPT Privacy URL 정책 일치 ​

OpenAI 는 다음 두 hostname 의 root domain 이 같아야 verified 도메인 사용 가능:

  • Privacy policy URL host: docs.ainote.dev → root ainote.dev ✅
  • OpenAPI server URL host: api.ainote.dev → root ainote.dev ✅
  • Verified domain (ChatGPT 인증): ainote.dev ✅ (모두 일치)

인증 진행 상태 ​

  • Privacy Policy URL: https://docs.ainote.dev/legal/privacy (page live since 2026-05-14, commit b7ba25ffa)
  • Verification request 일자: 2026-05-14
  • TXT value: openai-domain-verification=dv-ltBoPxu2ndZN8icGMhYpr83u
  • DNS TXT added at GoDaddy: 2026-05-14 — propagation confirmed on 8.8.8.8 / 1.1.1.1 / system resolver
  • Verified at ChatGPT: 2026-05-14 ✅
  • 첫 Custom GPT 공개: TBD

Tool surface 변경 이력 ​

각 minor version 의 tool 변경 (추가 / 제거 / annotation 변경) 기록.

DateChangeCommit
2026-05-14OpenAPI 3.1 mirror published; 26 tools4854550fa
2026-05-14Annotations 4-hint 부착 on all 26 toolsd588fe796
2026-05-14handoff_save / handoff_get add time HHMM paramb3fd9f04c

tools_count 변경 시 본 표에 추가.

Marketplace 등록 진행 상황 ​

docs/todo/MARKETPLACE_REGISTRATION_KIT.md 참조 — 9개 디렉토리 등록 자료 + 등록 로그.