A1-x-Tech/mcp-yandex-merchants

**A1 Яндекс Товары MCP** подключает AI-приложение к партнёрскому API Яндекс Товаров. Можно обычными словами менять цены, скидки и видимость отдельных товаров — без редактирования и повторной загрузки всего YML-фида. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
- **13 готовых действий.** Подключение аккаунта прямо из диалога, проверка доступа, список фидов, цены, скидки, скрытие и возврат товаров, а также прямой вызов остальных методов API.
- **Для одного товара и больших списков.** За один запрос можно изменить цены у 2 000 товаров или скрыть и вернуть до 500 товаров.
- **Точечные изменения.** Сервер работает с уже загруженным YML-фидом и не создаёт фиды заново.
- **Проверяемый результат.** Запись считается успешной только при status: "OK" в ответе Яндекс Товаров.
- **Работает локально.** Сервер запускается через npx; OAuth-токен остаётся на вашем компьютере.
Попробуйте первым сообщением:
> Проверь подключение к Яндекс Товарам и покажи доступные фиды.
Подключить сервер · Посмотреть сценарии · Открыть техническую документацию
---
Увидеть работу за минуту
> **Вы:** Проверь подключение и покажи мои фиды.
>
> **Ассистент:** Проверяет токен и показывает feedId и адрес каждого доступного фида.
>
> **Вы:** В фиде 1069 подготовь новую цену для SKU-123: 1 490 ₽ вместо 1 990 ₽. Сначала покажи изменение.
>
> **Ассистент:** Подготовлено: фид 1069, товар SKU-123, новая цена 1 490 ₽, зачёркнутая цена 1 990 ₽. Отправить изменение?
>
> **Вы:** Да, обнови.
>
> **Ассистент:** Отправляет изменение и проверяет поле status в ответе. Операция завершена, если Яндекс Товары вернули status: "OK".
Содержание
- Быстрый старт
- Что можно поручить
- Как это работает
- Что может изменить данные
- Подключение и настройка
- Данные и телеметрия
- Ограничения
- Техническая документация
- Поддержка
Быстрый старт
Понадобятся Node.js 20 или новее, загруженный в Яндекс Товары YML-фид и логин Яндекса, под которым этот фид загружен. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется.
1. Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.
2. Напишите: «Подключи Яндекс Товары». Ассистент даст ссылку на вход в Яндекс и попросит прислать код подтверждения. Если вы задали YANDEX_MERCHANTS_OAUTH_TOKEN в конфигурации, этот шаг не нужен.
3. Проверьте подключение: «Проверь подключение к Яндекс Товарам и покажи доступные фиды». Если сервер вернул список фидов, можно переходить к ценам и видимости товаров.
Codex
**Через интерфейс приложения:**
1. Откройте **Settings → MCP servers**.
2. Нажмите **Add server**.
3. Выберите **STDIO**, затем укажите команду запуска npx -y mcp-yandex-merchants@latest.
4. Нажмите **Save**, затем **Restart**.
**Через командную строку:**
Проверьте подключение:
Затем в чате Codex попросите: «Подключи Яндекс Товары».
Официальная инструкция Codex
Claude Code
Проверьте сервер командой:
Затем начните диалог с просьбы подключить Яндекс Товары.
Документация Claude Code
Claude Desktop
Актуальный официальный путь — **Settings → Extensions**. Для пользовательского desktop extension откройте **Advanced settings → Extension Developer → Install Extension…**, выберите файл .mcpb и следуйте подсказкам.
Этот репозиторий сейчас публикует npm-пакет со stdio и пока не содержит .mcpb. Поэтому используйте приведённый ниже JSON stdio-конфиг как fallback только в сборках Claude Desktop, где ещё поддерживается локальная конфигурация:
В таких сборках сохраните его в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.
После сохранения перезапустите Claude Desktop, откройте новый диалог и попросите подключить Яндекс Товары.
Документация Claude Desktop
Cursor
Для всех проектов создайте ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json); только для текущего проекта — .cursor/mcp.json: