A1 Yandex KIT MCP

A1 Yandex KIT MCP server for the Yandex KIT e-commerce API: products, orders, discounts, webhooks.
Open source Open in the app JSON README (API)
About

A1 Yandex KIT MCP server for the Yandex KIT e-commerce API: products, orders, discounts, webhooks.
Details

Kind: MCP servers
Topic: E-commerce & business
Publisher: gistrec
Origin: official
Category: ferramentas
Transport: local
Version: 1.6.0
Stars: 2
Last push: 2026-09-06T09:12:25Z
Repository state: ativo
Language: JavaScript
License: MIT
Added: 2026-08-29 03:02:51
Updated: 2026-09-05 21:00:45
Origin id: io.github.gistrec/mcp-yandex-kit
README

# Скажите, что должно получиться в&nbsp;Яндекс&nbsp;KIT, — ассистент сделает и проверит

Когда магазин держится на вас, даже небольшие задачи съедают время и внимание: не забыть условия промокода, разобрать документы, найти нужные товары, всё правильно настроить и перепроверить.

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

**Промокод FIRST500 — создан и проверен через API**

> **Вы:** Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках.
>
> **Ассистент:** Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.

**Все документы распознаны и прикреплены к товарам**

> **Вы:** Здесь семь PDF-файлов: инструкции, технические паспорта и сертификаты. Названия непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их.
>
> **Ассистент:** Разобрал содержимое документов, сопоставил их с товарами по моделям и SKU, дал понятные названия и прикрепил к нужным карточкам. Прикреплено 7 из 7 документов, нераспознанных файлов нет.

**Вы решаете, что изменить в магазине, — ассистент выполняет и проверяет.** Без прямой команды он ничего не меняет и не придумывает цены, остатки или условия.

