제품을 에이전트 호출 가능하게 만드는 방법: 에이전트 가입(Agent Signup) 기능을 구축하며 배운 점

누구도 우리에게 이 플레이북(Playbook)을 건네주지 않았습니다. 우리는 우연히 직접 만들어냈습니다.

AI 어시스턴트가 Cosmic과 어떻게 상호작용할지 고민하기 시작했을 때, 우리는 배포(Distribution)를 생각하고 있지 않았습니다. 우리는 개발자 경험(Developer Experience)을 생각하고 있었습니다. 즉, 사람이 모든 일을 멈추고 대시보드에서 키(Key)를 복사해서 붙여넣지 않고도, 코딩 어시스턴트가 라이브 CMS 버킷(Bucket)을 사용하여 즉시 작동하게 하려면 어떻게 해야 할까를 고민했습니다.

우리가 도달한 답은 단순한 UX 개선 그 이상이었습니다. 그것은 새로운 고객 획득 채널(Acquisition Channel)이었습니다. 그리고 아직 거의 아무도 이를 위해 구축하고 있지 않습니다.

변화: AI 어시스턴트가 새로운 탐색 계층(Discovery Layer)이 되다

지난 10년 동안 배포란 SEO, 앱 스토어, 그리고 입소문을 의미했습니다. 잠재적 사용자는 자신의 문제를 Google에서 검색하고, 귀하의 사이트에 접속하여 문서를 읽은 뒤, 가입 여부를 결정했습니다. 항상 인간이 시작하는 주체였습니다.

그 모델이 무너지고 있습니다.

개발자가 Cursor나 Claude Code를 열고 "헤드리스 CMS(Headless CMS)를 사용한 블로그를 만들어줘"라고 말하면, AI 어시스턴트가 추천을 합니다. 도구를 선택합니다. 통합 코드(Integration Code)를 작성합니다. 그리고 점점 더, 사용자를 대신하여 인프라를 프로비저닝(Provisioning)하려고 시도합니다.

만약 귀하의 제품이 AI 에이전트에 의해 호출(Callable)될 수 없다면, 귀하는 그 고려 대상에 포함되지 않습니다. SEO가 얼마나 훌륭한지는 중요하지 않습니다. 에이전트는 귀하의 가격 페이지를 절대 보지 않기 때문입니다.

이것이 변화의 핵심입니다. 탐색 계층(Discovery Layer)이 검색 엔진에서 AI 어시스턴트로 이동하고 있으며, 귀하의 제품이 이러한 어시스턴트들에게 노출하는 API 표면(API Surface)이 배포 자산(Distribution Asset)이 되고 있습니다.

"에이전트 호출 가능(Agent-Callable)"의 실제 의미

단일한 표준은 없습니다. 하지만 우리가 구축하고 관찰한 바에 따르면, 에이전트 호출 가능한 제품은 네 가지 계층을 가집니다:

1. 잘 문서화된 에이전트 전용 엔드포인트(Endpoint)를 갖춘 깔끔한 REST API

AI 코딩 어시스턴트는 REST API를 호출하는 방법을 알고 있습니다. 그들은 귀하의 문서를 읽고, 적절한 엔드포인트를 찾아 호출할 것입니다. 만약 인간의 개입 없이 에이전트가 귀하의 제품을 프로비저닝하거나 상호작용할 수 있는 명확한 시작점이 없다면, 귀하에게는 공백이 존재하는 것입니다.

핵심적인 설계 질문은 이것입니다: 에이전트가 사용자를 대신하여 귀하의 제품을 시작하기 위해 호출해야 하는 단 하나의 호출(call)은 무엇인가?

2. MCP 서버

Model Context Protocol (MCP)는 Claude와 같은 AI 어시스턴트가 외부 도구에 접근하는 표준 방식이 되어가고 있습니다. MCP 서버는 귀하의 제품 기능을 어시스턴트의 컨텍스트 윈도우(context window) 내에서 호출 가능한 도구(tools)로 노출합니다.

의미 있는 API를 보유하고 있다면, 이를 MCP 서버로 래핑(wrap)할 수 있습니다. 저희는 cosmicjs.com/docs/mcp-server에서 저희의 서버를 배포하고 있으며, 셀프 호스팅(self-hosted) 버전도 제공합니다. 사용자들은 MCP 호환 어시스턴트를 해당 서버로 지정하기만 하면, 대화를 떠나지 않고도 콘텐츠 관리 도구에 대한 완전한 접근 권한을 얻을 수 있습니다.

3. llms.txt 및 llms-full.txt

이것은 노력은 적게 들면서 영향력은 매우 큰(low-effort, high-leverage) 전략이지만, 대부분의 팀이 아직 실행하지 않은 방식입니다. llms.txt는 AI 어시스턴트에게 귀하의 문서에 대한 구조화되고 마크다운(markdown) 친화적인 인덱스를 제공하는 일반 텍스트 파일입니다. LLM이 귀하의 제품을 이해하려고 시도할 때 이 파일을 가져오게 됩니다.

저희는 cosmicjs.com/docs/llms.txt에 이 파일을 배치했습니다. 해당 파일의 첫 번째 줄은 에이전트를 향한 직접적인 지침입니다: 여기서 시작하세요, 그리고 여기 단 한 번의 curl 호출로 가능한 가입(signup) 흐름이 있습니다. 이는 의도된 것입니다. 귀하는 인간이 아닌 독자를 위한 문서를 작성하고 있는 것이며, 그에 맞게 취급해야 합니다.

4. AI 크롤러를 위한 robots.txt 허용 목록

