Установка и первые шаги

Установка

1. Подготовьте приложение MCP и приложение «Разработчик Webasyst» в своей установке Webasyst.
2. В приложении «Разработчик Webasyst» добавьте аккаунт с ключом devAPI. Плагин использует уже сохранённый аккаунт.
3. Установите плагин «Разработчик Webasyst» через приложение «Инсталлер». Ссылка установки есть на странице плагина в маркете.
4. В приложении MCP выдайте токену нужные права из раздела «Разработчик Webasyst». Подключите MCP-клиент по инструкции приложения MCP.

Где находятся настройки

У плагина нет собственной формы настроек и полей для ключа. Аккаунты и ключи относятся к приложению «Разработчик Webasyst», а права доступа — к токену в приложении MCP. Повторно передавать ключ devAPI агенту не требуется.

Для первой проверки выдайте право «Аккаунты разработчика» из группы «Чтение». Остальные права подбирайте по задачам — см. «Доступ и аккаунты».

Проверка

Попросите агента:

Покажи аккаунты разработчика через devapi_list_accounts.
Назови их идентификаторы и время последней синхронизации.

Успешный вызов возвращает ok: true, массив accounts и count. Ключи devAPI в список не входят. Пустой массив означает, что аккаунты ещё не добавлены.

Затем выдайте право «Продукты в маркете» и попросите:

Покажи мои продукты через devapi_get_products без кеша.
Если аккаунтов несколько, уточни, какой использовать.

Этот запрос проверяет получение данных через приложение «Разработчик Webasyst». Успешный список аккаунтов сам по себе ещё не подтверждает работоспособность ключа devAPI.

Если аккаунт один, он выбирается автоматически. При нескольких передавайте account_id из списка аккаунтов.

Перед первым отчётом

Для актуального отчёта выдайте права «Подтянуть транзакции» и «Сводка по продажам». Попросите агента сначала вызвать devapi_sync_transactions, затем devapi_get_summary. Подробности — в статье «Продажи и синхронизация».