Подключить ABOUT YOU MCP к Gemini CLI

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

ABOUT YOU + Gemini

API Seller Center ABOUT YOU для партнеров рынка: заказы, доставка с отслеживанием, счета и упаковочные листы, продукты с статусом одобрения, запасы, цены, категории и атрибуты, бренды и отчеты. API-ключ.

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

Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:

ABOUT_YOU_API_KEY

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

Настройка занимает около 2 минут.

1. Войди в Seller Center ABOUT YOU как пользователь Admin. Пользователи с правами участника не могут создавать API-ключи.
2. Открой Настройки, затем API-ключи, и нажми + Добавить.
3. Введи метку, при желании дату истечения, и нажми Добавить ключ.
4. Сразу скопируй ключ в ABOUT_YOU_API_KEY: Seller Center показывает его только один раз.

Ключ отправляется в заголовке X-API-Key. Для тестовых данных создай песочницу в Настройки, Песочница, Создать песочницу: у нее есть свой API-ключ по тому же адресу, продукты выходят в продажу без одобрения, а тестовые заказы поступают через кнопку Получить заказы на странице заказов.

С чего начать: about_you_list_orders с order_status open показывает, что ждет отправки. about_you_list_products показывает твой каталог с запасами и ценами. about_you_list_countries — это дешевый вызов, который подтверждает, что ключ работает.

Заказы и доставка: about_you_list_orders возвращает элементы каждого заказа с их id; инструменты отправки, отмены и возврата принимают эти идентификаторы товаров, а не SKU. Отправляй с помощью about_you_ship_order_items (ключ перевозчика из about_you_list_carriers, ключ отслеживания отправления и ключ отслеживания возврата обязательны). about_you_get_delivery_document возвращает упаковочный лист заказа дропшиппинга, а about_you_get_order_invoices — счета для клиентов, оба в виде файлов. about_you_cancel_order_items и about_you_return_order_items установлены выключенными: отмененный товар не может быть отправлен позже, а пометка товара как возвращенного автоматически делает возврат клиенту. Проверь возврат в течение 24 часов с момента получения; не регистрируй тот, который ты отклоняешь.

Асинхронные записи: каждая запись отвечает сразу с batchRequestId и обрабатывается в фоновом режиме. Читай результат с помощью about_you_get_batch_result (выбери соответствующий result_type) до тех пор, пока статус не станет завершенным или неудачным; каждый элемент содержит успех и ошибки. Результаты хранятся 7 дней. Один и тот же полезный груз, отправленный дважды за короткое время, возвращает тот же идентификатор партии и не обрабатывается повторно.

Продукты: одна строка — это один SKU (размер цвета стиля). Создавай или изменяй их с помощью about_you_upsert_products, используя идентификаторы из about_you_list_categories, about_you_list_category_attribute_groups и about_you_list_brands, затем отправь стиль на одобрение с помощью about_you_publish_product. Статусы: черновик, ожидает одобрения (заблокирован, пока ABOUT YOU рассматривает), отклонен (причины в about_you_list_rejected_products), ожидает активации, активен, неактивен и проблема (активный продукт, который стал недействительным; он возвращается в активный статус после исправления). about_you_update_product_status (также черновик и неактивен) и about_you_delete_product установлены выключенными.

Запасы и цены: about_you_update_stock и about_you_update_prices принимают до 1000 строк за вызов и всегда применяются, в отличие от запасов или цен, отправленных через обновление продукта. Цены на продукты — десятичные числа в валюте страны (49.99), в то время как суммы заказов — целые числа в наименьшей единице (4999 = 49.99 EUR). Отправляй currency с каждой ценой.

Отчеты и вебхуки: about_you_list_reports и about_you_download_report (отчеты о запасах и движении товаров на складах ABOUT YOU, DAC7), about_you_list_webhooks (только для чтения).

Пагинация: списки возвращают items и pagination. Заказы и продукты должны быть разбиты на страницы с cursor = pagination.next_cursor; параметр page все еще работает, но устарел. Меньшие списки используют page и per_page (максимум 100).

Типы выполнения: dropshipping означает, что ты отправляешь; fulfillment_by_marketplace означает, что ABOUT YOU отправляет из собственного склада (FbAY), поэтому отправлять нечего, и для этих заказов нет документа доставки.

Ограничения по скорости (на конечную точку и на ключ): заказы 100 в минуту, отправка 200, отмена и возврат 50, запасы 1000, цены 200, список продуктов 1000, обновление продукта и статус 100, результаты партии 200, счета и отчеты 10. Заголовки X-RateLimit-Limit и X-RateLimit-Remaining показывают бюджет; 429 означает, что нужно подождать следующую минуту.

Ошибки: 400 и 401 отвечают JSON message. 404 по документу означает, что у заказа нет такого файла. Этот API не имеет вызова выплаты или платежа; единственное действие, которое приводит к возврату, — это регистрация возврата, которая отключена.

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

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты ABOUT YOU.

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

Примеры подсказок

• "Какие заказы ABOUT YOU открыты и ждут отправки?"
• "Какие из моих продуктов были отклонены ABOUT YOU и почему?"
• "Установи запас SKU AY-TSHIRT-WHT-M на 50."
• "Отправь позиции заказа 123456789 с DHL, отслеживание 003404341612345678 и возврат отслеживания 003404341698765432."
• "Скачай отчет о продажах за прошлый месяц."

Часто задаваемые вопросы

Где я могу получить API-ключ? В Seller Center ABOUT YOU, войдя как пользователь Admin: Настройки, API-ключи, + Добавить. Ключ показывается только один раз. Песочница в Настройках имеет свой собственный ключ для тестовых заказов.

Что это охватывает? Заказы и их позиции, доставка с отслеживанием, счета для клиентов и упаковочные листы, продукты с их статусом одобрения, запасы, цены, категории, атрибуты, бренды, результаты партий, отчеты и вебхуки.

Какие инструменты установлены выключенными? about_you_cancel_order_items, about_you_return_order_items, about_you_update_product_status и about_you_delete_product, потому что отмененный товар не может быть отправлен позже, а пометка товара как возвращенного автоматически делает возврат клиенту. Включай их на странице коннектора только если ИИ должен их использовать.

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

• Страница приземления коннектора
• Подключиться к Claude