Перейти к основному содержимому

Подключение Claude и ChatGPT

MarketMate можно подключить к ИИ-ассистенту, которым вы уже пользуетесь, — Claude или ChatGPT — и задавать ему вопросы о своих товарах Я.Маркета, Ozon и Wildberries. Например: «какие товары на Ozon без ручной цены», «что менялось у товара за неделю», «сравни настройки товара на разных маркетплейсах».

Ключ копировать не нужно: ассистент открывает страницу MarketMate, вы входите в кабинет и разрешаете доступ.

Что умеет ассистент​

Доступ только на чтение:

  • список товаров с фильтрами — по магазину, поиску, наличию, карантину цены, категории и бренду;
  • отдельный товар с его настройками;
  • история изменений товара.

Изменить что-либо через ассистента нельзя: ни цену, ни наценку, ни передачу остатков. На вопросы о заказах, продажах, остатках на складах, аналитике, возвратах и отзывах ассистент пока не ответит — этих данных у него нет. Товары Telegram-магазина ассистенту недоступны.

Перед подключением​

  • Подключать ассистента может владелец аккаунта или сотрудник, роли которого выдано право Дополнительно → API ключи → Создание API ключа.
  • Добавлять свои подключения по адресу можно не на всех тарифах Claude и ChatGPT. Проверьте условия своего тарифа в ассистенте.
  • MarketMate пока нет в каталогах приложений Claude и ChatGPT, поэтому поиском в ассистенте он не находится. Добавьте его по адресу:
https://public-api.market-mate.ru/mcp

Подключение в Claude​

  1. Откройте в Claude настройки и перейдите в раздел коннекторов.
  2. Выберите добавление своего коннектора и укажите название, например «MarketMate», и адрес https://public-api.market-mate.ru/mcp.
  3. Нажмите Подключить (Connect). Откроется страница MarketMate.
  4. Войдите в кабинет, если ещё не вошли, и разрешите доступ — см. «Экран подтверждения».
  5. Вернитесь в Claude и включите коннектор MarketMate в чате, где задаёте вопросы.

Перед каждым обращением к MarketMate Claude может спрашивать разрешение. Чтобы не подтверждать каждый запрос, выберите в окне запроса «Всегда разрешать» или задайте этот режим инструментам MarketMate в настройках коннектора. Все инструменты MarketMate только читают данные.

Подключение в ChatGPT​

  1. Откройте в ChatGPT настройки, раздел приложений и коннекторов.
  2. Создайте подключение: укажите название, например «MarketMate», адрес https://public-api.market-mate.ru/mcp и способ входа OAuth.
  3. Сохраните подключение. Откроется страница MarketMate.
  4. Войдите в кабинет, если ещё не вошли, и разрешите доступ — см. «Экран подтверждения».
  5. Вернитесь в ChatGPT и выберите MarketMate в чате, где задаёте вопросы.

Если кнопки создания подключения нет, включите в дополнительных настройках раздела режим разработчика (Developer mode): на некоторых тарифах ChatGPT без него свои подключения не добавляются.

ChatGPT может запрашивать подтверждение перед действиями, которые считает рискованными. Все инструменты MarketMate только читают данные.

Названия пунктов меню в Claude и ChatGPT меняются вместе с самими ассистентами. Если пункт называется иначе, ищите разделы «Коннекторы» (Connectors) или «Приложения» (Apps).

Экран подтверждения​

На странице MarketMate указаны:

  • Приложение — Claude или ChatGPT;
  • Сотрудник, от имени которого будет работать подключение;
  • Уровень доступа — «Только чтение: товары и история изменений».

Нажмите Разрешить, и вы вернётесь в ассистента, подключение готово. Если вы не начинали подключение сами, нажмите Отклонить: ассистент не получит доступа. Если просто закрыть страницу, доступа ассистент тоже не получит.

Если подключить нельзя, на странице указана причина:

  • у роли нет права «Создание API ключа» — обратитесь к владельцу аккаунта;
  • достигнут лимит: не более 5 ключей и подключений на сотрудника и 20 на аккаунт — отключите неиспользуемые в разделе Настройки → Инструменты → API и приложения;
  • недопустимый адрес возврата в приложение — начните подключение заново из ассистента.

Каждое приложение подключается к сотруднику один раз. Если подключить Claude повторно, прежнее подключение обновится, о чём предупредит экран подтверждения. Claude и ChatGPT — два отдельных подключения.

Чьи права действуют​

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

  • для списка и отдельного товара нужно право Маркетплейсы → Товары → Список товаров;
  • для истории — Маркетплейсы → Товары → История цен и остатков.

Если у сотрудника забрали право, ассистент сразу перестаёт получать эти данные. Если сотрудника удалили или сделали неактивным, ассистент сразу теряет доступ.

Просмотр и отключение​

Подключения показываются в разделе Настройки → Инструменты → API и приложения вместе с API-ключами и отмечены значком Приложение. Сотрудник видит свои подключения, владелец аккаунта — подключения всех сотрудников. На карточке указаны приложение, уровень доступа, сотрудник, дата подключения и время последнего использования.

Чтобы отключить ассистента, нажмите на карточке подключения Отключить и подтвердите. Доступ пропадает сразу: ассистент сообщит, что подключение не работает, и предложит подключиться заново. Подключение бессрочное — пока его не отключат, оно продолжает работать.

Лимиты запросов​

Запросы ассистента к товарам и истории расходуют те же лимиты, что и API-ключи вашего аккаунта (см. «Лимиты запросов»). Для служебных запросов ассистента — подключения и получения списка возможностей — действует отдельный лимит: 60 запросов в минуту, до 10 подряд. При превышении лимита ассистент сообщает, через сколько секунд можно повторить запрос.

Claude Code, Codex и другие клиенты​

Программы для разработчиков, например Claude Code и Codex, можно подключить к тому же адресу https://public-api.market-mate.ru/mcp с API-ключом вместо входа через MarketMate. Выпустите ключ «Только чтение» (см. «API и приложения») и передайте его в заголовке Authorization: Bearer <ключ>. Работа таких подключений не гарантируется: MarketMate проверен только с Claude и ChatGPT.

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

  • Ассистент не находит MarketMate поиском — добавьте его по адресу, как описано выше.
  • Нет пункта для добавления своего подключения — проверьте тариф ассистента, а в ChatGPT — включён ли режим разработчика.
  • Ассистент отвечает, что нет доступа, — проверьте в разделе API и приложения, что подключение не отключено, а у роли сотрудника есть права на товары и историю. Если подключение удалено, подключитесь заново.

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