Подключение ИИ-ассистента
NexusTag умеет отвечать ИИ-ассистенту напрямую. Вы подключаете сервис к своему помощнику один раз — и дальше спрашиваете статистику обычными словами, вместо того чтобы открывать дашборд и сводить цифры вручную.
Работает это по протоколу MCP — общему стандарту, по которому ассистенты подключаются к внешним сервисам. Ставить отдельную программу не нужно: достаточно адреса и ключа.
Что можно спрашивать
- «Как отработали источники за последние 7 дней?»
- «По каким меткам подписчик обошёлся дороже всего?»
- «Сколько трафика срезали фильтры за неделю и за что именно?»
- «Почему моя ссылка не пускает мобильных из Казахстана?»
- «Сравни две метки по конверсии перехода в подписку.»
Последний вопрос ассистент разбирает симулятором трафика: прогоняет вымышленного посетителя через ваши фильтры и объясняет, какой шаг его отсекает.
Подключение
Шаг 1. Выдайте ключ в боте: «🧰 Инструменты» → «🔌 API и ИИ-доступ» → «Выдать ключ». Подробнее — API и ключи доступа.
Шаг 2. В ассистенте добавьте удалённый MCP-сервер:
Адрес: https://nexus-tag.ru/mcp
Ключ: Authorization: Bearer nxt_ваш_ключШаг 3. Спросите что-нибудь простое — например «покажи мои источники». Ассистент сам вызовет нужный инструмент.
Начните разговор с «покажи источники»: почти всем остальным инструментам нужен номер источника, и ассистент сначала узнаёт его сам.
Что ассистент видит и чего не может
Ровно то, что позволяет ключ, — и ни байтом больше:
- С ключом на чтение инструменты изменения ему не показываются вовсе. Это важнее, чем «он не станет их применять»: ассистент не может строить планы вокруг действия, которого у него нет.
- Чужие данные недоступны в принципе. Владелец определяется ключом, попросить данные другого клиента нечем — такой запрос невозможно составить.
- Деньги ассистент не тратит: ни оплатить тариф, ни запустить рекламу через API нельзя.
- Фильтры и источники он менять не может — только смотреть и прогонять симулятор. Единственное изменение, доступное по ключу с записью, — создание метки-ссылки.
Если подписка неактивна, ассистент не увидит даже списка инструментов — отказ приходит до подключения. Это не поломка: оплатите тариф, и связь восстановится тем же ключом.
Что стоит понимать про ответы
Ассистент получает от нас цифры, но выводы делает сам — и может ошибиться в трактовке, как ошибся бы человек. Считайте его быстрым способом достать и сопоставить данные, а не источником истины: спорные числа проверяйте в дашборде.
Цифры при этом те же самые, что в отчётах бота: переход — это start и to_tg, подписка — subscribe, период — полные сутки, заканчивающиеся вчера. Если бы API считал по-своему, вы сверяли бы два числа и не верили ни одному.
Если что-то не работает
| Симптом | Что проверить |
|---|---|
| «нужен ключ» | ключ не подставился — проверьте заголовок в настройках ассистента |
| «ключ не найден или отозван» | ключ отозван или скопирован не полностью |
| «подписка неактивна» | истёк тариф — продлите в боте, ключ менять не нужно |
| «слишком много вызовов» | ассистент ушёл в цикл; подождите минуту и переформулируйте вопрос |
| инструментов не видно | ключ на чтение — так и задумано; для создания меток нужен ключ с записью |
Не любой ассистент умеет удалённые MCP-серверы. Если ваш не умеет — те же данные доступны обычными HTTP-запросами, см. API и ключи доступа.