에이전트 안내
사람과 AI 에이전트를 위한 사용 안내
사보나라는 사람이 쓰는 공개 기능을 AI 에이전트도 같은 규칙으로 사용할 수 있도록 도구를 제공합니다.
AI 에이전트가 사보나라의 비용 계산·견적·문의 기능을 대신 사용할 수 있나요?
사보나라는 브라우저 WebMCP 도구와 서버 MCP 엔드포인트(/api/mcp)로 비용 추정, 포트폴리오·공지 조회, 견적·문의 작성을 제공합니다. 견적 요청과 문의 접수는 반드시 사용자가 내용을 확인하고 동의한 뒤에만 완료됩니다.
제공 도구 7종
브라우저 내장 에이전트는 WebMCP 로, 외부 MCP 클라이언트는 /api/mcp 로 같은 도구를 사용합니다. navigate_to 는 브라우저에서만 제공합니다.
| 이름 | 용도 | 구분 | 입력 |
|---|---|---|---|
| estimate_cost | 비용 추정 — 사보 인쇄 대비 전자책 연간 비용과 절감률을 단가표 기준으로 계산합니다. 조회 전용이며 데이터를 저장하지 않습니다. | 읽기 | 발행물 종류, 방식, 쪽수, 부수, 발행 주기, 옵션 |
| request_quote | 견적 요청 — 사보 제작 견적 요청서를 작성합니다. 입력란만 채우며, 제출은 사용자가 내용을 확인한 뒤 직접 '견적 요청 보내기'를 누릅니다. 개인정보 동의는 사용자가 직접 체크합니다. | 쓰기(사용자 확인 필수) | 비용 추정 입력 + 이름, 회사명, 이메일, 연락처(선택) |
| submit_inquiry | 문의 접수 — 사보나라에 문의를 작성합니다. 입력란만 채우며, 제출은 사용자가 내용을 확인한 뒤 직접 '문의 보내기'를 누릅니다. 개인정보 동의는 사용자가 직접 체크합니다. | 쓰기(사용자 확인 필수) | 문의 유형, 이름, 이메일, 문의 내용(10~2000자), 회사명·연락처(선택) |
| search_portfolio | 포트폴리오 검색 — 사보나라 제작 사례(포트폴리오)를 검색어·업종·태그로 찾습니다. 조회 전용입니다. | 읽기 | 검색어, 업종, 태그, 개수(최대 20) |
| list_notices | 공지 목록 — 사보나라 공지사항 최신 목록(서비스 업데이트·단가 변경·점검)을 조회합니다. 조회 전용입니다. | 읽기 | 개수(최대 20), 다음 페이지 커서 |
| get_service_overview | 서비스 개요 — 사보나라 서비스 방식·제작 과정·기능·가격 산정 방식·문의 방법 요약을 반환합니다. 조회 전용입니다. | 읽기 | 주제(방식·과정·기능·가격 산정·문의) |
| navigate_to | 페이지 이동 — 사보나라 사이트의 다른 페이지로 이동합니다. 작성 중인 폼이 있으면 사용자에게 이동 여부를 묻습니다. | 브라우저 전용 | 이동할 사보나라 페이지 경로 |
견적 상담 5단계
MCP 프롬프트 quote_consultation(견적 상담)을 사용하면 아래 순서로 진행됩니다.
1단계
조건 묻기
발행물 종류, 쪽수, 부수, 발행 주기를 사용자에게 차례로 묻습니다.
2단계
비용 계산
estimate_cost 로 인쇄 대비 전자책 연간 비용과 절감률을 계산해 출처(단가표 버전)와 함께 알려 줍니다.
3단계
견적 요청 준비
사용자가 원하면 request_quote 를 userConfirmed 없이 호출해 미리보기와 confirmToken 을 받습니다.
4단계
사용자 확인
미리보기 내용과 개인정보 수집·이용 동의를 사용자에게 보여 주고 명시적 동의를 받습니다.
5단계
제출
같은 입력에 userConfirmed=true, consent=true, confirmToken 을 더해 다시 호출하면 견적 요청이 접수됩니다.
이용 제한
- 서버 MCP 는 IP 당 분당 60회까지 호출할 수 있습니다. 초과하면 HTTP 429 와 Retry-After 로 안내합니다.
- 견적 요청·문의 접수는 사용자가 내용을 확인하고 동의한 뒤에만 완료됩니다. 확인 토큰은 10분 동안 한 번만 사용할 수 있습니다.
- 브라우저에서는 AI 가 입력란만 채우며, 개인정보 수집·이용 동의 체크와 제출 버튼은 사용자가 직접 누릅니다.
- 제출된 견적·문의는 사람이 보낸 것과 같은 검증과 스팸 방지 규칙을 거칩니다. 사원 로그인·관리자 기능은 에이전트에 제공하지 않습니다.
- 모든 비용 수치는 사보나라 단가표 기준 산식 추정치이며 실제 견적과 다를 수 있습니다.
엔드포인트와 참고 파일
- MCP 엔드포인트 (Streamable HTTP, stateless)
- https://sabonara.com/api/mcp
- 읽기 도구는 인증 없이 사용할 수 있습니다. 리소스: sabonara://pricing/rates, sabonara://llms.txt