Подключение и обмен данными
Обновлено
Два уровня подключения
MCP-клиент обращается к серверу приложения MCP с токеном этого приложения. Плагин выполняет доступные токену инструменты и отправляет запросы в Топвизор с реквизитами из своих настроек.
MCP-клиент → приложение MCP → Топвизор для MCP → API ТопвизораНастройте аккаунт по статье «Установка и первые шаги». Для доступа к Топвизору используются общие настройки плагина: отдельного API-ключа для каждого токена MCP здесь нет. Разные токены можно ограничить набором разрешённых инструментов.
Что уходит в Топвизор
Плагин отправляет POST-запросы по HTTPS на https://api.topvisor.com/v2/json/. В заголовках передаются User-Id и Authorization: bearer <API-ключ>, в JSON-теле — параметры выбранного метода.
Состав данных зависит от действия:
| Действие | Передаваемые данные |
|---|---|
| Чтение позиций и снимков | Идентификатор проекта, регион внутри проекта, даты, выбранные группы и другие поддерживаемые фильтры |
| Добавление и изменение проекта | Адрес сайта, имя и выбранные параметры съёма |
| Работа с семантикой | Тексты запросов, имена групп, идентификаторы объектов и целевые страницы |
| Работа с аудитом | Адреса страниц или карты сайта, флаги участия в проверках, настройки индексации и Радара |
| Получение цены и запуск | Проект и параметры выбранной проверки |
| Настройка расписания | Вид проверки, дни, время и поддерживаемые дополнительные параметры |
Исходный текст разговора плагин не пересылает: он обрабатывает аргументы инструмента. Тексты запросов, адреса и другие данные, которые агент передал в этих аргументах, могут входить в запрос API.
При импорте страниц по sitemap_url адрес карты передаётся Топвизору. Дальнейшая обработка карты выполняется внешним сервисом. Для добавления допустимы адреса сайта проекта и его поддоменов.
Что получает агент
Клиент получает результат инструмента: например, список запросов, позиции, адреса страниц, данные изменений Радара или операции по счёту. Учитывайте это при выборе MCP-клиента и выдаче прав токена.
API-ключ хранится в настройках приложения. Клиент API маскирует известный ключ и bearer-токены в текстах ошибок и журнале. Это не шифрование хранилища настроек: доступ к бэкенду и серверу следует ограничивать обычными средствами Вебасиста и хостинга.
Журнал и сетевые ошибки
Диагностика записывается в wa-log/topvisor.log: метод, HTTP-код, длительность запроса, пользователь, результаты изменений и платных запусков. Клиент не записывает туда тела запросов и заголовки авторизации.
Для работы серверу нужен исходящий HTTPS к api.topvisor.com. При network_error проверьте доступ с сервера; при auth_failed — сохранённые реквизиты; при rate_limited повторите чтение через несколько секунд.
Читающие запросы могут автоматически повторяться после временных ошибок. Запись и платный запуск автоматически не повторяются: если результат неизвестен, сначала проверьте состояние объекта или проверки и журнал списаний.
Расписание и фоновые задачи
Плагин не требует собственного cron и не регистрирует CLI-команды или webhooks. Настроенное через него расписание хранится и исполняется в Топвизоре. Управление автозапуском описано в статье «Проверки и расписание».