만약 robots.txt에서 GPTBot, ClaudeBot, PerplexityBot 및 이와 유사한 크롤러들을 명시적으로 허용하지 않고 있다면, 귀하를 추천해 줄 수도 있는 도구들을 차단하고 있는 것일 수 있습니다. 설정을 확인해 보세요. 대부분의 팀은 의도했던 것보다 더 광범위한 규칙을 적용하고 있습니다.

이 중 어느 것도 생소한 것이 아닙니다. 에이전트 기반 웹(agentic web)의 일부가 되고 싶다면 이 모든 것들은 기본 요건(table stakes)입니다.

우리가 구축한 것: 에이전트 가입 (Agent Signup)

우리가 해결하고자 했던 구체적인 문제는 다음과 같습니다: 사용자를 대신하여 Cosmic을 사용하려는 코딩 어시스턴트가 작업 흐름을 중단하고, 사용자에게 계정을 생성하라고 말한 뒤, 대시보드에서 세 개의 API 키를 복사하여 다시 대화창에 붙여넣도록 요청해야 했습니다. 많은 사용자가 이 과정을 끝까지 마치지 못했습니다.

그래서 우리는 Agent Signup을 구축했습니다. 이는 사용자가 계정을 생성하기도 전에, AI 에이전트가 사용자를 대신하여 Cosmic 프로젝트를 프로비저닝(Provisioning)할 수 있게 해주는 단일 API 엔드포인트입니다.

워크플로우는 다음과 같습니다:

에이전트가 사용자의 이메일과 함께 엔드포인트를 호출합니다.
Cosmic이 프로젝트와 버킷(Bucket)을 생성하고, 에이전트가 즉시 사용할 수 있는 API 키를 반환합니다.
사용자는 6자리 OTP(One-Time Password)가 포함된 이메일을 받습니다.
사용자가 이를 에이전트에게 다시 붙여넣거나(또는 소유권 주장 링크를 클릭합니다).
버킷이 완전한 프리 티어(Free-tier) 액세스로 업그레이드됩니다.
에이전트는 계속해서 구축을 진행합니다. 사용자는 대화창을 떠날 필요가 없습니다.

소유권이 주장되지 않은 프로젝트는 시스템을 깨끗하게 유지하기 위해 14일 후에 자동으로 삭제됩니다.

또한 우리는 호스팅된 MCP 서버에서 동일한 워크플로우를 MCP 도구(Tools)로 공개하여, 어떤 MCP 호환 어시스턴트라도 별도의 설치 없이 이를 트리거할 수 있도록 했습니다.

고려 대상 집합(Consideration Set) 문제

인프라를 구축하는 것은 필요하지만 충분하지는 않습니다. 여러분은 또한 고려 대상 집합(Consideration set)에 포함되어야 합니다.

사용자가 AI 어시스턴트에게 "내 Next.js 앱을 위한 헤드리스 CMS(Headless CMS)가 필요해"라고 말하면, 어시스턴트는 모델이 학습한 내용, 즉 문서, 블로그 포스트, GitHub 리포지토리, 포럼 토론, Stack Overflow 답변을 기반으로 추천을 내립니다. 이는 실시간 검색이 아닙니다. 축적된 패턴 매칭(Pattern matching)입니다.

이는 여러분이 지난 몇 년 동안 게시한 콘텐츠가 생각보다 더 중요하다는 것을 의미합니다. 전통적인 콘텐츠 마케팅은 의도치 않게 에이전트 최적화(Agent optimization)가 됩니다.

하지만 에이전트 맥락(Agentic context)을 위해 구체적으로 할 수 있는 일들이 있습니다:

인간뿐만 아니라 에이전트를 위한 문서를 작성하세요. llms.txt를 사용하여 에이전트가 올바른 정보에 빠르게 접근할 수 있는 경로를 제공하세요.
첫 번째 API 호출을 명확하게 만드세요. "시작하기(Getting started)" 과정이 단순할수록 에이전트가 성공적으로 완료할 가능성이 높아집니다.
학습 데이터(Training data)에 포함되세요. 게시된 튜토리얼, GitHub 리포지토리, 실제 사용 패턴 등이 해당됩니다.
MCP 서버를 출시하세요. MCP는 아직 초기 단계이지만, 채택 속도가 가속화되고 있습니다.

우리가 여전히 알지 못하는 것

우리의 새로운 가입자 중 몇 퍼센트가 전통적인 검색이 아닌 에이전트 주도 플로우 (agent-initiated flows)를 통해 유입되는지는 알 수 없습니다. 우리의 기여도 모델 (attribution model)은 이를 위해 설계되지 않았습니다.

어떤 AI 어시스턴트 (AI assistants)가 Cosmic을 추천할 가능성이 가장 높은지, 또는 우리의 llms.txt 품질이 원시 학습 데이터 (raw training data)의 양에 비해 추천에 실제로 얼마나 영향을 미치는지도 알 수 없습니다.

MCP가 여러 경쟁 프로토콜 중 하나가 될지, 아니면 보편적인 표준 (universal standard)이 될지 얼마나 빨리 진행될지도 알 수 없습니다.

현재 인프라에 투자할 의지가 있는 팀들에게는 진정한 선점 기회 (first-mover window)가 열려 있습니다. 만약 이 분야에서 무언가를 구축하고 계신다면, 진심으로 서로의 경험을 공유하고 싶습니다.

에이전트 호출 가능 인프라 (agent-callable infrastructure)가 실제로 어떻게 작동하는지 보고 싶다면, Cosmic Agent Skills docs에서 전체 가입 플로우를 확인할 수 있습니다. MCP server는 현재 라이브 상태이며 바로 사용 가능합니다.