Инструкция

MCP / API для вендоров

Ведение карточек через ИИ-помощника или свой скрипт: токен, подключение, что можно и что нельзя.

Карточки продуктов, кейсы и новости можно вести не только руками в кабинете, но и через ИИ-помощника или собственный скрипт. Для этого у площадки есть MCP-сервер и вендорский REST API: один и тот же набор операций, два способа подключения.

Что это даёт

  • Карточка не отстаёт от релиза. Помощник берёт данные из вашего релиза и правит версию, требования, описание в тот же день.
  • Обзор по всем карточкам. Какие заполнены наполовину, где нет ссылки на документацию, где короткое описание — одним вопросом помощнику.
  • Данные не копируются руками. Помощник читает ваш сайт, документацию, PIM и переносит в карточку.

Всё, что помощник создаёт — карточку, кейс, новость, — черновик. Публикация — отдельным действием, с вашего подтверждения и в пределах лимитов тарифа. Удалить карточку, сменить тариф или загрузить изображения через помощника нельзя: таких инструментов нет.

Кому доступно

С тарифа «Старт». Уровень определяет, что именно можно: на «Старте» — чтение карточек и черновики, на «Профессиональном» — публикация, кейсы и новости, на «Бизнесе» — пакетная правка и статистика. Сравнение уровней и квот — на странице ИИ-управление карточками.

Как подключить

  1. Выпустите токен. Кабинет → Профиль → Интеграции → «Выпустить токен». Задайте название, срок и набор разрешений; для первого знакомства оставьте только чтение. Значение токена показывается один раз — скопируйте его сразу.
  2. Пропишите сервер в ИИ-клиенте. Адрес https://platforms.su/mcp, заголовок Authorization: Bearer <токен>.
    • Claude Code: claude mcp add --transport http platforms-su https://platforms.su/mcp --header "Authorization: Bearer <токен>"
    • Claude (веб, Desktop): Настройки → Коннекторы → «Добавить свой коннектор», адрес и заголовок те же.
    • Cursor и клиенты с файлом mcp.json: блок с url и headers — пример в документации.
  3. Спросите помощника, что у вас размещено. Он вызовет инструменты сам — отдельных команд учить не нужно.
  4. Проверьте и опубликуйте. Каждый вызов виден в журнале на странице «Интеграции»: что вызвали, над чем, чем кончилось. Токен отзывается в один клик.

REST API для скриптов

Те же операции без ИИ-помощника: база https://platforms.su/api/v1/vendor, авторизация тем же токеном. Список карточек, карточка целиком, проверка заполненности, черновик, правка, публикация, кейсы, новости, статистика. Примеры с curl, коды ошибок и лимиты — в документации для разработчиков.

Если что-то не работает

Начните со страницы Интеграции: там видно состояние токена, остаток квоты и последние вызовы с кодом ошибки. Если токен ограничен списком IP — учтите, что облачный клиент ходит не с адреса вашего компьютера (для Claude это подсеть 160.79.104.0/21).

Подробнее об ИИ-управлении карточками → · Документация: инструменты, REST API, лимиты →