Usertour, MCP 에이전트 설계 교훈

Usertour는 오픈소스 사용자 온보딩 도구로, 최근 MCP(Model Context Protocol) 서버를 출시했다. 이를 통해 Claude가 실제 앱에 SDK를 설치하고 디자인 시스템에 맞춘 제품 투어, 체크리스트, 설문조사 등을 직접 구축할 수 있게 되었다.

에이전트를 위한 설계 과정에서 얻은 주요 기술적 통찰은 다음과 같다:

• 엄격한 API와 검증: 에이전트는 실시간 미리보기를 볼 수 없으므로, API는 잘못된 설정을 엄격히 거부해야 한다. 렌더링이 불가능한 설정을 즉시 차단하는 기계 판독 가능한 에러와 dry-run 검증 도구가 필수적이다.
• 진단 도구의 중요성: 에이전트에게는 직접적인 작성 도구보다, 특정 조건이 왜 일치하지 않는지 알려주는 diagnose_content와 같은 진단 도구가 훨씬 더 유용하다.
• 보안 및 권한: 설문 응답 등은 신뢰할 수 없는 텍스트로 취급되어야 하며, 프롬프트 인젝션에 대비한 권한 모델 설계가 필요하다.

해당 기능은 Claude.ai, Cursor, Codex 등과 호환되는 OAuth 기반 엔드포인트를 제공한다.