如何通过 MCP 将 ready2order 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → ready2order、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

ready2order + Gemini

将 ready2order 收银系统（POS）连接到你的 AI：商品、价格和库存、商品分组、小票和每日销售额、未结订单、客户、付款方式和税率，对商品、库存和客户的更改都会先经你确认。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

READY2ORDER_ACCOUNT_TOKEN

步骤 1 — 获取凭证

ready2order 通过一个简短的授权流程，为每个收银账户签发一个 Account Token。每个账户只需操作一次，大约 10 分钟，需要账户所有者的登录信息和一个免费的开发者注册。

1. 在 https://api.ready2order.com 注册为开发者。ready2order 会通过电子邮件发给你一个 Developer Token。
2. 用它申请访问权限：

   curl -X POST https://api.ready2order.com/v1/developerToken/grantAccessToken \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>" -H "Content-Type: application/json" -d "{}"
   

   返回结果中包含 grantAccessToken 和 grantAccessUri。
3. 在 10 分钟内打开 grantAccessUri，用 ready2order 账户所有者登录并点击 Approve。
4. 读取 Account Token：

   curl https://api.ready2order.com/v1/developerToken/grantAccessToken/<grantAccessToken> \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>"
   

5. 将返回结果中的 accountToken 粘贴到 READY2ORDER_ACCOUNT_TOKEN，然后安装连接器。令牌只会发送给 ready2order，在你于 ready2order 后台 Settings → API access 中撤销之前一直有效。

单独使用 Developer Token 会被拒绝并返回 403：连接器需要的是 Account Token。

覆盖范围：带价格、税率、商品编号、条码和库存的商品，含再订货点和安全库存的库存数量，商品分组，含明细、付款和税额拆分的小票（Belege），每张小票的 PDF 链接，按餐桌的未结订单，客户和客户分组，付款方式，税率，收银系统的用户，以及当前是否有未结束的日结（Tagesabschluss）。

先确认：写入会立即作用于正在使用的收银系统，新商品会马上出现在 POS 中。AI 会说明涉及的商品或客户和新的数值，并等待你确认。它可以创建和编辑商品，登记库存（盘点后的绝对数量，或到货、破损等增减数量），创建商品分组，以及创建和编辑客户。ready2order_delete_product 安装时默认关闭；要让商品停售，AI 会把它设为停用，而不是删除。

销售数据：ready2order_list_bills 可按时间段查询。默认按小票所属的日结（营业日）计算日期，也可以按你的要求改用小票自身的时间戳。包含已售明细时，可以得到按商品统计的销售额。小票属于税务记录：连接器无法修改或作废它们。

速率限制：每个 Account Token 每分钟 60 次请求；收到 429 后请等待一分钟。

常见错误：401 Sorry, but your token is invalid.：令牌错误或已被撤销；请重新走一遍授权流程。403：粘贴的是 Developer Token 而不是 Account Token。429：一分钟内请求超过 60 次。400 或 422：某个字段无效，错误信息会指出字段，例如商品没有税率。

该连接器不支持创建或作废小票（Storno）、打印，也不处理优惠券、折扣、餐桌、支付终端、Webhook 或会计导出。

步骤 2 — 安装 adapter

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 — 在 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 现在可以调用 ready2order 的工具。

可用工具

示例提示

• “昨天的总销售额是多少？卖得最好的 10 个商品是哪些？”
• “饮料分组中哪些商品低于再订货点？”
• “商品编号 1002 到货 24 瓶：把它们加到库存里。”
• “把卡布奇诺的价格调到 4.20，保存前先给我看一下改动。”
• “帮我取 Müller GmbH 最近一张小票的 PDF。”

FAQ

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

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT