Loja Integrada MCP 连接 Gemini CLI

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

Loja Integrada + Gemini

让你的 AI 经营 Loja Integrada 店铺：搜索商品、更新库存和价格、创建商品、类目和品牌、跟进订单、更改订单状态、添加物流单号并查询客户。使用官方 API v1。

前提条件

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

LOJA_INTEGRADA_API_KEY, LOJA_INTEGRADA_APP_KEY

步骤 1 — 获取凭证

两个密钥都到手后，设置大约需要 5 分钟，但应用密钥需要 5 到 10 个工作日才能拿到。你需要一个使用付费套餐的 Loja Integrada 店铺、它的店铺后台访问权限，以及 Loja Integrada 为集成签发的应用密钥（chave de aplicação）。

1. 在店铺后台打开 Configurações → Chave para API，点击 Cadastrar nova chave，把 20 位的密钥复制到 LOJA_INTEGRADA_API_KEY。只粘贴密钥本身，不要带 chave_api。API 密钥仅在付费套餐中提供（Loja Integrada 帮助）。
2. 通过这篇帮助文章中介绍的集成商表单，向 Loja Integrada 申请应用密钥（chave de aplicação）。在表单中填写调用 API 的 IP 地址：自托管安装就是你服务器的地址；在 AnythingMCP Cloud 上则是固定的 IPv4 地址 104.248.242.235，Cloud 的所有调用都从这个地址发出。连接器的设置页面也会显示这些出口地址。Loja Integrada 会在 5 到 10 个工作日内答复。
3. 把应用密钥（形如 dc6049f0-1234-... 的 UUID）填入 LOJA_INTEGRADA_APP_KEY。只粘贴密钥本身，不要带 aplicacao。
4. 安装连接器，用 loja_integrada_list_order_statuses 检查连接。

应用密钥只能从登记的 IP 地址使用：Loja Integrada 会拒绝来自未登记地址的调用。地址发生变化时（换新服务器、迁移到 Cloud 或从 Cloud 迁出），请在切换之前用同一个表单提交新的地址列表，以免调用开始失败。

Cloud 和自托管的方式相同：只有为应用密钥登记的 IP 地址不同。

两个密钥放在同一个请求头中：每次调用都会发送 Authorization: chave_api <API key> aplicacao <application key>，由 AnythingMCP 根据两个变量组装。本连接器不使用 Personal Token 登录（Authorization: Basic ...）。

限流：Loja Integrada 允许每个店铺每分钟 100 次请求，超出后返回 429。请让 AI 分页读取列表，而不是反复调用；遇到 429 时等一分钟。

ID 和引用：商品、类目、品牌和客户都有数字 ID（202591789）；订单通过订单号（numero，例如 164）指定。记录之间通过 /api/v1/categoria/15246059 这样的 URI（resource_uri 字段）相互引用，原样传入商品的 categorias、marca 和 pai。把 id_externo 设为 1 时，会按你自己的外部 ID 查找商品或价格。

分页、价格和日期：列表默认每页 20 条，最多 50 条，用 limit 和 offset 翻页，直到 meta.next 为 null；meta.total_count 是总数。价格以 BRL 计，以 "32.83" 这样的字符串返回。日期筛选使用 YYYY-MM-DD，时间可选。

商品、规格、库存和价格：带规格的商品由一个父商品（tipo atributo）和每个规格对应的子商品（tipo atributo_opcao，pai 指向父商品）组成；loja_integrada_list_grids 和 loja_integrada_get_grid 显示尺码、颜色等规格表的取值。价格和库存是单独的记录，在创建商品之后设置。库存是绝对数量而不是增减量，要在每个规格上分别设置。更新会替换整个商品，所以 AI 会先读取商品，再把所有字段重新发送：省略的字段可能会被清空。

常见错误：401 表示 Loja Integrada 拒绝了密钥：检查 LOJA_INTEGRADA_API_KEY、LOJA_INTEGRADA_APP_KEY，以及应用密钥是否已为连接器的 IP 地址登记。403 表示密钥已读取但访问被拒绝：调用来自未为应用密钥登记的地址。429 表示触发了限流。

可读取的内容：商品，包括 SKU、类型（普通商品、带规格的父商品或规格）、类目、品牌、尺寸和重量、NCM 和 GTIN、图片和规格表；库存，包括预留数量和可用数量；原价、促销价和成本价；类目、品牌以及规格表及其取值；订单，包括客户、账单地址和收货地址、商品明细、付款、带物流单号的发货、状态和金额，以及每笔订单的状态历史、店铺的订单状态和付款方式；客户，包括邮箱、CPF 或 CNPJ、电话和地址。

写入工具在安装时已开启：没有任何工具被关闭。连接器可以创建商品、类目和品牌，编辑商品，设置库存和价格，更改订单状态并添加物流单号，这些都会直接作用于你的线上店铺；更改状态可能会给买家发邮件，而“已取消”这类最终状态无法撤销。请在连接器页面关闭不需要的工具；AI 在每次更改前都会先征得你的确认。

不会删除任何数据：没有工具会删除数据或创建订单，连接器也不处理商品图片、优惠券、SEO、Webhook、发票（NF）、营销和 Enviali 物流面单。

步骤 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 现在可以调用 Loja Integrada 的工具。

可用工具

示例提示

• “SKU CAM-001 还有多少可用库存？原价和促销价是多少？”
• “列出本周仍在等待付款的订单。”
• “把 SKU CAM-001 的促销价设为 R$ 89.90，库存设为 40 件。”
• “把订单 164 标记为已发货，并添加物流单号 AA123456789BR。”
• “找到邮箱为 [email protected] 的客户，并列出她的订单。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude