将 Cin7 Omni MCP 连接到 Gemini CLI

💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Cin7 Omni，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需 git clone，无需本地服务器。

Cin7 Omni + Gemini

Cin7 Omni (go.cin7.com) 通过 API v1 进行库存和订单管理：销售订单、报价、采购订单、信用票据、联系人、产品、每个分支的库存、分支、支付（只读）、库存调整、分支转移和用户。创建订单、采购订单、联系人和转移。API 用户名和密钥。

前提条件

请查看连接器中包含的完整设置说明（在选择连接器时可在应用内商店中查看）。此连接器所需的环境变量为：

CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

第一步 — 获取凭据

设置大约需要 3 分钟。你需要一个 Cin7 Omni 账户（在 go.cin7.com 登录）和一个可以添加 API v1 连接的管理员。连接器需要 API 用户名和 API 密钥。

Omni 还是 Core？ Cin7 销售两种不同的产品。Cin7 Omni（此连接器）在 go.cin7.com 登录，并具有 API v1 和 API 用户名及密钥。Cin7 Core（以前称为 DEAR Inventory）在 inventory.dearsystems.com 登录，并具有自己的 API，使用帐户 ID 和应用程序密钥：请使用 Cin7 Core 连接器。这两个 API 及其凭据不可互换。

1. 在 Cin7 Omni 中打开用户菜单，然后 Settings → Integrations & API → API v1。
2. 将页面顶部显示的 API Username 复制到 CIN7_OMNI_API_USERNAME。
3. 点击 Add New API Connection，给它命名并将其 API key 复制到 CIN7_OMNI_API_KEY。Regenerate Key 用于替换丢失的密钥。
4. 在 Permissions 下勾选 AI 应该看到的每个资源的读取权限，以及写工具所需资源的创建或更新权限，然后点击 Save。没有权限的资源会返回 403。
5. 安装连接器。运行 cin7_omni_list_branches 检查连接：它会列出你的分支及其 ID。

云端和自托管的工作方式相同：凭据相同，并且没有重定向 URL 需要设置。连接器将用户名和密钥作为 HTTP Basic 认证发送。

从哪里开始：cin7_omni_list_branches 获取分支 ID，cin7_omni_list_sales_orders 获取最近的订单，cin7_omni_list_stock 获取每个分支的库存，cin7_omni_list_contacts 查找客户或供应商。

它读取什么：销售订单、报价和信用票据及其行项目；记录在订单上的支付；采购订单；产品及其选项（可销售的 SKU）及价格和类别；每个产品选项和分支的库存（可用、在手、开放销售、即将到来）；库存调整和分支转移；联系人和用户。

它写入什么：cin7_omni_create_sales_order，cin7_omni_update_sales_order（仅头部字段，如阶段、跟踪代码和交付说明），cin7_omni_create_purchase_order，cin7_omni_create_contact，cin7_omni_update_contact 和 cin7_omni_create_branch_transfer 被启用。新的销售订单会被批准，除非 AI 将其创建为草稿；采购订单和转移会被保存为草稿，除非被批准。转移的发货和接收在 Cin7 中进行。

安装时关闭：cin7_omni_create_adjustment（在一个分支中创建库存调整）。已批准的调整会同时更改在手库存和库存价值。如果 AI 应该使用它，请在连接器页面上启用；AI 会要求你确认每个更改。

检查每次写入的响应：Cin7 返回 HTTP 200，并附带 {index, success, id, code, errors} 的列表，即使它拒绝了记录。AI 在报告写入完成之前会检查 success 和 errors。

支付为只读：连接器从不记录、修改或删除支付，也不发货、开票或作废订单。

过滤：where 对记录的字段使用 SQL 风格的条件，而不是其行项目。字符串和日期用单引号括起来，数字保持裸露：modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3，reference LIKE 'SO-10%'，id IN (21,24)。日期为 UTC，格式为 yyyy-MM-ddTHH:mm:ssZ。fields 修剪响应（id,reference,total,lineItems(code,qty)），这有助于处理订单列表，因为它们很大。

分页：page 从 1 开始，rows 最多为 250（默认 50，订单列表为 25）。AI 会请求下一页，直到返回空页。

速率限制：Cin7 Omni 每个账户允许每秒 3 次调用，每分钟 60 次，每天 5,000 次；超出限制会返回 429，并附带 Retry-After。大 rows 与狭窄的 where 过滤器相比，更有效地使用预算，而不是许多小调用。

值：订单 status 为 DRAFT、APPROVED 或 VOID，stage 为自由文本工作流阶段（新、待付款、处理中、暂停、已发货）。库存 available 为在手库存减去开放销售。联系人 type 为客户、供应商或内部。写入时以订单货币的金额进行；读取时返回基准货币值及汇率。新用户可能需要最多 2 小时才能在 cin7_omni_list_users 中出现。

常见错误：403 表示 API 连接对该资源没有权限：在 Permissions 下勾选并保存。429 是速率限制：等待 Retry-After 时间。

第二步 — 安装适配器

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

第三步 — 在 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 现在可以调用 Cin7 Omni 的工具。

可用工具

示例提示

• "本周哪些销售订单已批准且尚未发货？"
• "每个分支中 SKU TSHIRT-BLK-M 的可用库存是多少？"
• "本月预计到达的采购订单有哪些，来自哪些供应商？"
• "找到电子邮件为 [email protected] 的客户，并显示他们的欠款余额。"
• "创建一份将 20 个 TSHIRT-BLK-M 从主仓库转移到市区商店的草稿转移。"

常见问题

我使用 Cin7 Core（DEAR Inventory）。这是正确的连接器吗？ 不是。Cin7 Core 有自己的 API 和凭据：请使用 Cin7 Core 连接器。一种产品的凭据无法在另一种产品上使用。

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

下一步

• 连接器登录页面
• 连接到 Claude