Перейти до вмісту

ШІ-АСИСТЕНТ І MCP

ШІ-асистент для ваших QR-кодів і відгуків клієнтів

Шляхів два. Асистент, вбудований у простір Mosaqo, відповідає на запитання про ваші коди, сканування й опитування та готує зміни у вигляді карток, які ви натискаєте. MCP-сервер дає Claude, ChatGPT чи будь-якому іншому MCP-клієнту працювати з тим самим простором через ключ або вхід, який ви підтверджуєте. В обох випадках він може рівно те, що дозволяє його доступ, і цей доступ можна забрати одним кроком.

ШВИДКИЙ ОГЛЯД

Що це дає на практиці

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.

FAQ

Часті запитання

Які асистенти можуть підключитися до Mosaqo?

Будь-який клієнт, що підтримує Model Context Protocol, зокрема Claude і ChatGPT. Вкажіть йому адресу https://api.mosaqo.app/v1/mcp і авторизуйте його API-ключем або через вхід.

Чи може асистент прочитати, що написали мої клієнти?

Не через MCP чи API. Звіт опитування там містить оцінки, кількості й те, скільки людей щось написали, а сам текст вилучається, перш ніж звіт вийде назовні. Вбудований асистент може читати найсвіжіші письмові коментарі — для тих самих ролей, які можуть відкрити розділ «Вхідні», — тож підсумує їх, коли ви попросите.

Як відкликати доступ, який отримав асистент?

Відкличте його API-ключ або натисніть «Відключити» поруч із ним у розділі «Підключені асистенти»; він негайно втрачає доступ до простору. Вбудований асистент кожен може вимкнути для себе в розділі «Уподобання».

Чи доведеться доплачувати за асистента?

Ні. Вбудований асистент і MCP-сервер входять у безкоштовний тариф, як і всі інші функції.

НАСТУПНИЙ КРОК

ГОТОВІ ЗАПИТАТИ?

Питайте про свої коди в просторі або підключіть асистента, яким уже користуєтеся

Вбудований асистент є на кожному екрані простору. Для Claude, ChatGPT чи іншого MCP-клієнта почніть із ключа лише для читання й додавайте більше, коли знадобиться.

Відкрити простір і запитати