Кратко
Запускай свой магазин на маркетплейсе Tesco с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает в Великобритании; войди с помощью API-ключа магазина из своего личного кабинета продавца Tesco.
Пошаговая настройка
Подключи Tesco Marketplace к Claude за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Tesco Marketplace в пошаговой настройке и добавь свой MCP URL в Claude. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
AnythingMCP есть в каталоге коннекторов Claude: добавьте его в Claude в один клик (откроется в новой вкладке), затем войдите и выберите, какие MCP-серверы может использовать Claude.
Попробуй спросить
Примеры промптов для Tesco Marketplace
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди, нажми Connectors → Tesco Marketplace, вставь свои учетные данные, создай API-ключ MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Tesco Marketplace + Claude
Запускай свой магазин на маркетплейсе Tesco с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает в Великобритании; войди с помощью API-ключа магазина из своего личного кабинета продавца Tesco.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
TESCO_API_KEY
Шаг 1 — Получи учетные данные
Страны: Великобритания.
Кто может продавать: Tesco принимает заявки через свою форму для продавцов и проверяет каждого продавца; бизнес должен быть зарегистрирован и иметь номер НДС в Великобритании. Коннектору нужна учетная запись продавца, которую уже открыл Tesco.
API-ключ принадлежит пользователю, который его создал: он перестает работать, если этот пользователь отключен или теряет роль Владелеца или Менеджера.
Настройка занимает около 5 минут.
- Войди в личный кабинет продавца Tesco:
https://tescouk-prod.mirakl.net/login. - В личном кабинете открой свои инициалы (в правом верхнем углу) > Личные настройки > API-ключ и нажми Создать новый ключ (или скопируй существующий ключ). Вставь его в
TESCO_API_KEY. Ключ отправляется как есть в заголовкеAuthorization, безBearer. Создание нового ключа делает старый недействительным, поэтому любой другой инструмент, использующий его, перестает работать. - Оставь
TESCO_SHOP_IDпустым. Только если твой пользователь управляет несколькими магазинами на Tesco, установиTESCO_SHOP_IDна числовой идентификатор магазина, на котором должен работать этот коннектор (показан на панели управления личного кабинета рядом с Идентификатором или ID магазина, и возвращается какshop_idс помощьюtesco_get_account). Без него используется твой магазин по умолчанию. - Установи и запусти
tesco_get_account: он возвращает магазин, к которому принадлежит ключ.
С чего начать: tesco_get_account показывает магазин, связанный с ключом (идентификатор, название, состояние, валюта и каналы). Для повседневной работы используй tesco_list_orders с order_state_codes=WAITING_ACCEPTANCE, tesco_list_offers для цен и наличия и tesco_list_threads для сообщений, ожидающих ответа.
Продукты и конкурирующие предложения: tesco_get_products ищет продукты в каталоге Tesco по EAN или другому идентификатору и возвращает SKU продукта на маркетплейсе; tesco_list_product_offers перечисляет предложения каждого магазина для заданных продуктов, сначала с лучшей ценой, примерно 5 вызовов в минуту.
Рабочий процесс заказов: новый заказ ожидает в WAITING_ACCEPTANCE. tesco_accept_order принимает (или отказывает) каждую строку; после списания с клиента заказ переходит в SHIPPING. Затем tesco_update_tracking сохраняет перевозчика и номер отслеживания (коды перевозчиков берутся из tesco_list_carriers), а tesco_ship_order подтверждает отправку (SHIPPED). Поздние состояния: TO_COLLECT, RECEIVED, CLOSED, REFUSED и CANCELED. Используй tesco_list_orders с order_state_codes=WAITING_ACCEPTANCE для повседневного списка дел и has_incident=true для открытых инцидентов; tesco_resolve_incident закрывает инцидент по одной строке заказа, как только он решен. Документы, прикрепленные к заказам (накладные, этикетки, счета клиента), перечисляются с помощью tesco_list_order_documents.
Записи: сначала подтверждай. tesco_accept_order, tesco_update_tracking, tesco_ship_order, tesco_resolve_incident, tesco_accept_return, tesco_receive_return, tesco_update_offers, tesco_reply_thread, tesco_create_order_thread и tesco_import_products действуют на живом маркетплейсе. Перед каждым вызовом показывай пользователю, что изменится (идентификатор заказа и строки, номер отслеживания, SKU предложения со старой и новой ценой или наличием, текст сообщения и получатели) и жди согласия. Отказ от строки заказа отменяет ее навсегда. Никакой инструмент здесь не возвращает деньги, не отменяет заказы и не перемещает деньги; делай это в личном кабинете. tesco_import_offers может удалять предложения (режим REPLACE удаляет каждое предложение, отсутствующее в файле), поэтому он установлен выключенным.
Обновление предложений (цен и наличия): tesco_update_offers (OF24) заменяет все предложение. Каждое поле, которое ты оставляешь пустым, сбрасывается: отсутствующее quantity становится 0, отсутствующая discount или description удаляется. Всегда сначала читай предложение (tesco_get_offer или tesco_list_offers с sku) и отправляй его обратно полностью с только предполагаемым изменением: shop_sku, product_id и product_id_type (из product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (его код), min_quantity_alert, description, discount, all_prices, available_started / available_ended (читай как available_start_date / available_end_date) и любые offer_additional_fields. Оставь update_delete пустым или update. Вызов возвращает import_id; изменение применяется асинхронно, поэтому проверь его с помощью tesco_get_offer_import перед повторным чтением предложения. Коды условий для state_code берутся из tesco_list_offer_conditions, коды логистического класса из tesco_list_logistic_classes.
Импорт файлов: tesco_import_products (P41) и tesco_import_offers (OF01) принимают URL CSV, XLSX или XML файла в формате, который требует Tesco; коннектор загружает его и загружает в Tesco. Отслеживай их с помощью tesco_list_product_imports / tesco_get_product_import и tesco_list_offer_imports / tesco_get_offer_import.
Возвраты: tesco_list_returns (RT11) перечисляет запросы на возврат. Где Tesco позволяет магазину решать, tesco_accept_return принимает или отказывает в одном из WAITING_ACCEPTANCE, а tesco_receive_return подтверждает, что товары прибыли. Возвраты остаются в личном кабинете.
Сообщения: tesco_list_threads перечисляет разговоры (фильтруй с entity_type=MMP_ORDER и entity_id=<order id> для одного заказа; entity_id без entity_type отклоняется), tesco_get_thread читает один с его сообщениями, tesco_reply_thread отвечает (получатель CUSTOMER или OPERATOR, который является Tesco) и tesco_create_order_thread открывает новый разговор по заказу. Коды причин для тем берутся из tesco_list_reasons; оставь его locale пустым, если не знаешь, что на маркетплейсе есть этот язык (неактивная локаль отвечает 400).
Деньги: tesco_list_invoices (IV01) перечисляет бухгалтерские документы, которые Tesco выдает магазину, а tesco_list_transactions (TL02) — строки транзакций (продажи, комиссии, возвраты, выплаты). Если Tesco использует расширенное выставление счетов для продавцов, IV01 не возвращает новых документов; используй tesco_list_document_requests (DR11) и транзакции тогда.
Справочные списки: tesco_list_channels (страницы стран), tesco_list_carriers, tesco_list_shipping_zones, tesco_list_shipping_methods и tesco_list_logistic_classes меняются редко; читай их один раз за разговор.
Пагинация: заказы, предложения, счета и импорты продуктов разбиваются на страницы с помощью max (максимум 100) и offset. Темы, возвраты, транзакции, запросы документов и импорты предложений возвращают next_page_token; передай его как page_token, чтобы получить следующую страницу (все остальные фильтры тогда игнорируются), пока он не исчезнет.
Даты в формате ISO 8601, например, 2026-10-01T00:00:00Z; ответы в UTC.
Ограничения по частоте: У каждого API есть свои ограничения, и Tesco может их ужесточить. Перечисление предложений и заказов предназначено для интерактивного использования, импорты продуктов и предложений — не чаще чем раз в 15 минут, tesco_get_account и справочные списки — примерно раз в день. Код 429 содержит заголовок Retry-After с количеством секунд для ожидания; не пытайся повторять в цикле.
Ошибки: 401 означает, что ключ неверен или был заменен на более новый, 403 — что у твоего пользователя нет прав на это действие, 404 — что заказ, предложение или тема не существуют для этого магазина, 400 — неверный параметр или заказ в неверном состоянии (сообщение указывает на это, например, ORDER_INVALID_STATE).
Шаг 2 — Установи адаптер
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Шаг 3 — Добавь коннектор в Claude
URL твоего сервера: в AnythingMCP открой MCP Servers → сервер, на котором находится этот коннектор, и скопируй его URL (
https://cloud.anythingmcp.com/mcp/…). Используй его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Рекомендуемый путь: работает на claude.ai web без редактирования каких-либо конфигурационных файлов.
- В Claude открой Plugins (на некоторых тарифах пока Customize) → Connectors.
- Нажми + Add, затем Add custom connector.
- Введи имя, например,
Tesco Marketplace, и URL удаленного сервера MCPhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Continue, оставь найденные настройки и снова нажми Continue. - Выбери Sign in now, нажми Add и войди в AnythingMCP (OAuth), чтобы разрешить доступ.
Все инструменты ниже появятся в твоем чате: начни вводить подсказки.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
tesco_get_account | Читает магазин, связанный с API-ключом на этом маркетплейсе (A01): идентификатор и название магазина, состояние, каналы, валюта, рейтинг и процент одобрения, контакт… |
tesco_list_orders | Перечисляет заказы (OR11) с их строками, клиентом, адресом доставки, ценами, состоянием и инцидентами. Фильтруй по состоянию (например, WAITING_ACCEPTANCE для… |
tesco_list_offers | Перечисляет предложения магазина (OF21): SKU, продукт, цена и скидка, все цены по каналам, количество на складе, состояние, время выполнения и… |
tesco_get_offer | Читает одно предложение полностью по его идентификатору предложения (OF22): каждое ценовое поле, скидка, количество, состояние, логистический класс, время выполнения и пользовательские… |
tesco_list_offer_conditions | Перечисляет условия предложений (OF61), которые принимает маркетплейс, например, новые или б/у, с кодом, который нужно указать в state_code при обновлении предложений |
tesco_list_offer_imports | Перечисляет импорты и обновления предложений (OF04), из файлов и из tesco_update_offers: статус (WAITING, RUNNING, COMPLETE, FAILED), прочитанные строки, в… |
tesco_get_offer_import | Читает статус одного импорта предложения или обновления предложения (OF02) по его import_id, как возвращается tesco_update_offers или tesco_import_offers… |
tesco_export_offers | Запускает экспорт всех предложений магазина в виде файлов (OF52): так читается весь каталог (каждый SKU с ценой и остатком) вместо постраничного вызова tesco_list_offers |
tesco_get_offer_export_status | Статус экспорта предложений, запущенного через tesco_export_offers (OF53): PENDING, COMPLETED или FAILED, а после завершения — ссылки на файлы |
tesco_get_offer_export_file | Читает один файл завершённого экспорта предложений (OF54): предложения с SKU, товаром, количеством, ценами и другими выгруженными полями, в JSON или CSV |
tesco_list_product_imports | Перечисляет импорты продуктов (P51) с их статусом (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), количество трансформаций и… |
tesco_get_product_import | Читает статус одного импорта продукта (P42) по его import_id: статус импорта, причина, количество трансформаций и детали интеграции… |
tesco_get_products | Ищет продукты в каталоге маркетплейса по их идентификаторам (P31), например, EAN, и получает SKU продукта на маркетплейсе, название и категорию.… |
tesco_list_product_offers | Перечисляет предложения каждого магазина для заданных продуктов (P11), отсортированные по лучшей цене, чтобы сравнить свою цену с конкурентами. Укажи product_ids… |
tesco_list_threads | Перечисляет темы сообщений (M11) с клиентами и Tesco: тема, связанный заказ или предложение, участники, дата последнего сообщения и с какого времени магазин… |
tesco_get_thread | Читает одну тему сообщений (M10) со всеми ее сообщениями, отправителями, получателями, вложениями и связанным заказом или предложением |
tesco_list_returns | Перечисляет запросы на возврат (RT11) с их состоянием, строками возврата, причиной, RMA, отслеживанием и связанным заказом. Фильтруй по состоянию, заказу или дате.… |
tesco_list_reasons | Перечисляет коды причин маркетплейса (RE01): инциденты, отмены, возвраты и причины сообщений, с их метками и тем, может ли магазин… |
tesco_list_carriers | Перечисляет перевозчиков, известных маркетплейсу (SH21), с их кодом, меткой и URL для отслеживания. Используй код как carrier_code в… |
tesco_list_invoices | Перечисляет бухгалтерские документы, которые Tesco выдает магазину (IV01): счета и кредитные ноты с периодом, итогами с налогом и без… |
tesco_list_transactions | Перечисляет строки транзакций магазина (TL02): суммы заказов, доставка, комиссии, возвраты, ручные кредиты и выплаты, с суммой, типом… |
tesco_list_document_requests | Перечисляет запросы бухгалтерских документов (DR11), используемые, когда Tesco проводит расширенное выставление счетов для продавцов: счета и кредитные ноты, которые Tesco или магазин… |
tesco_list_order_documents | Перечисляет документы, прикрепленные к одному или нескольким заказам (OR72): накладные, этикетки для доставки, счета клиентов и другие файлы, с id, файлом… |
tesco_list_channels | Перечисляет каналы продаж маркетплейса (CH11), обычно по одному на сайт страны, с кодом и меткой. Используй коды как channel_codes в… |
tesco_list_shipping_zones | Перечисляет активные зоны доставки маркетплейса (SH11) с кодом и меткой, например, материковая Франция или Корсика. Меняется редко: вызывай его… |
tesco_list_shipping_methods | Перечисляет активные методы доставки маркетплейса (SH12), например, стандартный, экспресс или самовывоз, с кодом, меткой, есть ли номер отслеживания… |
tesco_list_logistic_classes | Перечисляет логистические классы маркетплейса (SH31), размеры или весовые категории, которые определяют цены на доставку, с кодом и меткой. Используй код как… |
tesco_accept_order | Принимает или отказывает в строках заказа, ожидающего принятия (OR21). Каждая строка заказа должна быть перечислена. Отказ от строки отменяет ее… |
tesco_update_tracking | Устанавливает перевозчика и номер отслеживания заказа (OR23). Укажи carrier_code из tesco_list_carriers или carrier_name с carrier_url для… |
tesco_ship_order | Подтверждает, что заказ в состоянии SHIPPING был отправлен (OR24); он переходит в SHIPPED, и клиент уведомляется. Сначала установи отслеживание с… |
tesco_update_offers | Создает или обновляет предложения, включая цену и наличие (OF24). Полностью заменяет каждое предложение: каждое поле, оставленное пустым, сбрасывается (отсутствующее… |
tesco_reply_thread | Отвечает в теме сообщений (M12) клиенту или Tesco. Сообщение доставляется сразу и не может быть отозвано: покажи пользователю текст… |
tesco_create_order_thread | Начинает новую тему сообщений по заказу (OR43) с клиентом, Tesco или обоими. Сообщение доставляется сразу: покажи пользователю текст… |
tesco_resolve_incident | Помечает открытый инцидент по одной строке заказа как решенный (OR64), как только проблема клиента решена. reason_code должен быть INCIDENT_CLOSE… |
tesco_accept_return | Принимает или отказывает в запросе на возврат в WAITING_ACCEPTANCE (RT21). Только когда Tesco обрабатывает возвраты в личном кабинете продавца и оставляет… |
tesco_receive_return | Подтверждает, что товары принятого возврата прибыли на твой склад (RT25). Возврат переходит в RECEIVED. Действует на живом маркетплейсе… |
tesco_import_products | Отправляет файл продукта на маркетплейс (P41) для создания или обогащения продуктов в его каталоге. file_url — это адрес CSV, XLSX или XML… |
tesco_import_offers | Импортирует файл предложений (OF01) для создания, обновления или удаления предложений оптом. Режим REPLACE удаляет каждое предложение, которое отсутствует в файле, и… |
Примеры подсказок
- "Какие заказы Tesco ожидают моего подтверждения, и какова их стоимость в GBP?"
- "Установи цену моего SKU садовой скамейки GB-TEAK-150 на 179 GBP."
- "Покажи открытые инциденты по моим заказам Tesco."
- "Добавь отслеживание DPD 15501234567890 к заказу 8812345-A и подтверди отправку."
- "Покажи счета, которые Tesco выдал мне в этом квартале."
Часто задаваемые вопросы
Работает ли это с Claude Code так же, как и с Claude Desktop? Да, указывай оба на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Где я могу получить API-ключ Tesco? В личном кабинете продавца Tesco: твои инициалы (в правом верхнем углу), Личные настройки, API-ключ, затем Создать новый ключ (или скопировать существующий ключ). Создание нового ключа делает старый недействительным. Если у твоего пользователя несколько магазинов, установи TESCO_SHOP_ID; в противном случае используется твой магазин по умолчанию.
Кто может продавать на Tesco и какие страны это охватывает? Tesco принимает заявки через свою форму для продавцов и проверяет каждого продавца; бизнес должен быть зарегистрирован и иметь номер НДС в Великобритании. Коннектор охватывает Великобританию. API-ключ принадлежит пользователю, который его создал: он перестает работать, если этот пользователь отключен или теряет роль Владелеца или Менеджера.
Может ли он отменять заказы, возвращать деньги или удалять предложения? Никакой инструмент не возвращает деньги или не отменяет заказ; делай это в личном кабинете Tesco. Отказ от строки при принятии заказа отменяет ее навсегда, поэтому AI показывает тебе каждую запись и ждет согласия. tesco_import_offers установлен выключенным, потому что его режим REPLACE удаляет каждое предложение, отсутствующее в файле; включай его на странице коннектора только если AI должен его использовать.
Следующие шаги
- Страница коннекторов
- Подключение к ChatGPT
- Подключение к Cursor
- Подключение к Gemini
- Подключение к Meta Muse
- Подключение к Microsoft Copilot
Это руководство помогло?