摘要
通过外部 API v2 的 Cin7 Core（前身为 DEAR Inventory）：每个位置的产品和库存可用性，销售与订单、履行、发票和支付（只读）、采购、客户、供应商、库存调整和转移。创建销售、采购、客户、供应商和转移。账户 ID 和应用密钥。
引导式设置
2 分钟将 Cin7 Core 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Cin7 Core，再把你的 MCP URL 添加到你的 AI 助手。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Cin7 Core 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Cin7 Core，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需
git clone，无需本地服务器。
Cin7 Core
通过外部 API v2 的 Cin7 Core（前身为 DEAR Inventory）：每个位置的产品和库存可用性，销售与订单、履行、发票和支付（只读）、采购、客户、供应商、库存调整和转移。创建销售、采购、客户、供应商和转移。账户 ID 和应用密钥。
设置
设置大约需要 2 分钟。你需要一个 Cin7 Core 账户（前身为 DEAR Inventory；你可以在 inventory.dearsystems.com 登录），并访问 Integrations → API。连接器需要账户 ID 和应用密钥。
Core 还是 Omni？ Cin7 销售两种不同的产品。Cin7 Core（这个连接器，前身为 DEAR Systems）使用账户 ID 和应用密钥。Cin7 Omni（原始的 Cin7，go.cin7.com）有一个单独的 API v1，使用 API 用户名和密钥：使用 Cin7 Omni 连接器。一个的凭据无法在另一个上使用。
- 在 Cin7 Core 打开 API 设置页面，Integrations → API (inventory.dearsystems.com/ExternalAPI)。
- 点击 + 添加一个 API 应用并给它命名。
- 将 Account ID（一个 GUID）复制到
CIN7_CORE_ACCOUNT_ID，将 Application Key 复制到CIN7_CORE_APPLICATION_KEY。 - 安装连接器。运行
cin7_core_get_me检查连接：它返回账户的公司名称、基本货币和时区。
云和自托管的工作方式相同：凭据相同，并且没有重定向 URL 需要设置。连接器在 api-auth-accountid 和 api-auth-applicationkey 头中发送它们。在 Cin7 Core 中删除 API 应用将撤销密钥。
从哪里开始：cin7_core_get_me 获取基本货币，cin7_core_list_locations 获取位置名称，然后是 cin7_core_list_sales 和 cin7_core_get_product_availability，它们回答大多数问题。
它读取什么：每个产品和位置的产品、价格层级、库存可用性（在手、分配、可用、在订购中）；销售及其报价、订单、履行（拣货、打包和运输，带承运人和追踪）、发票和支付；采购及其订单；客户、供应商、税务规则和支付条款；库存调整和库存转移。
创建销售需要两个调用：cin7_core_create_sale 创建头部（客户、位置）并返回其 ID，然后 cin7_core_create_sale_order 添加行。行需要名称、数量、价格、税和税务规则加 SKU 或 ProductID。除非你希望它被授权，否则 AI 将订单保持为草稿：授权将分配库存，短缺时不发出警告并锁定订单以防止进一步的 API 编辑。采购的工作方式相同，使用 cin7_core_create_purchase 和 cin7_core_create_purchase_order。
其他写入：cin7_core_create_customer、cin7_core_update_customer 和 cin7_core_create_supplier（它们需要支付条款和税务规则名称及账户代码，cin7_core_list_payment_terms 和 cin7_core_list_tax_rules 列出），以及 cin7_core_create_stock_transfer（默认草稿）。所有这些都已启用。
安装时关闭：cin7_core_create_stock_adjustment（创建库存调整）。完成的调整会同时发布库存变动和会计条目，其数量为新的在手值，而不是差异。如果 AI 应该使用它，请在连接器页面上启用；AI 会要求你确认每个更改。
没有资金和删除：连接器从不记录、修改或删除支付、发票或信用票据，并且没有删除或作废工具。
标识符：记录使用 GUID（ID、SaleID、TaskID）。位置、税务规则、支付条款和价格层级通过名称引用。
分页：列表接受 page（从 1 开始）和 limit（默认 100，最多 1,000）；答案包含 Total。updated_since 或 modified_since 仅返回已更改的内容。日期为 UTC，格式为 yyyy-MM-ddTHH:mm:ss。
速率限制：每个 API 应用每分钟 60 次调用；超出后 Cin7 Core 返回 429（旧账户返回 503）。大页面和过滤器比许多小调用更有效地使用预算。
常见错误：拒绝的调用返回 400，内容为 [{"ErrorCode": 400, "Exception": "..."}]，指明问题，例如未知的客户、位置或税务规则，或已被授权的文档。403 表示账户 ID 或应用密钥错误。
先决条件：CIN7_CORE_ACCOUNT_ID、CIN7_CORE_APPLICATION_KEY
本地安装连接器
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
打开 http://localhost:3000/connectors/store，选择 Cin7 Core 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
cin7_core_get_me | 读取与密钥相关的 Cin7 Core 账户：公司名称、基本货币、时区、锁定日期、税务计算方法、默认税务规则 |
cin7_core_list_locations | 列出仓库和库存位置：ID、名称、地址、IsDefault、货架和是否已弃用 |
cin7_core_list_products | 列出产品（或按 ID 读取一个）：ID、SKU、名称、类别、品牌、类型（库存或服务）、成本方法、单位、状态、条形码、价格… |
cin7_core_get_product_availability | 每个产品和位置的库存可用性（以及货架或批次）：SKU、名称、位置、货架、批次、在手、分配、可用、在订购中… |
cin7_core_list_sales | 列出销售（报价、订单和发票共享一个销售记录）：SaleID、OrderNumber、Status、OrderDate、Customer、CustomerID… |
cin7_core_get_sale | 读取一个销售及其头部（客户、联系人、地址、位置、税务规则、条款、价格层级、发货日期、状态）和报价… |
cin7_core_get_sale_order | 读取销售的订单部分：SaleOrderNumber、Status（草稿、已授权…）、备注、行（ProductID、SKU、名称、数量、价格… |
cin7_core_get_sale_fulfilments | 读取销售的履行：拣货、打包和运输阶段及其状态、行、箱子、承运人和追踪号码 |
cin7_core_get_sale_invoices | 读取销售的发票：TaskID、InvoiceNumber、Status、InvoiceDate、InvoiceDueDate、行、总额和已支付金额 |
cin7_core_get_sale_payments | 读取记录在销售上的支付、预付款和退款：类型、金额、支付日期、账户、参考、汇率 |
cin7_core_list_purchases | 列出采购：ID、OrderNumber、Status、OrderDate、Supplier、SupplierID、InvoiceNumber、总额、货币、OrderStatus… |
cin7_core_get_purchase | 读取一个采购（简单、高级或服务）及其供应商、位置、方式、税务规则、条款、订单、收到的库存、发票等… |
cin7_core_get_purchase_order | 读取采购的订单部分：状态、备注、行（ProductID、SKU、SupplierSKU、名称、数量、价格、折扣、税、税务规则、总额)… |
cin7_core_list_customers | 列出客户（或按 ID 读取一个）：ID、名称、状态、货币、支付条款、税务规则、价格层级、折扣、信用额度、是否处于信用限制… |
cin7_core_list_suppliers | 列出供应商（或按 ID 读取一个）：ID、名称、状态、货币、支付条款、应付账款、税务规则、折扣、税号、地址等… |
cin7_core_list_tax_rules | 列出税务规则：ID、名称、代码、税率、是否销售税、是否采购税、是否活跃、账户 |
cin7_core_list_payment_terms | 列出支付条款：ID、名称、持续时间、方法、是否活跃、是否默认 |
cin7_core_list_stock_adjustments | 列出库存调整：TaskID、StocktakeNumber、EffectiveDate、状态（草稿、已完成、作废）、参考、账户 |
cin7_core_get_stock_adjustment | 读取一个库存调整及其行（ExistingStockLines、NewStockLines：SKU、位置、在手数量、调整、单位成本、批次）… |
cin7_core_list_stock_transfers | 列出位置之间的库存转移：TaskID、编号、状态（草稿、运输中、已完成、作废）、从和到位置… |
cin7_core_get_stock_transfer | 读取一个库存转移及其行（SKU、转移数量、批次）和状态 |
cin7_core_create_sale | 创建销售头部（客户、位置、条款、税务规则、地址） |
cin7_core_create_sale_order | 将订单行添加到使用 cin7_core_create_sale 创建的销售中 |
cin7_core_create_purchase | 为供应商创建采购头部（高级采购端点，适用于简单和高级采购） |
cin7_core_create_purchase_order | 将订单行添加到使用 cin7_core_create_purchase 创建的采购中 |
cin7_core_create_customer | 创建客户 |
cin7_core_update_customer | 按 ID 更新客户；仅更改给定的字段 |
cin7_core_create_supplier | 创建供应商 |
cin7_core_create_stock_adjustment | 创建库存调整 |
cin7_core_create_stock_transfer | 在两个位置之间创建库存转移 |
示例提示
- "每个位置有多少单位的 SKU MUG-WHT-350 可用？"
- "列出本月已授权但尚未完全履行的销售。"
- "显示订单 SO-1042 的履行及其承运人和追踪号码。"
- "哪些采购仍在等待接收库存？"
- "为客户 Coffee Corner 在主仓库创建一份草稿销售，包含 24 个 MUG-WHT-350，价格为 6.50。"
下一步
这份指南对你有帮助吗?