Интеграции

Инструменты MCP

Обновлено 25 октября 2026

Справочник

Инструмент	Право в MCP	Назначение
`devapi_list_accounts`	Аккаунты разработчика	Аккаунты без ключей devAPI; время синхронизации
`devapi_get_balance`	Баланс счёта	Баланс счёта разработчика
`devapi_get_month_balance`	Начислено за месяц	Начисления за текущий месяц по локальной базе; ответ содержит `currency: RUB`
`devapi_get_summary`	Сводка по продажам	Показатели за период, сравнение, счётчики лицензий, транзакции и баланс
`devapi_get_products`	Продукты в маркете	Slug, цены и сведения о версиях продуктов
`devapi_get_product_types`	Типы продуктов	Типы продуктов разработчика
`devapi_get_promocodes`	Промокоды	Промокоды с признаком `active`
`devapi_check_license`	Проверка лицензий	Проверка по домену, заказу или идентификатору инсталлера
`devapi_get_resellers`	Реселлеры	Продукты в магазинах реселлеров со ссылками на маркет
`devapi_sync_transactions`	Подтянуть транзакции	Загрузка транзакций в локальную базу приложения
`devapi_sync_licenses`	Собрать реестр лицензий	Обход кассы и заказов для наполнения реестра
`devapi_list_licenses`	Список лицензий по доменам	Реестр с фильтрами, JSON или CSV
`devapi_create_promocode`	Создать промокод	Создание кода при `confirm=true`
`devapi_delete_promocode`	Удалить промокод	Удаление кода при `confirm=true`

Все инструменты, кроме списка аккаунтов, поддерживают выбор аккаунта через account_id.

Параметры чтения

Инструмент / параметр	Что делает	Значения / по умолчанию
`devapi_get_balance`: `with_cache`	Разрешает кеш баланса	`true`; `false` — запросить заново
`devapi_get_products`: `with_cache`	Разрешает кеш списка продуктов	`true`; `false` — запросить заново
`devapi_get_products`: `awaiting`	Оставляет продукты с непустым `awaiting_version` или `awaiting_status`	`false`; для фильтра передать `true`
`devapi_get_promocodes`: `active_only`	Оставляет коды с непустым `active`	`false`; для фильтра передать `true`
`devapi_check_license`: `value`	Домен, заказ или идентификатор инсталлера	Обязательная непустая строка
`devapi_check_license`: `with_cache`	Разрешает кеш проверки лицензии	`true`; `false` — запросить заново

with_cache есть только у трёх перечисленных инструментов. У devapi_get_promocodes, devapi_get_resellers и devapi_get_product_types такого параметра нет.

Проверку value выполняет приложение «Разработчик Webasyst». Справка плагина описывает распознавание так: число — номер заказа, строка с точкой — домен, остальное — идентификатор инсталлера. Домен передавайте в виде example.com.

Slug берите из devapi_get_products. Например, shop/plugins/ewshopwebp — slug; название продукта не заменяет его в фильтре products.

Примеры просьб

Покажи баланс разработчика без кеша.

Покажи продукты с версией на проверке.
Используй devapi_get_products с awaiting=true и with_cache=false.

Проверь лицензии для example.com через devapi_check_license без кеша.

Покажи действующие промокоды и продукты в магазинах реселлеров.

Для отчётов, реестра лицензий и изменения промокодов есть отдельные инструкции.

Справка для агента

Плагин регистрирует материал «Разработчик: сценарии и подводные камни» с идентификатором devapi-basics. Он объясняет источники данных, синхронизацию, slug и подтверждение операций. Получение этой справки клиентом зависит от поддержки соответствующих возможностей приложения MCP и MCP-клиента.