QR 코드와 고객 피드백을 위한 AI 어시스턴트

01

물어볼 수 있는 것

사람들이 QR 코드에 대해 실제로 궁금해하는 것은 비교와 목록입니다. 이번 달 가장 많이 스캔된 코드는 무엇인지, 인쇄 이후 아무도 스캔하지 않은 코드는 무엇인지, 이번 주가 지난주와 비교해 어떤지, 캠페인의 어느 배치가 실제로 성과를 내고 있는지. 어시스턴트는 직접 읽어야 하는 대시보드 대신 한 문장으로 답하고, 확인할 수 있도록 코드 이름을 짚어 줍니다.

피드백도 마찬가지입니다. 설문 추세가 어떤지, 어느 문항 점수가 가장 낮은지, 메뉴가 바뀐 뒤 몇 명이 답했는지. MCP를 통해 어시스턴트가 받는 것은 숫자 — 건수, 선택지, 문항별 분포, 코멘트를 쓴 사람 수 — 이며, 코멘트 본문은 결코 받지 않습니다. 내장 어시스턴트는 최근 작성된 코멘트를 읽을 수 있지만, 응답 받은편지함이 그 코멘트를 보여 주는 사람에게만 그렇게 합니다. 그래서 코멘트가 무엇에 관한 것인지 한 문장으로 알려 줄 수 있습니다.

• 가장 많이 스캔된 코드와 아무도 스캔하지 않는 코드를 이름으로
• 이번 기간과 지난 기간 비교, 코드 하나든 워크스페이스 전체든
• 설문 점수, 그리고 평균 뒤에 있는 분포
• 스캔 세부 정보는 워크스페이스 자체의 개인정보 설정 범위 안에서

02

무엇을 바꿀 수 있고, 누가 승인하는가

워크스페이스에서 어시스턴트는 결코 스스로 움직이지 않습니다. 제안만 합니다. 새 코드, 당신의 설명으로 작성한 카드 템플릿, 설문 문항, 동적 코드의 새 목적지, 게시나 보관. 각각은 무슨 일이 일어날지 적힌 카드로 도착하고, 누군가 누르기 전에는 아무것도 바뀌지 않습니다. 그것도 누른 사람 자신의 역할로 실행되므로, 열람자는 제안을 읽을 수는 있어도 실행할 수는 없습니다.

MCP를 통해서는 어시스턴트가 키나 로그인이 허용하는 도구를 호출합니다. 쓰기를 하는 도구는 모두 그렇게 표시되어 있고, 보관은 파괴적인 작업으로 표시되어 있어서, 이 표시를 따르는 클라이언트는 실행하기 전에 당신에게 묻습니다. 코드를 삭제하는 도구는 없습니다. 할 수 있는 것은 보관까지이며, 보관한 코드는 복원할 수 있습니다.

• 내장: URL, Wi-Fi, 텍스트, vCard, 앱 링크 코드 만들기, 카드 템플릿과 설문 초안 작성
• 내장과 MCP 모두: 동적 코드의 목적지 바꾸기, 게시, 보관
• MCP만: URL 코드를 초안으로 만들기, 따로 지정하지 않으면 시험 실행으로 끝나는 CSV 가져오기 시작
• 둘 다 불가: 코드 삭제, 사람 초대, 접근 권한을 가진 사람 변경

03

외부 어시스턴트를 연결하는 두 가지 방법

MCP 서버의 주소는 하나입니다: https://api.mosaqo.app/v1/mcp. 가장 간단한 방법은 API 키입니다. 소유자나 관리자가 “일괄 처리 및 API”에서 키를 만들고, 허용할 작업을 체크한 뒤 클라이언트에 붙여 넣습니다. 키에는 만료일과 IP 허용 목록을 둘 수 있고, 폐기하면 즉시 멈춥니다.

다른 방법은 로그인입니다. 클라이언트가 스스로를 등록하고 Mosaqo 페이지를 열면, 소유자나 관리자가 그 페이지에서 워크스페이스 하나에 대해 승인합니다. 그러면 “연결된 어시스턴트”에 나타나고, “연결 해제”를 누르면 즉시 끝납니다. 어느 쪽이든 자격 증명 하나는 워크스페이스 하나에만 닿습니다.

• qr:read와 qr:write는 코드용, exports:read는 코드 이미지용
• analytics:read는 스캔용, reviews:read는 장소와 설문 보고서용
• bulk:write와 webhooks:write는 필요할 때만
• 허용한 권한 밖의 도구는 어시스턴트에게 아예 제공되지 않습니다

04

필요하다고 생각하는 것보다 적은 권한으로 시작하세요

사람들이 어시스턴트에게 바라는 것은 대부분 읽기 전용 키로 충분합니다. 보고서, 비교, 손봐야 할 코드 목록 같은 것들입니다. qr:read와 analytics:read를 주고 일주일 써 본 뒤, 대화로 정말 하고 싶은 변경이 생기면 그때 qr:write를 추가하세요.

도구마다, 사람마다 키를 따로 두세요. 그러면 유출된 키나 끝난 실험에 쓴 키를 다른 것은 건드리지 않고 폐기할 수 있습니다.

05

의지하기 전에 알아 둘 제한

내장 어시스턴트는 워크스페이스당 한 시간에 최대 60개, 하루 300개의 질문에 답하며, 워크스페이스와 관련된 주제에만 머뭅니다. 관련 없는 질문은 정중하게 거절합니다. 각자 “환경설정”에서 자신의 워크스페이스에 어시스턴트를 표시하지 않게 할 수 있습니다.

MCP를 통해서는 키나 로그인마다 분당 600개의 요청을 보낼 수 있습니다. 이는 요금제 한도가 아니라 폭주하는 루프를 막기 위한 안전장치입니다. 스캔 분석은 동적 코드만 다룹니다. 정적 코드는 한번 인쇄되면 Mosaqo를 거치지 않기 때문입니다.