摘要
Cin7 Core（前身为 DEAR Inventory）通过外部 API v2：按位置的产品和库存可用性，销售与订单、履行、发票和付款（只读）、采购、客户、供应商、库存调整和转移。创建销售、采购、客户、供应商和转移。账户 ID 和应用密钥。
引导式设置
2 分钟将 Cin7 Core 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Cin7 Core，再把你的 MCP URL 添加到 ChatGPT。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题（PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB，只读）：打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT，使用你的 AnythingMCP MCP URL。
试试这样问
Cin7 Core 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 没有安装？直接使用 cloud.anythingmcp.com。 登录，点击 Connectors → Cin7 Core，粘贴你的凭据，生成一个 MCP API 密钥，完成。无需 Docker，无需
git clone，无需本地服务器。
Cin7 Core + ChatGPT
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 步 — 在 ChatGPT 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件，仅付费套餐可用，不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加；在 Enterprise 和 Edu 中，管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins，点击 Add，然后选择 Add custom MCP server。
- 填写名称，例如 Name:
Cin7 Core。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，Authentication 保持为 OAuth。 - 选择 I understand and want to continue，然后点击 Create as a plugin。ChatGPT 提示时，登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件，然后在对话中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
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。一个产品的凭据无法在另一个上使用。
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明，Free 套餐不在其列。
下一步
这份指南对你有帮助吗?