Как подключить Flipkart Seller к Gemini через MCP

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

Flipkart Seller + Gemini

Flipkart Marketplace Seller API v3 для вашего собственного аккаунта продавца: листинги с обновлением цен и остатков, отправления заказов (поиск, подробности, этикетки и счета, готовность к отгрузке, отмена, передача курьеру и манифест) и возвраты.

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

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

FLIPKART_APP_ID, FLIPKART_APP_SECRET

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

Настройка занимает около 5 минут. Нужен аккаунт продавца Flipkart.

1. Войдите в Flipkart Seller Hub (https://seller.flipkart.com) и откройте Manage Profile > Developer Access.
2. Нажмите Create New Access, задайте приложению имя и описание и отправьте. Flipkart покажет Application ID и Application Secret. Приложение self access предназначено только для вашего собственного аккаунта продавца; не передавайте его партнёру.
3. Вставьте их в FLIPKART_APP_ID и FLIPKART_APP_SECRET.
4. Установите коннектор и запустите flipkart_seller_search_listings, чтобы проверить его.

Коннектор входит через OAuth2 client credentials: он запрашивает токен со scope Seller_Api, передавая id и secret приложения по HTTP Basic, и запрашивает новый до истечения срока действия или после ответа 401.

Листинги: ИИ постранично проходит все листинги (500 на страницу) с id листинга, id товара (FSN) и SKU или читает их по 20 с названием, статусом, вертикалью, ценами и размерами. Для не более чем 10 SKU он читает подробности: MRP и цену продажи, налог, статус, профиль исполнения, SLA отгрузки, упаковки, остаток по каждой локации и заказы, которые ещё нужно выполнить.

Цены и остатки: flipkart_seller_update_price и flipkart_seller_update_inventory меняют один SKU, и им нужен его id товара, а для остатка ещё и id локации. Они сразу меняют то, что видят покупатели, поэтому ИИ сначала сверяет с вами SKU и новые значения. Ответ 200 всё равно может содержать status: failure для SKU, и тогда ИИ читает причину.

Заказы (отправления): отправление объединяет то, что упаковывается и передаётся вместе. ИИ ищет отправления до отгрузки (APPROVED, PACKING_IN_PROGRESS, PACKED, FORM_FAILED, READY_TO_DISPATCH), после отгрузки (SHIPPED, DELIVERED, PICKUP_COMPLETE) или отменённые, по 20 на страницу, и читает позиции заказа, цены, даты, флаг удержания, адреса, курьера и трек-номер. Поиск охватывает не более 5 000 отправлений, а заказы Flipkart Assured в него не входят.

Обработка нового заказа: для отправления APPROVED, которое не на удержании и у которого прошла дата dispatch-after, ИИ формирует этикетку и счёт, скачивает их одним PDF и отмечает отправление как готовое к отгрузке, что бронирует курьера. Перед забором он читает число отправлений к передаче по каждому курьеру с одноразовым кодом и скачивает PDF-манифест для одного курьера. Эти действия отвечают по каждому отправлению SUCCESS или FAILURE, даже если HTTP-статус равен 200.

Возвраты: возвраты от покупателей и курьерские возвраты (недоставленные отправления) по дате создания или изменения, по 25 на страницу, со статусом, причиной и трек-номером, либо по id возвратов или трек-номерам.

Отключено при установке: flipkart_seller_cancel_shipments. Отмены вредят рейтингу продавца и могут привести к блокировке аккаунта или локации, поэтому администратор включает этот инструмент осознанно, и ИИ использует его, только когда вы об этом просите.

Форматы: даты в ISO 8601, в IST, если часовой пояс не указан. Суммы в INR. Id заказов начинаются с OD, id листингов с LST, id локаций с LOC; fsn содержит id товара Flipkart, а sku ваш собственный. Этикетки, счета и манифест приходят PDF-файлами.

Частые ошибки: 401 означает истёкший или отклонённый токен (проверьте id и secret приложения), 400 или 422 неверный запрос с кодом вроде INVALID_REQUEST_PAGE_SIZE или INVALID_DATE_FORMAT, 403 id, принадлежащий другому продавцу, а 5xx проблему на стороне Flipkart, например DEPENDENT_SYSTEM_CALL_FAILED, и такой запрос стоит повторить позже.

Коннектор не создаёт и не редактирует содержимое листингов и не охватывает отгрузку и возвраты self ship, листинги Flipkart Quick, отчёты и уведомления о заказах.

Шаг 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 теперь может вызывать инструменты Flipkart Seller.

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

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

• «Какие отправления одобрены и должны быть отгружены сегодня?»
• «Сформируй этикетки для всех одобренных отправлений, которые не на удержании, и дай мне PDF.»
• «Какие цена и остаток у SKU TSHIRT-BLU-M в каждой локации?»
• «Установи цену продажи SKU TSHIRT-BLU-M 499 INR. Сначала покажи текущую цену.»
• «Выведи возвраты от покупателей, созданные на этой неделе, с их причинами.»

FAQ

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

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

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