摘要
Cin7 Core(前身为 DEAR Inventory)通过外部 API v2:按位置的产品和库存可用性,销售与订单、履行、发票和付款(只读)、采购、客户、供应商、库存调整和转移。创建销售、采购、客户、供应商和转移。账户 ID 和应用密钥。
引导式设置
2 分钟将 Cin7 Core 连接到 Meta Muse
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Cin7 Core,再把你的 MCP URL 添加到 Meta Muse。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Cin7 Core 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Cin7 Core,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Cin7 Core + Meta Muse
Cin7 Core(前身为 DEAR Inventory)通过外部 API v2:按位置的产品和库存可用性,销售与订单、履行、发票和付款(只读)、采购、客户、供应商、库存调整和转移。创建销售、采购、客户、供应商和转移。账户 ID 和应用密钥。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY
第 1 步 — 获取凭据
设置大约需要 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 connector。一个的凭据无法在另一个上使用。
- 在 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 或应用密钥错误。
第 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 步 — 在 Muse 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors,选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面:登录并批准访问。
- 在聊天中,向 Muse 提出需要用到
Cin7 Core的工具的请求。
你也可以在聊天中完成设置,适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接,因此 localhost 无法使用。
可用工具
| 工具 | 功能 |
|---|---|
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、状态、订单日期、客户、CustomerID… |
cin7_core_get_sale | 读取一个销售及其头部(客户、联系人、地址、位置、税务规则、条款、价格层、发货日期、状态)和报价… |
cin7_core_get_sale_order | 读取销售的订单部分:SaleOrderNumber、状态(草稿、已授权…)、备注、行(ProductID、SKU、名称、数量、价格… |
cin7_core_get_sale_fulfilments | 读取销售的履行:拣货、打包和运输阶段及其状态、行、箱子、承运人和追踪号码 |
cin7_core_get_sale_invoices | 读取销售的发票:TaskID、InvoiceNumber、状态、InvoiceDate、InvoiceDueDate、行、总额和已支付金额 |
cin7_core_get_sale_payments | 读取记录在销售上的付款、预付款和退款:类型、金额、支付日期、账户、参考、汇率 |
cin7_core_list_purchases | 列出采购:ID、OrderNumber、状态、订单日期、供应商、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、名称、代码、税率、IsTaxForSale、IsTaxForPurchase、IsActive、账户 |
cin7_core_list_payment_terms | 列出付款条款:ID、名称、持续时间、方法、IsActive、IsDefault |
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、TransferQuantity、批次)和状态 |
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。"
常见问题
我使用 Cin7 Omni(go.cin7.com)。这是正确的连接器吗? 不是。Cin7 Omni 有一个单独的 API v1,使用 API 用户名和密钥:请使用 Cin7 Omni connector。一个产品的凭据无法在另一个上使用。
Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?