Как подключить idealo к Meta Muse через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → idealo, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

idealo + Meta Muse

Управляйте предложениями вашего магазина в сервисе сравнения цен idealo из AI-агента через Partner Web Service idealo: читайте предложение по SKU, а с вашего согласия создавайте или заменяйте предложения, меняйте цены, сроки доставки и названия или снимайте предложения. Для магазинов, размещённых на idealo.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

IDEALO_CLIENT_ID, IDEALO_CLIENT_SECRET, IDEALO_SHOP_ID

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Нужен магазин, размещённый на idealo (договор продавца с idealo), и доступ к idealo Business.

1. Войдите в idealo Business и откройте Shop settings → API clients (business.idealo.com/direct/shops/settings/api-clients).
2. Создайте API-клиент с доступом к Partner Web Service и скопируйте его client ID и client secret. Secret показывается только один раз; если его больше нет, создайте новый клиент.
3. Вставьте client ID (UUID) в IDEALO_CLIENT_ID, secret в IDEALO_CLIENT_SECRET, а числовой shop ID, который показывает idealo Business, в IDEALO_SHOP_ID. AnythingMCP обменивает данные клиента на токен доступа сроком на один час и сам его обновляет.
4. Установите коннектор и запустите idealo_get_offer с SKU предложения, которое точно опубликовано: вы увидите предложение в том виде, в каком его хранит idealo.

Что он читает: одно предложение за раз по SKU, в том виде, в каком его хранит idealo: название, цену и прежнюю цену, URL, EAN и артикулы производителя, бренд, стоимость доставки и оплаты, срок доставки, энергетические этикетки, состояние товара и остальные поля предложения. В Partner Web Service нет вызова для списка, поэтому ИИ спрашивает у вас SKU.

Только предложения, без заказов: Partner Web Service 2.0 это интерфейс, через который размещённые на idealo магазины ведут предложения по одному, вместо товарного фида или вместе с ним, для idealo.de, .at, .fr, .it, .es и .co.uk. Сервис оформления покупки (Direktkauf) и его API заказов idealo закрыл в 2023 году, поэтому заказы по-прежнему приходят через ваш собственный магазин.

Как записываются предложения: цены передаются строками ровно с двумя знаками после точки, например "177.99"; прежняя цена это цена до снижения. Новому предложению нужны как минимум SKU, название, цена, URL, одна стоимость доставки (например, "DHL": "4.90") и одна стоимость оплаты (например, "PAYPAL": "0.00"); EAN, артикулы производителя и бренд помогают idealo сопоставить товар. idealo_upsert_offer заменяет предложение целиком, поэтому каждое не переданное поле удаляется; idealo_update_offer меняет только переданные поля, но не может изменить стоимость доставки и оплаты, размер, цвет, пол, материал и динамические атрибуты товара, а поля-списки вроде EAN или изображений нужно передавать полностью. SKU может содержать только буквы, цифры, подчёркивания, точки и дефисы.

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

Отключено при установке: idealo_upsert_offer, idealo_update_offer и idealo_delete_offer. У idealo нет тестовой среды: каждая запись сразу меняет ваши живые предложения в сравнении цен, а снятое предложение исчезает с idealo. Включайте только те, которыми ИИ может пользоваться. Удалить все предложения разом намеренно нельзя.

Ограничения: idealo ограничивает число вызовов; текущий лимит виден в заголовке X-RateLimit-Limit. После 429 ИИ ждёт, прежде чем повторить попытку, и меняет предложения по одному.

Частые ошибки: 401 означает, что client ID или secret неверны или токен отклонён: проверьте их в Shop settings → API clients. 403 означает, что у API-клиента нет права на Partner Web Service или shop ID не ваш. 404 означает, что такого предложения в этом магазине нет (неверный SKU или shop ID). 400 перечисляет fieldErrors с полем и причиной, например цену без двух знаков после точки.

Коннектор не читает и не обрабатывает заказы, не выводит список всех ваших предложений, не меняет товарный фид и не удаляет все предложения разом.

Шаг 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 — Добавьте коннектор в Muse

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.

1. В Muse открой Settings → Connectors и выбери Add custom connector.
2. Вставь URL MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
4. В чате попроси Muse о том, для чего нужны инструменты idealo.

Настроить коннектор можно и из чата: в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.

Доступные инструменты

Примеры запросов

• «Как сейчас выглядит на idealo моё предложение с SKU KS-4711: цена, срок доставки и стоимость доставки?»
• «Снизь цену для SKU TV-55-OLED до 899,00 евро и покажи 999,00 евро как прежнюю цену.»
• «Измени срок доставки для SKU BOSCH-GSR18 на 1-3 рабочих дня.»
• «Создай на idealo новое предложение для SKU LAMP-200 с EAN 4006381333931: 49,90 евро, доставка DHL за 4,90 евро и PayPal без доплаты.»
• «Сними с idealo предложение с SKU KS-4711, товар закончился.»

FAQ

Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде: в вебе, в приложениях для iOS и Android и в WhatsApp.

Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT