如何通过 MCP 将 Flipkart Seller 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Flipkart Seller、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Flipkart Seller + Gemini

面向你自己卖家账户的 Flipkart Marketplace Seller API v3：商品及其价格和库存更新，订单货件（搜索、详情、面单和发票、待发货、取消、交接和交接清单）以及退货。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

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 application）仅限你自己的卖家账户使用；不要分享给合作伙伴。
3. 把它们粘贴到 FLIPKART_APP_ID 和 FLIPKART_APP_SECRET。
4. 安装连接器并运行 flipkart_seller_search_listings 进行检查。

连接器通过 OAuth2 客户端凭证登录：它以 HTTP Basic 发送应用 ID 和 secret，请求权限范围为 Seller_Api 的令牌，并在令牌过期前或收到 401 后请求新令牌。

商品：AI 可以分页浏览所有商品（listing，每页 500 条），获取 listing ID、产品 ID（FSN）和 SKU，或者每次读取 20 条，包含标题、状态、品类（vertical）、价格和尺寸。对于最多 10 个 SKU，它可以读取详情：MRP 和售价、税、状态、履约配置、发货 SLA、包裹、各地点的库存以及尚待履约的订单。

价格和库存：flipkart_seller_update_price 和 flipkart_seller_update_inventory 修改单个 SKU，需要其产品 ID，修改库存时还需要地点 ID。它们会立即改变买家看到的内容，因此 AI 会先与你确认 SKU 和新值。即使返回 200，该 SKU 的结果仍可能是 status: failure，AI 会读取原因。

订单（货件）：货件是指一起打包和交接的内容。AI 可以搜索发货前（APPROVED、PACKING_IN_PROGRESS、PACKED、FORM_FAILED、READY_TO_DISPATCH）、发货后（SHIPPED、DELIVERED、PICKUP_COMPLETE）或已取消的货件，每页 20 条，并读取订单项、价格、日期、暂扣标志、地址、快递公司和运单号。搜索最多覆盖 5,000 个货件，且不包括 Flipkart Assured 订单。

处理新订单：对于状态为 APPROVED、未被暂扣且已过最早发货日期的货件，AI 会生成面单和发票，将它们合并为一个 PDF 下载，并将货件标记为待发货，这会预约快递公司。取件前，它会读取每家快递公司的交接数量及一次性验证码，并下载某家快递公司的交接清单（manifest）PDF。这些操作会按货件返回 SUCCESS 或 FAILURE，即使 HTTP 状态为 200 也是如此。

退货：客户退货和快递退货（未送达的货件），按创建或修改日期查询，每页 25 条，包括状态、原因和运单号，也可以按退货 ID 或运单号查询。

安装时关闭：flipkart_seller_cancel_shipments。取消会损害卖家评分，并可能导致账户或某个地点被暂停，因此由管理员有意开启此工具，且 AI 只在你要求时才使用它。

格式：日期为 ISO 8601，未指定时区时为 IST。金额以 INR 表示。订单 ID 以 OD 开头，listing ID 以 LST 开头，地点 ID 以 LOC 开头；fsn 是 Flipkart 的产品 ID，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 — 安装 adapter

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 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 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