摘要
通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网页后台登录 API。
引导式设置
2 分钟将 iiko 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 iiko,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 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
通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网页后台登录 API。
设置
设置大约需要 5 分钟。
- 以管理员身份登录网页后台 (iikoWeb 对于 iiko,Syrve Web / Syrve App 对于 Syrve),并打开云 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 未及时响应(餐厅可能离线)。
前提条件:IIKO_API_HOST,IIKO_LOYALTY_API,IIKO_API_LOGIN
本地安装连接器
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
打开 http://localhost:3000/connectors/store,选择 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 的客人,并显示奖金余额和最近的交易。”
下一步
这份指南对你有帮助吗?