[Подключить магазин](#быстрый-старт) · [Посмотреть, что ещё можно поручить](#что-уже-умеет-ассистент) · [Подписаться на Telegram-канал](https://t.me/a1_yandex_kit_skills)

---

# AI-ассистент для Яндекс KIT

<img src="./assets/images/a1-logo.svg" alt="A1" width="22">&nbsp;**Yandex KIT Skills** <sup>β</sup> позволяет управлять магазином из привычного приложения (Claude, Cursor, Codex и других). Вы ставите задачи обычными словами, а ассистент проверяет текущее состояние магазина, находит то, что требует внимания, и выполняет команды.

- **Четыре готовых сценария.** Операционные риски и приоритеты, ошибки каталога, запуск акций и готовность магазина к открытию.
- **Голосом или текстом.** Формулируйте рабочие задачи естественным языком. Пишите или диктуйте, если приложение поддерживает голосовой ввод. При желании можно вызвать нужный навык напрямую.
- **Изменения только по команде.** Проверки ничего не меняют, а цены, остатки, сроки и другие бизнес-значения ассистент не придумывает.

## Что уже умеет ассистент

1. **Оператор** (`a1-yandex-kit-operator`) проводит операционный разбор магазина: находит всё, из-за чего можно потерять заказ, деньги или репутацию, расставляет риски по срочности и формирует точный план действий.
2. **Доктор каталога** (`a1-yandex-kit-catalog-doctor`) находит ошибки, из-за которых товары теряют видимость и продажи, и по команде владельца исправляет их.
3. **Запуск промо** (`a1-yandex-kit-promo-launcher`) превращает заданные условия в готовую акцию: создаёт, изменяет и запускает скидки, промокоды и подарки в магазине.
4. **Проверка запуска** (`a1-yandex-kit-launch-check`) определяет, готов ли магазин к открытию и приёму заказов: находит блокеры и перечисляет всё, что ещё нужно подтвердить.
5. **Специализированные навыки.** `a1-yandex-kit-orders`, `a1-yandex-kit-catalog`, `a1-yandex-kit-promotions`, `a1-yandex-kit-store` и `a1-yandex-kit-webhooks` — для отдельных задач по заказам, каталогу, акциям, ресурсам магазина и вебхукам.
6. <img src="./assets/images/binoculars.png" alt="Бинокль" width="30"> Не нашли нужного сценария? [Расскажите, какой задачи вам не хватает, и следите за новыми возможностями.](https://t.me/a1_yandex_kit_skills)

## Увидеть работу за минуту

> **Вы:** Давай подключим мой магазин.
>
> **Ассистент:** Для подключения нужен токен Яндекс KIT. Откройте в кабинете **Настройки → API**, скопируйте ключ и вставьте его сюда.
>
> **Вы:** [вставляет токен]
>
> **Ассистент:** Готово — Яндекс KIT подключён. Проверка прошла: вижу магазин «Название магазина».
>
> **Вы:** Чё, как дела?
>
> **Ассистент:** Проверил магазин. Сегодня пришли три заказа: два уже оплачены, один ждёт оплаты.
>
> **Вы:** Создай категорию «Есть на чем присесть» и добавь туда два кресла.
>
> **Ассистент:** Категория «Есть на чем присесть» создана. В неё добавлены «Кресло Urban Relax» и «Nordic Comfort Lounge Chair».
>
> **Вы:** Создай коллекцию «Я чувствую тебя» и перекинь туда всё, что связано с парфюмом.
>
> **Ассистент:** Создал активную коллекцию и добавил в неё три парфюма. Из прежних коллекций товары не удалял.
>
> **Вы:** Создай промокод FIRST500: скидка 500 ₽ при заказе от 25 000 ₽, только на первую покупку, без лимита использований. Привяжи его ко всем товарам и покажи на карточках товаров.
>
> **Ассистент:** Промокод FIRST500 создан и активирован. Он привязан ко всем товарам и показывается на их карточках. Размер скидки, минимальная сумма заказа, ограничение на первую покупку и фактический статус проверены через API.
>
> **Вы:** Подними все цены на 20%.
>
> **Ассистент:** Цены всех 12 товаров повышены с 999 ₽ до 1 199 ₽. Базовые и итоговые цены обновлены и проверены.
>
> **Вы:** [прикладывает семь PDF-файлов]
>
> Здесь инструкции, технические паспорта и сертификаты. Названия файлов непонятные. Разбери, к каким товарам относится каждый документ, и прикрепи их, пожалуйста.
>
> **Ассистент:** Разобрал содержимое семи документов и сопоставил их с каталогом по названиям моделей и SKU:
>
> - «Кресло Urban Relax» — инструкция по сборке и технический паспорт;
> - «Nordic Comfort Lounge Chair» — инструкция по сборке и спецификация материалов;
> - «Black Force», «Pink Dream» и «Champion Spirit» — декларация соответствия для каждого парфюма.
>
> Все совпадения однозначные. Прикрепил 7 из 7 документов, дал им понятные названия и проверил список документов у каждого товара. Нераспознанных файлов нет.

---

## Содержание

- [Быстрый старт](#быстрый-старт)
- [Подробнее о сценариях](#подробнее-о-сценариях)
- [Как ассистент взаимодействует с магазином](#как-ассистент-взаимодействует-с-магазином)
- [Обратите внимание](#обратите-внимание)
- [MCP-сервер](#mcp-сервер-model-context-protocol)
- [Установка через маркетплейсы](#установка-через-маркетплейсы)
- [Обновление](#обновление)
- [Документация](#документация)
- [Помощь и обратная связь](#помощь-и-обратная-связь)

## Быстрый старт

1. Откройте терминал и установите пакет навыков:

   ```bash
   npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y
   ```

   Чтобы позже получить свежие обновления, выполните `npx skills update`.

2. **Явно вызовите** установщик навыком `a1-yandex-kit-setup`. В Codex вызов выглядит так:

   ```text
   $a1-yandex-kit-setup
   ```

   В другом приложении выберите навык с этим именем в списке команд.

3. Следуйте вопросам установщика. Он проверит окружение и токен, подключит магазин к выбранному приложению и выполнит первый вызов.

4. После сообщения об успешном подключении рабочие сценарии можно вызывать обычными фразами — голосом или текстом. Начните с простого вопроса:

   > Как дела в магазине?

Установщик работает с Claude Code, Claude Desktop, Cursor, OpenAI Codex и другими приложениями. Пакет также можно установить через [маркетплейс приложения](#установка-через-маркетплейсы). Если подключение не завершилось, откройте [подробную инструкцию](docs/INSTALLATION.md): там есть полный список платформ, ручная настройка и способы устранения ошибок.

## Подробнее о сценариях

<details open>
<summary><strong>Оператор — риски и приоритеты магазина</strong></summary>

<br>

**Оператор** (`a1-yandex-kit-operator`) помогает вовремя увидеть всё, из-за чего магазин может потерять заказ, деньги или репутацию, не обходя вручную разделы кабинета.

**Что на выходе:** приоритетный разбор заказов, быстрого состояния каталога, промо и вебхуков за выбранный период. Каждый пункт опирается на факты из магазина; недоступные данные остаются явным ограничением.

> **Попробуйте спросить:**
>
> «Как дела в магазине?» · «Что срочного?» · «Покажи заказы за сегодня и их статусы оплаты».

</details>

<details>
<summary><strong>Доктор каталога — ошибки, мешающие товарам продаваться</strong></summary>

<br>

**Доктор каталога** (`a1-yandex-kit-catalog-doctor`) помогает поддерживать корректные карточки, цены и остатки, не открывая вручную каждый товар.

**Что на выходе:** полный аудит выбранных областей с точным покрытием, найденными объектами и разделением на блокеры, риски и рекомендации. По отдельной точной команде навык исправляет одиночные или массовые значения из указанного пользователем источника.

> **Попробуйте спросить:**
>
> «Проведи полный аудит каталога» · «Установи остаток у кроп-топа Summer Breeze: 13 штук» · «Исправь остатки по этому файлу».

</details>

<details>
<summary><strong>Запуск промо — акции по заданным условиям</strong></summary>

<br>

**Запуск промо** (`a1-yandex-kit-promo-launcher`) помогает запустить скидку, промокод или подарок точно на нужные товары и срок, не потеряв заданные условия при настройке.

**Что на выходе:** проверенные товары и существующие промо, выполнение разрешённой последовательности действий и повторное чтение итогового статуса. Механику, размер скидки, область действия, сроки, лимиты и статус задаёт пользователь; при нехватке условий запись не начинается.

> **Попробуйте спросить:**
>
> «Создай промокод SMPT10 “Сентябрь 10”: скидка 10% на все товары с 1 по 30 сентября 2026 года по Москве, без лимита использований. Активируй сразу».

</details>

<details>
<summary><strong>Проверка запуска — готовность магазина к открытию</strong></summary>

<br>

**Проверка запуска** (`a1-yandex-kit-launch-check`) помогает перед запуском убедиться, что покупатель сможет найти товар и пройти доступные этапы покупки без подтверждённых критических проблем.

**Что на выходе:** статус **«не готов»**, **«условно готов»** или **«готов»** с отдельными блокерами, рисками и непроверенными участками. Навык проверяет данные каталога и промо, подтверждения checkout, а при наличии web-доступа у приложения — публичную витрину. Статус **«готов»** не ставится только по данным API.

> **Попробуйте спросить:**
>
> «Проверь, готов ли магазин к открытию».

</details>

## Как ассистент взаимодействует с магазином

**Проверка ничего не изменяет.** Если вы просите «покажи», «проверь», «разбери» или «найди», ассистент только проверит магазин и покажет результат.

**Для изменения нужна точная команда.** Укажите, что нужно изменить и какое значение установить. Например: «Подними цены всех товаров на 20%». Ассистент не будет самостоятельно придумывать цену, остаток, срок или другое решение.

**Повторное подтверждение не требуется.** Точная команда уже считается разрешением на действие.

Это правило относится к ассистенту. Само AI-приложение может отдельно показывать
кнопку Allow перед вызовом инструмента. При подключении можно один раз включить
«Работу без остановок»: AI-приложение разрешит все текущие и будущие инструменты
Yandex KIT, включая удаления, заказы, промо и настройки магазина. Сами навыки
по-прежнему меняют магазин только по вашей точной команде.

**Результат проверяется.** Перед изменением ассистент посмотрит текущее состояние объекта, выполнит команду и затем проверит, что получилось.

**Неясная операция не повторяется.** Если во время изменения пропадёт связь и результат нельзя будет подтвердить, ассистент сообщит об этом, но не станет повторять команду вслепую.

**Автоматической отмены нет.** Ассистент не сохраняет копию состояния магазина перед каждым изменением, поэтому вернуть всё одной командой «как было» нельзя.

## Обратите внимание

**Все изменения происходят в рабочем магазине.** Отдельного тестового магазина или пробного режима нет.

**Ассистент не следит за магазином постоянно.** Он проверяет состояние магазина и выполняет действия только тогда, когда вы ставите ему задачу.

**С заказами доступны не все действия.** Ассистент может просматривать, подтверждать и отменять заказы. Он не может создавать заказы, свободно менять их содержимое, устанавливать статусы оплаты и доставки, оформлять возвраты или писать покупателям.

**Готовность к открытию проверяется не полностью автоматически.** Ассистент не видит настройки оплаты и доставки и не может самостоятельно оформить и оплатить тестовый заказ. Эту часть проверки выполняет владелец магазина.

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

## MCP-сервер (Model Context Protocol)

Этот репозиторий содержит рабочий MCP-сервер для API Яндекс KIT — не только навыки и плагины для AI-клиентов.

- **Реализация.** Сервер написан на TypeScript с официальным пакетом [`@modelcontextprotocol/sdk`](https://www.npmjs.com/package/@modelcontextprotocol/sdk), создаётся через `McpServer` и подключается к AI-клиенту через `StdioServerTransport`.
- **Возможности MCP.** Сервер предоставляет 88 инструментов (`tools`) для работы с товарами, вариантами (включая массовое обновление цен), категориями, характеристиками, видео, новостями, заказами, клиентами, складами, коллекциями, файлами, скидками, промокодами, подарочными картами, алертами и вебхуками. Ресурсы (`resources`) и промты (`prompts`) не объявляются: операции API предоставляются как MCP-инструменты.
- **Полное покрытие API.** Специализированные инструменты дополняют `search_operations`, `get_operation_schema` и `kit_request`, через которые доступны все 166 операций API Яндекс KIT.
- **Транспорт.** Локальный MCP-сервер работает через `stdio`.
- **Публикация.** Сервер доступен как npm-пакет [`mcp-yandex-kit`](https://www.npmjs.com/package/mcp-yandex-kit) и запускается через `npx` на Node.js 20 и новее.
- **Навыки.** Навыки из этого репозитория добавляют готовые рабочие сценарии и правила безопасного выполнения операций поверх MCP-инструментов, но не заменяют сам MCP-сервер.

Исходный код: [`packages/mcp/src/index.ts`](packages/mcp/src/index.ts) · [`packages/mcp/src/tools`](packages/mcp/src/tools) · [список инструментов](docs/TOOLS.md) · [README MCP-пакета](packages/mcp/README.md).

Ниже показано прямое подключение самого MCP-сервера. Оно добавляет MCP-инструменты для работы с API Яндекс KIT, но не устанавливает готовые навыки из этого репозитория.

<details>
<summary><strong>Codex — подключить MCP-сервер</strong></summary>

<br>

1. Добавьте сервер командой:

   ```bash
   codex mcp add yandex-kit \
     --env YANDEX_KIT_TOKEN=ваш_токен \
     -- npx -y mcp-yandex-kit@latest
   ```

2. Начните новую задачу Codex.

3. Проверьте подключение простым запросом:

   > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.

</details>

<details>
<summary><strong>Cursor — подключить MCP-сервер</strong></summary>

<br>

1. Откройте `~/.cursor/mcp.json` и добавьте сервер:

   ```json
   {
     "mcpServers": {
       "yandex-kit": {
         "command": "npx",
         "args": ["-y", "mcp-yandex-kit"],
         "env": {
           "YANDEX_KIT_TOKEN": "ваш_токен"
         }
       }
     }
   }
   ```

2. Перезагрузите окно Cursor.

3. Проверьте подключение простым запросом:

   > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.

</details>

<details>
<summary><strong>Claude Code — подключить MCP-сервер</strong></summary>

<br>

1. Добавьте сервер командой:

   ```bash
   claude mcp add yandex-kit \
     -e YANDEX_KIT_TOKEN=ваш_токен \
     -- npx -y mcp-yandex-kit@latest
   ```

2. Начните новую сессию Claude Code.

3. Проверьте подключение простым запросом:

   > Проверь, подключился ли магазин. Покажи, сколько товаров в каталоге, и скажи, на что стоит обратить внимание в первую очередь.

</details>

## Установка через маркетплейсы

Выберите AI-приложение, в котором хотите управлять магазином. Каждый вариант устанавливает полный комплект: подключение Яндекс KIT, API-навыки и четыре готовых сценария.

Если способ установки не важен, используйте [быстрый старт](#быстрый-старт) — там достаточно одной команды.

<details>
<summary><strong>Codex — установить через Marketplace</strong></summary>

<br>

1. Добавьте маркетплейс и установите полный комплект:

   ```bash
   codex plugin marketplace add ztemerbekov/a1-yandex-kit-skills
   codex plugin add a1-yandex-kit-skills@a1-yandex-kit-skills
   ```

2. Начните новую задачу Codex, чтобы загрузились установленные навыки.

3. Подключите магазин:

   ```text
   $a1-yandex-kit-skills:a1-yandex-kit-setup
   ```

Следуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.

</details>

<details>
<summary><strong>Cursor — установить через Marketplace</strong></summary>

<br>

1. Добавьте маркетплейс:

   ```bash
   cursor-agent plugin marketplace add https://github.com/ztemerbekov/a1-yandex-kit-skills
   ```

2. Запустите Cursor Agent, откройте `/plugin` и выберите маркетплейс **A1 Яндекс KIT**.

3. Установите плагин **A1 Яндекс KIT**, затем выберите навык `a1-yandex-kit-setup` и следуйте вопросам подключения.

</details>

<details>
<summary><strong>Claude Code — установить через Marketplace</strong></summary>

<br>

1. Добавьте маркетплейс и установите полный комплект:

   ```text
   /plugin marketplace add ztemerbekov/a1-yandex-kit-skills
   /plugin install a1-yandex-kit-skills@a1-yandex-kit-skills
   ```

2. Загрузите установленные навыки:

   ```text
   /reload-plugins
   ```

3. Подключите магазин:

   ```text
   /a1-yandex-kit-skills:a1-yandex-kit-setup
   ```

Следуйте вопросам установщика — он проверит окружение, подключит магазин и выполнит первый вызов.

</details>

---

## Обновление

Обновляйте пакет тем же способом, которым установили его.

Если вы использовали [быстрый старт](#быстрый-старт), получите свежую версию навыков одной командой:

```bash
npx skills update
```

Если вы устанавливали пакет через маркетплейс, обновите плагин **A1 Яндекс KIT** в том же AI-приложении. После обновления начните новую задачу, чтобы приложение загрузило свежую версию навыков.

---

## Документация

- [Как установить и подключить магазин](https://github.com/ztemerbekov/a1-yandex-kit-skills/blob/codex/readme-for-store-managers/docs/INSTALLATION.md) — пошаговая настройка, поддерживаемые приложения и помощь, если подключение не заработало.
- [Как устроен Yandex KIT Skills](https://github.com/ztemerbekov/a1-yandex-kit-skills/blob/codex/readme-for-store-managers/docs/TECHNICAL.md) — к чему подключается ассистент, какие действия ему доступны и какие есть ограничения.
- [Документация API Яндекс KIT](https://yandex.ru/dev/kit/ru/) — официальный справочник Яндекса для разработчиков.

---

## Помощь и обратная связь

Нужна помощь, что-то не работает или есть идея? Напишите нам в Telegram — <img src="./assets/images/a1-logo.svg" alt="A1" width="22">&nbsp;[**Yandex KIT Skills** <sup>β</sup>](https://t.me/a1_yandex_kit_skills).

<br>

<p align="center">
  <img src="./assets/images/mona-hifive-yandex-kit-warm.gif" alt="Две Моны дают пять" width="256">
</p>

<p align="center">
  Вы дочитали до конца!
</p>
A1 Yandex KIT MCP

About

Details

README

More
