Доступ и аккаунты
Обновлено
Права токена MCP
Плагин регистрирует раздел «Разработчик Webasyst» с четырьмя группами прав. Ниже приведены русские подписи из кода плагина.
| Группа | Права |
|---|---|
| Чтение | Аккаунты разработчика; Баланс счёта; Начислено за месяц; Сводка по продажам; Продукты в маркете; Типы продуктов; Промокоды; Проверка лицензий; Реселлеры |
| Синхронизация | Подтянуть транзакции |
| Реестр лицензий | Собрать реестр лицензий; Список лицензий по доменам |
| Промокоды | Создать промокод; Удалить промокод |
У каждого инструмента отдельное право с тем же техническим именем. Например, devapi_get_products соответствует праву «Продукты в маркете».
Право «Промокоды» из группы «Чтение» позволяет просматривать коды. Права из группы «Промокоды» позволяют создавать и удалять их. Параметр confirm=true не заменяет право токена.
Для реестра отдельно выдайте права группы «Реестр лицензий»: его ответы содержат домены покупателей.
Выбор аккаунта
| Параметр вызова | Что делает | Значения / по умолчанию |
|---|---|---|
account_id |
Выбирает аккаунт приложения «Разработчик Webasyst» | Целое число из devapi_list_accounts. Необязателен при единственном аккаунте |
Это параметр MCP-запроса, а не настройка плагина. Его поддерживают все инструменты, кроме devapi_list_accounts.
Если аккаунтов несколько и параметр не указан, возвращается account_required со списком вариантов. Неизвестный идентификатор даёт account_not_found, отсутствие аккаунтов — no_accounts.
Плагин не регистрирует отдельного права на конкретный аккаунт и не фильтрует список аккаунтов по владельцу в своей выборке. account_id выбирает данные для вызова и сам по себе не ограничивает доступ.
Данные для агента
devapi_list_accounts возвращает id, contact_id, name, is_remote, remote_url, new_transactions, last_update. Время last_update передаётся строкой даты и времени либо null. Ключ devAPI в эту выборку не включён.
Другие инструменты возвращают финансовые показатели, продукты, промокоды или сведения о лицензиях — в зависимости от запроса. Внешние запросы выполняются через приложение «Разработчик Webasyst» с его сохранёнными учётными данными.
Плагин не задаёт отдельный адрес MCP-сервера и не выпускает собственный API-ключ. Подключение клиента и выпуск MCP-токена выполняются средствами приложения MCP.