Как подключить Fruugo к Claude через MCP

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

Fruugo + Claude

Продавайте на маркетплейсе Fruugo через AI-агента: загрузка заказов с позициями, ценами для покупателя, адресом доставки и отправками, а также наличие и остатки ваших SKU. Подтверждение и отметка отправки заказов включены, но при установке отключены.

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

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

FRUUGO_USERNAME, FRUUGO_PASSWORD

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

Настройка занимает около 2 минут. Нужны аккаунт продавца Fruugo и пользователь Fruugo Retailer Portal.

1. Войдите в Fruugo Retailer Portal на retailer.fruugo.com. Fruugo рекомендует отдельного пользователя портала для интеграции, поэтому по возможности создайте его для AnythingMCP.
2. Укажите имя этого пользователя портала в FRUUGO_USERNAME, а его пароль в FRUUGO_PASSWORD. Fruugo проверяет их через HTTP Basic при каждом вызове.
3. Установите коннектор и запустите fruugo_download_orders с датой from несколько дней назад.

Что он читает: заказы, которые Fruugo передал вам после своей проверки на мошенничество, с номером заказа и номером заказа покупателя, датами, статусом, языком покупателя, адресом и способом доставки, стоимостью доставки, позициями с идентификаторами товаров и SKU Fruugo и вашими, вашими ценами и ценами, которые покупатель видел в своей валюте, НДС, счётчиками единиц (ожидают, подтверждены, отправлены, отменены, заявлен возврат, возвращены) и отправками; а также ваши активные SKU с названием, наличием (INSTOCK, OUTOFSTOCK, NOTAVAILABLE) и остатком, если его передаёт ваш фид. Если налог взимал Fruugo, в заказе есть также налоговый номер и EORI Fruugo для таможенной декларации.

Не больше 60 дней за запрос: Fruugo отдаёт заказы за период не длиннее 60 дней; на более длинный отвечает 400 Time range specified is too long. За целый квартал ИИ делает два запроса и складывает результаты.

Статус заказа: PENDING означает новый и ждёт вас, PROCESSED хотя бы частично обработан, EXCEPTION значит, что Fruugo обрабатывает заказ вручную, вне API.

Остатки приходят из вашего фида: список остатков приходит страницами по 1000 SKU, и ИИ читает следующие страницы только при необходимости. Коннектор не меняет ни остатки, ни цены: они берутся из вашего товарного фида.

Отключено при установке: fruugo_confirm_order и fruugo_ship_order. Они действуют на реальные заказы покупателей: первый подтверждает ожидающий заказ, при желании с ожидаемой датой отправки; второй отмечает его отправленным с трек-кодом и ссылкой для отслеживания или хотя бы названием перевозчика, которые Fruugo передаёт покупателю. Оба работают для всего заказа или одной позиции. Администратор включает их осознанно, и даже тогда ИИ показывает заказ и что именно изменится и ждёт вашего согласия.

Частые ошибки: 401 означает неверное имя пользователя или пароль портала; проверьте их, войдя на retailer.fruugo.com. 400 объясняет проблему простым текстом, например период больше 60 дней или заказ не в нужном состоянии.

Коннектор не отменяет заказы и не оформляет возвраты, потому что и то и другое возвращает деньги покупателю: это делается в Retailer Portal. Объявления, цены и остатки он тоже не меняет.

Шаг 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 без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Fruugo, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

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

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

• «Какие заказы Fruugo за последние две недели ещё ожидают и их нужно отправить?»
• «Сколько заказов с Fruugo у нас было за последние 30 дней и в какие страны они ушли?»
• «Какие мои SKU сейчас отмечены на Fruugo как отсутствующие на складе?»
• «Покажи заказы прошлой недели: сколько покупатель заплатил в своей валюте и НДС по каждой позиции.»
• «В каких заказах с 1 сентября были отменены или возвращены товары?»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

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

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse