ИИ-АССИСТЕНТ И 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-сервер входят в бесплатный тариф, как и все остальные функции.
СЛЕДУЮЩИЙ ШАГ