摘要
通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。
引导式设置
2 分钟将 iiko 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 iiko,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
iiko 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → iiko,粘贴 API 登录并选择 iiko 或 Syrve 作为 API 主机和忠诚路径,生成 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
iiko + Cursor
通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
第一步 — 获取凭据
设置大约需要 5 分钟。
- 以管理员身份登录网络后台(iiko 的 iikoWeb,Syrve 的 Syrve Web / Syrve App),打开云 API 设置(Integrations, API keys;在旧版本中称为 API settings 或 Live API settings)。
- 为此连接器创建一个 API 登录(API 密钥):给它一个名称,选择它可以访问的组织和到期日期(最多 2 年)。复制密钥;新密钥长度为 36 个字符,可能只显示一次。
- 将其粘贴到
IIKO_API_LOGIN中。两次选择你的产品:在IIKO_API_HOST中选择 API 主机,在IIKO_LOYALTY_API中选择相同的产品(iiko 和 Syrve 对忠诚路径的命名不同)。 - 可选:在第一次调用
iiko_list_organizations后,将你的主要餐厅的 id 放入IIKO_ORGANIZATION_ID中,以便需要一个组织的工具可以省略它。
连接器在 /api/1/access_token 处用 API 登录交换一个有效期为 1 小时的 bearer token,并自行续期。iiko 将此登录调用标记为不推荐使用,建议使用 /api/v2/access_token,后者还需要在开发者门户中注册一个应用;如果 iiko 关闭旧调用,设置检查将报告登录失败。
从哪里开始:iiko_list_organizations 提供每个工具所需的组织 id。iiko_list_terminal_groups 列出一个组织的 POS 安装,iiko_check_terminal_groups_alive 告诉它们是否在线。
菜单:iiko_list_external_menus 和 iiko_get_external_menu 读取为配送渠道准备的菜单,按组织显示价格。iiko_get_nomenclature 读取完整的后台菜单(较大;已为 Syrve 文档化,不再在 iiko 参考中,因此更倾向于使用 iiko 的外部菜单)。iiko_get_stop_lists 显示每个终端组缺货的商品;iiko_add_to_stop_list 和 iiko_remove_from_stop_list 更改它,并且默认关闭(它们需要具有额外停用列表权限的 API 登录)。
配送订单:iiko_list_deliveries_by_date_and_status(每日概览)、iiko_search_deliveries(文本搜索和问题过滤)、iiko_list_deliveries_by_phone、iiko_get_deliveries_by_id。这些保证覆盖最近 7 天;iiko_list_delivery_history_by_phone 可追溯 90 天。状态:未确认、等待烹饪、准备烹饪、烹饪开始、烹饪完成、等待中、运输中、已交付、已关闭、已取消。iiko_create_delivery 和 iiko_cancel_delivery 默认关闭:创建的订单会送到厨房,取消无法撤销。
桌面订单和预订:iiko_get_table_orders_by_id 和 iiko_list_table_orders_by_table 读取堂食订单。对于预订,iiko_list_reserve_terminal_groups,然后 iiko_list_restaurant_sections(大厅和桌子)、iiko_list_reserves(从某个时间开始的预订)和 iiko_get_reserves_by_id(详细信息)。连接器不创建预订。
字典:iiko_list_order_types、iiko_list_payment_types、iiko_list_discounts、iiko_list_cancel_causes、iiko_list_couriers。它们很少更改:每次对话读取一次,而不是每次订单读取。
忠诚:iiko_get_customer 通过电话、电子邮件或卡片查找客户并显示钱包余额;iiko_list_customer_transactions 列出奖金变动;iiko_list_customer_categories 和 iiko_list_loyalty_programs 描述该程序。iiko_create_or_update_customer 保存客户主数据。连接器从不充值、持有或注销钱包,也不记录支付。
命令:创建或取消配送以及更改停用列表的响应同时带有 correlationId;POS 随后执行命令。通过 iiko_get_command_status 读取结果(进行中、成功、错误)。
格式:id 为 UUID。日期格式为 yyyy-MM-dd HH:mm:ss.fff,不带时区:订单和预订时间为终端的本地时间(请参见 iiko_list_terminal_groups 中的时区),忠诚报告日期为 UTC。金额以组织的货币为单位。几乎每个调用都是带有 JSON 主体的 POST,包括读取。
限制:iiko 将方法(字典、菜单、停用列表、订单读取等)分组,并限制每个组的时间段,通常为一分钟;超出限制时,该组的每个调用都会返回 429,直到时间段结束。订单和停用列表方法的限制随着餐厅数量的增加而增加。一次请求多个组织,而不是每次一个请求,缓存字典和菜单,不要轮询单个订单。重复相同或失败的请求可能会导致 API 登录被阻止。
错误:错误响应包含 errorDescription,通常还有 error(一个代码)以及一个 correlationId,以便向 iiko 支持引用。401 表示令牌或 API 登录被拒绝,400 表示字段错误,408 表示 POS 未及时响应(餐厅可能离线)。
第二步 — 安装适配器
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
第三步 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
iiko的工具。
可用工具
| 工具 | 功能 |
|---|---|
iiko_list_organizations | 列出 API 登录可以访问的组织(餐厅):id、名称和代码,以及国家、地址、坐标、时区设置… |
iiko_list_terminal_groups | 列出一个或多个组织的终端组(订单发送到的 POS 安装):按组织列出带有 id 的组… |
iiko_check_terminal_groups_alive | 检查终端组当前是否在线:每个终端组 isAlive 为 true 或 false。在告知某人餐厅之前使用… |
iiko_get_nomenclature | 读取一个组织的完整菜单(命名法),从后台导出:组、产品类别、产品(菜品… |
iiko_list_external_menus | 列出外部菜单(为配送网站和应用在网络后台准备的菜单)及账户的价格类别:id… |
iiko_get_external_menu | 读取一个外部菜单及其项目类别、项目、大小、每个组织的价格、修改器组、过敏原、营养值… |
iiko_get_stop_lists | 读取停用列表(缺货商品):按组织和终端组列出带有 productId、sizeId、sku、余额(剩余… |
iiko_list_order_types | 按组织列出订单类型:id、名称、orderServiceType(堂食订单的 Common,DeliveryByCourier、DeliveryByClient… |
iiko_list_payment_types | 列出支付类型:id、代码、名称、paymentTypeKind(现金、卡、外部、忠诚卡等)、paymentProcessingType、终端… |
iiko_list_discounts | 按组织列出在后台设置的折扣和附加费:id、名称、百分比或固定金额、模式、最低订单金额… |
iiko_list_cancel_causes | 列出配送取消原因:id、名称和 isDeleted。取消配送需要 id。只读;缓存响应 |
iiko_list_deliveries_by_date_and_status | 按配送日期和状态列出配送和自取订单:按组织列出带有 id、posId、creationStatus 和订单… |
iiko_list_deliveries_by_phone | 查找某个电话号码的最近配送订单(保证覆盖最近 7 天):与… 相同的订单详细信息 |
iiko_list_delivery_history_by_phone | 查找某个电话号码在订单历史中的旧配送订单(保留 90 天):相同的订单详细信息,按组织分组,最多… |
iiko_search_deliveries | 通过文本搜索配送订单(在订单号、客户姓名、电话或地址上进行前缀搜索),并提供日期、状态、服务类型的过滤器… |
iiko_get_deliveries_by_id | 按 id 读取最多 200 个配送订单:creationStatus(成功、进行中、错误及错误信息)和完整订单的状态、客户… |
iiko_get_table_orders_by_id | 按 id 读取桌面(堂食)订单:creationStatus 和带有 tableIds、状态(新、账单、已关闭、已删除)、服务员、客户… |
iiko_list_table_orders_by_table | 列出给定桌子的桌面(堂食)订单,可按状态和创建日期选择:与 iiko_get_table_orders_by_id 的详细信息相同… |
iiko_list_reserve_terminal_groups | 列出接受桌面预订和宴会的给定组织的终端组:id、名称、地址和时区,以及… |
iiko_list_restaurant_sections | 列出接受预订的终端组的餐厅区域(大厅),及其桌子:区域 id 和名称,以及每个桌子的 id… |
iiko_list_reserves | 列出从开始时间起在餐厅区域预订的预订和宴会:id、tableIds、estimatedStartTime、durationInMinutes 和… |
iiko_get_reserves_by_id | 按 id 读取预订和宴会:creationStatus、isDeleted 和带有客户、电话、客人数量、桌子、预计开始… |
iiko_list_couriers | 列出每个组织的配送快递员:id、firstName、lastName、displayName、code 和 isDeleted。只读 |
iiko_get_customer | 通过电话、电子邮件、卡号、卡轨道或 id 查找一位忠诚客户(客人):id、名称、姓氏、电话、电子邮件、生日、性别… |
iiko_list_customer_categories | 列出一个组织的忠诚计划的客户(客人)类别:id、名称、isActive 和 isDefaultForNewGuests。只读 |
iiko_list_loyalty_programs | 列出一个组织的忠诚计划:id、名称、描述、programType、isActive、有效日期、walletId,以及营销… |
iiko_list_customer_transactions | 列出一位客户在一段时间内的忠诚交易(奖金累积和注销、钱包充值、优惠券):类型、类型名称、金额… |
iiko_create_or_update_customer | 创建一位忠诚客户或更新通过 id、电话或卡找到的客户:名称、电话、电子邮件、生日、性别、备注、同意状态和… |
iiko_get_command_status | 检查命令的结果(创建或取消配送、更改停用列表):状态进行中、成功或错误及… |
iiko_create_delivery | 在 POS 中创建配送或自取订单。这是一个命令:响应携带 correlationId 和带有 creationStatus 的 orderInfo… |
iiko_cancel_delivery | 取消配送订单,并提供取消原因。无法撤销,已打印的商品将被注销。这是一个命令:检查… |
iiko_add_to_stop_list | 将商品放入一个终端组的停用列表,带有剩余数量(售罄为 0)。客人无法再订购已售罄的… |
iiko_remove_from_stop_list | 将商品从一个终端组的停用列表中移除,以便可以再次订购。需要具有额外权限的 API 登录以更改停用… |
示例提示
- “今天哪些配送订单仍未发货,按餐厅分类?”
- “每个终端组当前的停用列表是什么?”
- “我们的所有 POS 终端组都在线吗?”
- “显示今晚 18:00 在主餐厅的预订,包括大厅和桌子。”
- “查找电话为 79161234567 的客人,并显示奖金余额和最近的交易。”
常见问题
API 登录来自哪里? 管理员登录网络后台(iiko 的 iikoWeb,Syrve 的 Syrve Web),打开 Integrations,API keys(在旧版本中为 API settings)。为连接器创建 API 登录,选择它可以访问的组织和最多 2 年的到期日期,并复制密钥。然后选择你的产品作为 API 主机和忠诚路径:iiko 使用 api-ru.iiko.services,Syrve 使用 api-eu.syrve.live,密钥仅在其自身产品的主机上有效。
它涵盖了什么? 组织和终端组及其在线状态,外部菜单及价格和后台菜单,停用列表,按日期、状态、电话或文本搜索的配送订单,桌面订单,带有大厅和桌子的预订,快递员,订单和支付类型,折扣和取消原因,以及忠诚客户的钱包余额和奖金交易。它保存客户主数据,但从不充值、持有或注销钱包,不记录支付,也不创建预订。
哪些工具默认关闭? iiko_create_delivery、iiko_cancel_delivery、iiko_add_to_stop_list 和 iiko_remove_from_stop_list。创建的订单直接送到厨房,取消无法撤销,停用列表工具需要具有额外停用列表权限的 API 登录。仅在 AI 应该使用它们时在连接器页面上启用它们。
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?