Кратко
Запускай свой магазин на маркетплейсе Vertbaudet с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции и Германии; войди с помощью API-ключа магазина из своего личного кабинета продавца Vertbaudet.
Пошаговая настройка
Подключи Vertbaudet Marketplace к Meta Muse за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Vertbaudet Marketplace в пошаговой настройке и добавь свой MCP URL в Meta Muse. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Vertbaudet Marketplace
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди, кликни Connectors → Vertbaudet Marketplace, вставь свои учетные данные, создай API-ключ MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Маркетплейс Vertbaudet + Meta Muse
Запускай свой магазин на маркетплейсе Vertbaudet с помощью AI-агента: заказы, прием, отслеживание и доставка, инциденты, предложения с ценами и наличием, импорты, сообщения, возвраты, счета и транзакции. Маркетплейс работает во Франции и Германии; войди с помощью API-ключа магазина из своего личного кабинета продавца Vertbaudet.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
VERTBAUDET_API_KEY
Шаг 1 — Получи учетные данные
Страны: Франция и Германия. Свободные текстовые атрибуты продуктов для Германии должны быть написаны на немецком.
Кто может продавать: Vertbaudet выбирает бренды и ритейлеров с новыми, среднеценовыми или более дорогими детскими и материнскими товарами; свяжись с ними по электронной почте ([email protected]). Бизнес должен быть зарегистрирован в ЕС, отправлять товары во Францию из еврозоны и предлагать французский контент и обслуживание клиентов. Плата составляет 17% комиссии плюс 49,90 евро в месяц. Коннектор требует учетную запись продавца, которую уже открыл Vertbaudet.
Адрес продавца этого коннектора — это тот, который платформа назначает этому ритейлеру; ни один справочник продавца еще не называет его. Если твой личный кабинет продавца открыт по другому адресу, сообщи нам в чате, чтобы мы могли это исправить.
Настройка занимает около 5 минут.
- Войди в личный кабинет продавца Vertbaudet:
https://vertbaudetfr-prod.mirakl.net/login. - В личном кабинете открой свое имя пользователя (в правом верхнем углу) > Мои настройки пользователя > API-ключ и нажми Создать новый ключ (или скопируй существующий ключ). Вставь его в
VERTBAUDET_API_KEY. Ключ отправляется как есть в заголовкеAuthorization, безBearer. Генерация нового ключа делает старый недействительным, поэтому любой другой инструмент, использующий его, перестает работать. - Оставь
VERTBAUDET_SHOP_IDпустым. Только если твой пользователь управляет несколькими магазинами на Vertbaudet, установиVERTBAUDET_SHOP_IDна числовой идентификатор магазина, с которым должен работать этот коннектор (показан на панели управления личного кабинета рядом с Идентификатором или ID магазина, и возвращается какshop_idс помощьюvertbaudet_get_account). Без него используется твой магазин по умолчанию. - Установи и запусти
vertbaudet_get_account: он возвращает магазин, к которому принадлежит ключ.
С чего начать: vertbaudet_get_account показывает магазин, связанный с ключом (идентификатор, имя, состояние, валюта и каналы). Для повседневной работы используй vertbaudet_list_orders с order_state_codes=WAITING_ACCEPTANCE, vertbaudet_list_offers для цен и наличия и vertbaudet_list_threads для сообщений, ожидающих ответа.
Продукты и конкурирующие предложения: vertbaudet_get_products ищет продукты в каталоге Vertbaudet по EAN или другой ссылке и возвращает SKU продукта на маркетплейсе; vertbaudet_list_product_offers перечисляет предложения каждого магазина для заданных продуктов, начиная с лучшей цены, примерно 5 вызовов в минуту.
Рабочий процесс заказов: новый заказ ожидает в WAITING_ACCEPTANCE. vertbaudet_accept_order принимает (или отказывает) каждую строку; после списания с клиента заказ переходит в SHIPPING. Затем vertbaudet_update_tracking сохраняет перевозчика и номер отслеживания (коды перевозчиков берутся из vertbaudet_list_carriers), а vertbaudet_ship_order подтверждает отправку (SHIPPED). Поздние состояния — это TO_COLLECT, RECEIVED, CLOSED, REFUSED и CANCELED. Используй vertbaudet_list_orders с order_state_codes=WAITING_ACCEPTANCE для повседневного списка дел и has_incident=true для открытых инцидентов; vertbaudet_resolve_incident закрывает инцидент по одной строке заказа, как только он решен. Документы, прикрепленные к заказам (накладные, этикетки, счета клиентов), перечисляются с помощью vertbaudet_list_order_documents.
Записи: сначала подтверждай. vertbaudet_accept_order, vertbaudet_update_tracking, vertbaudet_ship_order, vertbaudet_resolve_incident, vertbaudet_accept_return, vertbaudet_receive_return, vertbaudet_update_offers, vertbaudet_reply_thread, vertbaudet_create_order_thread и vertbaudet_import_products действуют на живом маркетплейсе. Перед каждым вызовом показывай пользователю, что изменится (идентификатор заказа и строки, номер отслеживания, SKU предложения с старой и новой ценой или наличием, текст сообщения и получатели) и жди согласия. Отказ от строки заказа отменяет ее навсегда. Никакой инструмент здесь не возвращает деньги, не отменяет заказы и не перемещает деньги; делай это в личном кабинете. vertbaudet_import_offers может удалять предложения (режим REPLACE удаляет каждое предложение, отсутствующее в файле), поэтому он установлен выключенным.
Обновление предложений (цен и наличия): vertbaudet_update_offers (OF24) заменяет все предложение. Каждое поле, которое ты оставляешь пустым, сбрасывается: отсутствующее quantity становится 0, отсутствующая discount или description удаляется. Всегда сначала читай предложение (vertbaudet_get_offer или vertbaudet_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; изменение применяется асинхронно, поэтому проверь его с помощью vertbaudet_get_offer_import перед повторным чтением предложения. Условные коды для state_code берутся из vertbaudet_list_offer_conditions, коды логистического класса из vertbaudet_list_logistic_classes.
Импорт файлов: vertbaudet_import_products (P41) и vertbaudet_import_offers (OF01) принимают URL CSV, XLSX или XML файла в формате, который требует Vertbaudet; коннектор загружает его и загружает в Vertbaudet. Отслеживай их с помощью vertbaudet_list_product_imports / vertbaudet_get_product_import и vertbaudet_list_offer_imports / vertbaudet_get_offer_import.
Возвраты: vertbaudet_list_returns (RT11) перечисляет запросы на возврат. Где Vertbaudet позволяет магазину решать, vertbaudet_accept_return принимает или отказывает в WAITING_ACCEPTANCE, а vertbaudet_receive_return подтверждает, что товары прибыли. Возвраты остаются в личном кабинете.
Сообщения: vertbaudet_list_threads перечисляет разговоры (фильтруй с помощью entity_type=MMP_ORDER и entity_id=<order id> для одного заказа; entity_id без entity_type отклоняется), vertbaudet_get_thread читает один с его сообщениями, vertbaudet_reply_thread отвечает (получатель CUSTOMER или OPERATOR, который является Vertbaudet) и vertbaudet_create_order_thread открывает новый разговор по заказу. Коды причин для тем берутся из vertbaudet_list_reasons; оставь locale пустым, если не знаешь, что маркетплейс поддерживает этот язык (неактивная локаль отвечает 400).
Деньги: vertbaudet_list_invoices (IV01) перечисляет бухгалтерские документы, которые Vertbaudet выдает магазину, а vertbaudet_list_transactions (TL02) — строки транзакций (продажи, комиссии, возвраты, выплаты). Если Vertbaudet использует Enhanced Seller Invoicing, IV01 не возвращает новых документов; используй vertbaudet_list_document_requests (DR11) и транзакции тогда.
Весь каталог: чтобы прочитать каждое предложение (проверка наличия или цены по всему каталогу, подсчет предложений), начни экспорт с помощью vertbaudet_export_offers, опрашивай vertbaudet_get_offer_export_status примерно раз в минуту, пока он не станет COMPLETED, и читай файлы один за другим с помощью vertbaudet_get_offer_export_file; include_fields оставляет только нужные столбцы. Полный экспорт разрешен раз в день; для того, что изменилось с тех пор, передай last_request_date (дифференциальный экспорт, максимум раз в минуту). Не проходи через каждое предложение с помощью vertbaudet_list_offers: он предназначен для нескольких предложений за раз и отвечает 429, когда проходит через большой каталог.
Несколько магазинов: каждый инструмент принимает необязательный shop_id. Пользователь, который управляет несколькими магазинами на этом маркетплейсе (агентство или один магазин на страну), может работать со всеми ними с одной установкой: передавай идентификатор магазина в каждом вызове и проверяй, какой это магазин, с помощью vertbaudet_get_account и того же shop_id. Без shop_id вызов использует VERTBAUDET_SHOP_ID, или магазин по умолчанию пользователя, когда он пуст. Спроси пользователя о идентификаторах их магазинов; личный кабинет показывает их.
Справочные списки: vertbaudet_list_channels (страничные сайты), vertbaudet_list_carriers, vertbaudet_list_shipping_zones, vertbaudet_list_shipping_methods и vertbaudet_list_logistic_classes меняются редко; читай их один раз за разговор.
Пагинация: заказы, предложения, счета и импорты продуктов пагинируются с помощью max (максимум 100) и offset. Темы, возвраты, транзакции, запросы документов и импорты предложений возвращают next_page_token; передай его как page_token, чтобы получить следующую страницу (все другие фильтры тогда игнорируются), пока он не исчезнет.
Даты в формате ISO 8601, например, 2026-10-01T00:00:00Z; ответы в UTC.
Ограничения по частоте: У каждого API есть свои ограничения, и Vertbaudet может их ужесточить. Перечисление предложений и заказов предназначено для интерактивного использования, импорты продуктов и предложений — максимум каждые 15 минут, vertbaudet_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 — Добавь коннектор в Muse
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.
- В Muse открой Settings → Connectors и выбери Add custom connector.
- Вставь URL MCP-сервера
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
- В чате попроси Muse о том, для чего нужны инструменты
Маркетплейс Vertbaudet.
Настроить коннектор можно и из чата — в вебе, в приложениях для 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 не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
vertbaudet_get_account | Читает магазин, стоящий за API-ключом на этом маркетплейсе (A01): идентификатор магазина и имя, состояние, каналы, валюта, рейтинг и процент одобрения, контакт… |
vertbaudet_list_orders | Перечисляет заказы (OR11) с их строками, клиентом, адресом доставки, ценами, состоянием и инцидентами. Фильтруй по состоянию (например, WAITING_ACCEPTANCE для… |
vertbaudet_list_offers | Перечисляет предложения магазина (OF21): SKU, продукт, цена и скидка, все цены по каналам, количество на складе, состояние, время доставки и есть ли… |
vertbaudet_get_offer | Читает одно предложение полностью по его идентификатору предложения (OF22): каждое ценовое поле, скидка, количество, состояние, логистический класс, время доставки и пользовательские… |
vertbaudet_list_offer_conditions | Перечисляет условия предложения (OF61), которые принимает маркетплейс, например, новые или б/у, с кодом, который нужно указать в state_code при обновлении предложений |
vertbaudet_list_offer_imports | Перечисляет импорты и обновления предложений (OF04), из файлов и из vertbaudet_update_offers: статус (WAITING, RUNNING, COMPLETE, FAILED), строки… |
vertbaudet_get_offer_import | Читает статус одного импорта предложения или обновления предложения (OF02) по его import_id, как возвращается vertbaudet_update_offers или… |
vertbaudet_export_offers | Начинает экспорт всех предложений магазина в виде файлов (OF52), способ прочитать весь каталог (каждый SKU с ценой и наличием) вместо… |
vertbaudet_get_offer_export_status | Статус экспорта предложения, начатого с vertbaudet_export_offers (OF53): PENDING, COMPLETED или FAILED (с error.code и error.detail)… |
vertbaudet_get_offer_export_file | Читает один файл завершенного экспорта предложения (OF54): предложения с их SKU, продуктом, количеством, ценами и другими экспортированными полями, как… |
vertbaudet_list_product_imports | Перечисляет импорты продуктов (P51) с их статусом (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), количество трансформаций и… |
vertbaudet_get_product_import | Читает статус одного импорта продукта (P42) по его import_id: статус импорта, причина, количество трансформаций и детали интеграции… |
vertbaudet_get_products | Ищет продукты в каталоге маркетплейса по их идентификаторам (P31), например, EAN, и получает SKU продукта на маркетплейсе, название и категорию.… |
vertbaudet_list_product_offers | Перечисляет предложения каждого магазина для заданных продуктов (P11), отсортированные по лучшей цене, чтобы сравнить свою цену с конкурентами. Укажи product_ids… |
vertbaudet_list_threads | Перечисляет темы сообщений (M11) с клиентами и Vertbaudet: тема, связанный заказ или предложение, участники, дата последнего сообщения и с какого времени… |
vertbaudet_get_thread | Читает одну тему сообщения (M10) со всеми ее сообщениями, отправителями, получателями, вложениями и связанным заказом или предложением |
vertbaudet_list_returns | Перечисляет запросы на возврат (RT11) с их состоянием, строками возврата, причиной, RMA, отслеживанием и связанным заказом. Фильтруй по состоянию, заказу или дате.… |
vertbaudet_list_reasons | Перечисляет коды причин маркетплейса (RE01): инциденты, отмены, возвраты и причины сообщений, с их метками и тем, может ли магазин… |
vertbaudet_list_carriers | Перечисляет перевозчиков, известных маркетплейсу (SH21), с их кодом, меткой и URL для отслеживания. Используй код как carrier_code в… |
vertbaudet_list_invoices | Перечисляет бухгалтерские документы, которые Vertbaudet выдает магазину (IV01): счета и кредитные ноты с периодом, итогами с налогом и без… |
vertbaudet_list_transactions | Перечисляет строки транзакций магазина (TL02): суммы заказов, доставка, комиссии, возвраты, ручные кредиты и выплаты, с суммой, типом… |
vertbaudet_list_document_requests | Перечисляет запросы бухгалтерских документов (DR11), используемые, когда Vertbaudet использует Enhanced Seller Invoicing: счета и кредитные ноты, которые Vertbaudet или… |
vertbaudet_list_order_documents | Перечисляет документы, прикрепленные к одному или нескольким заказам (OR72): накладные, этикетки для доставки, счета клиентов и другие файлы, с id, файлом… |
vertbaudet_list_channels | Перечисляет каналы продаж маркетплейса (CH11), обычно по одному на страну, с кодом и меткой. Используй коды как channel_codes в… |
vertbaudet_list_shipping_zones | Перечисляет активные зоны доставки маркетплейса (SH11) с кодом и меткой, например, материковая Франция или Корсика. Меняется редко: вызывай это… |
vertbaudet_list_shipping_methods | Перечисляет активные методы доставки маркетплейса (SH12), например, стандартный, экспресс или самовывоз, с кодом, меткой, есть ли номер отслеживания… |
vertbaudet_list_logistic_classes | Перечисляет логистические классы маркетплейса (SH31), размеры или весовые категории, которые определяют цены на доставку, с кодом и меткой. Используй код как… |
vertbaudet_accept_order | Принимает или отказывает в строках заказа, ожидающего принятия (OR21). Каждая строка заказа должна быть перечислена. Отказ от строки отменяет ее… |
vertbaudet_update_tracking | Устанавливает перевозчика и номер отслеживания заказа (OR23). Укажи carrier_code из vertbaudet_list_carriers, или carrier_name с carrier_url… |
vertbaudet_ship_order | Подтверждает, что заказ в состоянии SHIPPING был отправлен (OR24); он переходит в SHIPPED, и клиент уведомляется. Сначала установи отслеживание с… |
vertbaudet_update_offers | Создает или обновляет предложения, включая цену и наличие (OF24). Полностью заменяет каждое предложение: каждое поле, оставленное пустым, сбрасывается (отсутствующее… |
vertbaudet_reply_thread | Отвечает в теме сообщения (M12) клиенту или Vertbaudet. Сообщение доставляется сразу и не может быть отозвано: покажи пользователю… |
vertbaudet_create_order_thread | Начинает новую тему сообщения по заказу (OR43) с клиентом, Vertbaudet или обоими. Сообщение доставляется сразу: покажи пользователю… |
vertbaudet_resolve_incident | Отмечает открытый инцидент по одной строке заказа как решенный (OR64), как только проблема клиента решена. reason_code должен быть INCIDENT_CLOSE… |
vertbaudet_accept_return | Принимает или отказывает в запросе на возврат в WAITING_ACCEPTANCE (RT21). Только когда Vertbaudet обрабатывает возвраты в личном кабинете продавца и оставляет… |
vertbaudet_receive_return | Подтверждает, что товары принятого возврата прибыли на твой склад (RT25). Возврат переходит в RECEIVED. Действует на живом маркетплейсе… |
vertbaudet_import_products | Отправляет файл продукта на маркетплейс (P41), чтобы создать или обогатить продукты в его каталоге. file_url — это адрес CSV, XLSX или XML… |
vertbaudet_import_offers | Импортирует файл предложений (OF01), чтобы создать, обновить или удалить предложения оптом. Режим REPLACE удаляет каждое предложение, которое отсутствует в файле, и… |
Примеры подсказок
- "Какие заказы Vertbaudet ждут моего подтверждения, и из Франции или Германии?"
- "Установи наличие моего спального мешка для младенцев SKU VB-SLP-6M на 50 и сохрани цену."
- "Добавь отслеживание Colissimo 6A90123456789 к заказу 5501234-A и подтверди отправку."
- "Какие запросы на возврат ждут моего решения?"
- "Покажи счета, которые Vertbaudet выдал мне в этом месяце."
Часто задаваемые вопросы
Где я могу получить API-ключ Vertbaudet, и что если я управляю несколькими магазинами? В личном кабинете продавца Vertbaudet: твое имя пользователя (в правом верхнем углу), Мои настройки пользователя, API-ключ, затем Создать новый ключ (или скопировать существующий ключ). Генерация нового ключа делает старый недействительным. Ключ принадлежит твоему пользователю, а не одному магазину: с несколькими магазинами на Vertbaudet установи VERTBAUDET_SHOP_ID на магазин, который коннектор должен использовать по умолчанию, или попроси AI передавать shop_id в каждом вызове и работать со всеми твоими магазинами с одной установкой. Без этого или того используется твой магазин по умолчанию.
Кто может продавать на Vertbaudet и какие страны он охватывает? Vertbaudet выбирает бренды и ритейлеров с новыми, среднеценовыми или более дорогими детскими и материнскими товарами; свяжись с ними по электронной почте ([email protected]). Бизнес должен быть зарегистрирован в ЕС, отправлять товары во Францию из еврозоны и предлагать французский контент и обслуживание клиентов. Плата составляет 17% комиссии плюс 49,90 евро в месяц. Коннектор охватывает Францию и Германию. Свободные текстовые атрибуты продуктов для Германии должны быть написаны на немецком. Адрес продавца этого коннектора — это тот, который платформа назначает этому ритейлеру; ни один справочник продавца еще не называет его. Если твой личный кабинет продавца открыт по другому адресу, сообщи нам в чате, чтобы мы могли это исправить.
Может ли он проверить мой весь каталог, и может ли он отменить заказы, вернуть деньги или удалить предложения? Да, для каталога: для проверки наличия или цены по каждому предложению AI начинает экспорт с помощью vertbaudet_export_offers, ждет, пока vertbaudet_get_offer_export_status не сообщит о завершении, и читает файлы с помощью vertbaudet_get_offer_export_file (полный экспорт раз в день, изменения с даты раз в минуту). Никакой инструмент не возвращает деньги или отменяет заказ; делай это в личном кабинете Vertbaudet. Отказ от строки при принятии заказа отменяет ее навсегда, поэтому AI показывает тебе каждую запись и ждет согласия. vertbaudet_import_offers установлен выключенным, потому что его режим REPLACE удаляет каждое предложение, отсутствующее в файле; включай его на странице коннектора только если AI должен его использовать.
Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.
Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.
Следующие шаги
Это руководство помогло?