将 Cin7 Omni MCP 连接到 Microsoft Copilot

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

Cin7 Omni + Microsoft Copilot

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

第三步 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
2. 填写 Server name（例如 AnythingMCP）、说明连接器用途的 Server description，以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
3. 身份验证选择 API key，把 Type 设为 Header，请求头名称填 X-API-Key，然后选择 Create。
4. 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
5. 在智能体的 Test 窗格中试一试：提出需要用到 Cin7 Omni 的工具的请求。
6. 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。

自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。

可用工具

示例提示

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

常见问题

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

这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。

下一步

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