AI 에이전트 시대의 온보딩 병목은 제품 UI가 아니라 ‘발견(Discovery) 레이어’에서 터진다. 사람이 읽는 문서를 잘 써도, 에이전트가 프로토콜 경로에서 스펙을 못 찾으면 첫 세션은 곧바로 실패다. 이 실패는 곧 “도입 불가”로 번역되고, 우리가 DevRel·콘텐츠·커뮤니티에 태운 비용은 CAC로 그대로 굳는다.
dev.to의 에이전트 준비성(Agent-readiness) 스캔 결과는 잔인하게 명확하다. 10개 유명 개발자 도구를 32개 시그널로 점검했는데, ‘통과’는 Resend 1개뿐이었다(“I Scanned 10 Developer Tools…”, dev.to). 핵심은 API 품질이 아니라 기계가 읽을 수 있는 입구가 있느냐였다. Resend는 /.well-known/mcp.json(MCP 표준 발견 경로), 공개 OpenAPI, 홈페이지 구조화 데이터, 일관된 JSON 에러로 “에이전트가 혼자서 평가→연동”이 가능한 최소조건을 갖췄다.
반대로 Stripe·Vercel 같은 ‘개발자 친화’의 상징도 에이전트 관점에서는 낙제에 가깝다. OpenAPI가 표준 경로에 없거나 로그인 뒤에 숨어 있고, 어떤 엔드포인트는 HTML을 돌려준다. 에이전트에게 HTML은 “여기서 멈춰”라는 신호다. Postmark의 429 레이트리밋도 마찬가지다. Retry-After나 X-RateLimit-* 없이 막아버리면, 악성 트래픽만이 아니라 ‘정상적인 에이전트 탐색’까지 함께 차단된다. 온보딩 마찰은 이렇게 기술 사소함(경로, 헤더, MIME 타입)에서 발생하고, 활성화(Activation)에서 바로 이탈로 이어진다.
여기서 중요한 맥락: llms.txt는 채택이 늘었지만(10개 중 8개), 그것만으로는 온보딩을 못 푼다. llms.txt는 “무슨 제품인가”를 설명하는 데 유리할 뿐, MCP/A2A 같은 프로토콜 기반 발견 메커니즘을 대체하지 못한다. Neon이 수만 라인의 llms 텍스트를 갖고도 준비성 점수가 낮았다는 사례는, 콘텐츠 투자와 활성화 지표가 따로 놀 수 있음을 보여준다. 즉, 문서의 양이 아니라 ‘스펙의 위치와 형식’이 퍼널을 결정한다.
실행 가능한 레버는 이미 나와 있다. dev.to의 또 다른 글은 MCP 서버 문서를 30초 만에 자동 생성하는 방식( MCPSpec )을 제시한다(“How to generate docs for your MCP server in 30 seconds”, dev.to). 서버에 한 줄을 붙이면 /docs(인터랙티브 문서), /mcpspec.yaml(이식 가능한 스펙), 기존 /mcp를 함께 제공한다. 이게 그로스 관점에서 중요한 이유는 ‘문서 드리프트(현실과 문서 불일치)’를 거의 0에 가깝게 만들고, 에이전트/개발자 모두에게 동일한 진실 공급원을 제공하기 때문이다. 온보딩의 실패율이 줄면 Activation이 오르고, DevRel 인바운드의 CAC가 내려간다.
또 하나의 축은 “에이전트를 위한 README” 패턴이다. Claude Code의 CLAUDE.md처럼 프로젝트 컨텍스트·규칙·금지구역을 버전관리된 파일로 제공하면, 세션마다 반복되는 설명 비용(토큰/시간/오해)을 줄이고 초기 성공률을 끌어올린다(“The CLAUDE.md Pattern…”, dev.to). 이것은 단순 문서가 아니라 설정(configuration)이다. 설정이 좋아지면 첫 작업 성공률이 오르고, 이는 곧 D1 리텐션과 팀 단위 확산(바이럴 계수의 B2B 버전)을 자극한다.
시사점은 명확하다. 에이전트 온보딩 최적화의 핵심 KPI는 ‘문서 조회수’가 아니라 에이전트가 무인으로 통과하는 퍼널이다. 추천하는 최소 체크리스트는 ① /.well-known/mcp.json 제공(또는 표준 발견 경로 준수) ② 공개 OpenAPI/MCPSpec을 기계가 읽을 수 있는 MIME으로 제공 ③ 가격/기능의 구조화 데이터(schema.org 등) ④ JSON 에러 일관성 ⑤ 레이트리밋 헤더로 자율 스로틀링 가능 ⑥ 약관이 자동 접근을 불필요하게 금지하지 않는지 정리. 이 6개는 기능 개발이 아니라 “입구 설계”이며, 지금 당장 CAC와 Activation을 움직이는 레버다.
전망: 가까운 미래의 DevRel은 ‘튜토리얼 콘텐츠’보다 ‘프로토콜 호환성’ 경쟁으로 이동한다. 에이전트가 도구를 고르는 기준은 감성적 브랜드가 아니라, 스캔 한 번에 비교 가능한 스펙·가격·정책의 기계 가독성이다. 통과한 제품은 GEO(에이전트/LLM 기반 검색·추천)에서 상위 노출을 가져가고, 온보딩 비용이 낮아진 만큼 더 빠르게 실험-확장 루프를 돌린다. 결국 “에이전트가 쓰기 쉬운 제품”이 “사람에게도 쓰기 쉬운 제품”을 대체하는 게 아니라, 획득과 활성화의 새로운 표준이 된다.