Подключение ИИ-ассистента (MCP)

ИИ-ассистент, который поддерживает Model Context Protocol (MCP), может читать ваши данные TapBaton и отвечать на вопросы вроде «Какой Smart Link лучше всего конвертировал на прошлой неделе?» или «Почему этот клик попал в поток для Android?». Он работает с API-ключом, который вы создаёте для одного проекта. Ассистент может только читать; он не может редактировать Smart Link, публиковать его или менять настройки.

Что может читать ассистент

• Ваши Smart Link и то, как каждый из них маршрутизирует трафик: потоки, условия, доли разделения и куда каждый вариант отправляет людей.
• Отчёты: клики, конверсии, доход и показатели за период, сгруппированные так же, как в разделе «Аналитика».
• Недавние конверсии, отфильтрованные по типу, Smart Link или периоду.
• Почему конкретный клик пошёл туда, куда пошёл, — шаг за шагом.
• Сколько посетителей покинули встроенный браузер, в разбивке по приложению и операционной системе.
• Открытые уведомления и офферы.

Числа совпадают с тем, что вы видите в консоли. Места назначения показываются без приватных значений: ссылка вида https://network.example/click?aff_id=123 отображается как https://network.example/click?aff_id=[REDACTED].

Создайте ключ для своего ассистента

1. Откройте «Настройки → API-ключи» и выберите «Новый API-ключ». Сделать это может только владелец или администратор.
2. Назовите ключ по имени ассистента, выберите проект, который он может читать, и отметьте «Разрешить ИИ-ассистентам пользоваться этим ключом».
3. Скопируйте ключ из окна подтверждения. Он показывается только один раз.

Переключатель «ИИ-ассистенты» для существующего ключа можно включать и выключать в том же списке. Отзыв ключа останавливает ассистента при следующем же запросе.

Ключ видит ровно то, что видит в этом проекте человек, который его создал. Если этот человек теряет доступ к проекту, ключ тоже перестаёт работать.

Подключите TapBaton к своему ассистенту

Раздел «Подключение ИИ-ассистента» на той же странице показывает адрес вашего эндпоинта MCP и готовые настройки с кнопками копирования. В каждой настройке замените YOUR_TAPBATON_API_KEY на свой ключ.

• Claude Code: один раз выполните команду claude mcp add из вкладки Claude в терминале.
• Cursor: добавьте JSON из вкладки Cursor в .cursor/mcp.json вашего проекта и храните ключ в переменной окружения.
• OpenAI API: добавьте инструмент MCP из вкладки ChatGPT в свой запрос, указав ключ в поле authorization.

Приложения Claude и ChatGPT подключаются к внешним инструментам только через процедуру входа, которую TapBaton пока не поддерживает. Пока используйте один из вариантов выше.

Храните ключ в безопасности

Относитесь к ключу как к паролю. Храните его в настройках своего ассистента или в переменной окружения — никогда в общем документе или чате. Срок действия каждого ключа ограничен: выпустите новый до его окончания и отзовите старый.

Если ассистент сообщает, что ключу не разрешено использовать MCP, владельцу или администратору нужно включить для этого ключа переключатель «ИИ-ассистенты». Если он сообщает, что запросов слишком много, подождите минуту: каждый ключ может делать около двух запросов в секунду.