连接器指南阅读约 4 分钟33 个 MCP 工具7 种语言

iiko MCP 接入 ChatGPT:订单与菜单

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

iiko

iiko

iiko and Syrve restaurant management through the iikoCloud API (Syrve Cloud API): organizations and terminal groups, menu and external menus, stop lists, delivery and table orders, reservations, couriers, order and payment types, discounts and loyalty customers. API login from the web back office.

个工具

33

区域

INTL

类别

电子商务

身份验证

Sign-in token

所需环境变量

IIKO_API_HOSTIIKO_LOYALTY_APIIIKO_API_LOGIN
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

引导式设置

2 分钟将 iiko 连接到 ChatGPT

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 iiko,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题(PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB,只读):打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT,使用你的 AnythingMCP MCP URL。

试试这样问

iiko 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

iiko · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → iiko,粘贴 API 登录并选择 iiko 或 Syrve 作为 API 主机和忠诚路径,生成 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

iiko + ChatGPT

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN

第一步 — 获取凭据

设置大约需要 5 分钟。

  1. 以管理员身份登录网络后台(iiko 的 iikoWeb,Syrve 的 Syrve Web / Syrve App),打开云 API 设置(Integrations, API keys;在旧版本中称为 API settings 或 Live API settings)。
  2. 为此连接器创建一个 API 登录(API 密钥):给它一个名称,选择它可以访问的组织和到期日期(最多 2 年)。复制密钥;新密钥长度为 36 个字符,可能只显示一次。
  3. 将其粘贴到 IIKO_API_LOGIN 中。两次选择你的产品:在 IIKO_API_HOST 中选择 API 主机,在 IIKO_LOYALTY_API 中选择相同的产品(iiko 和 Syrve 对忠诚路径的命名不同)。
  4. 可选:在第一次调用 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

第三步 — 在 ChatGPT 中添加连接器

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

ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。

  1. 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
  2. 填写名称,例如 Name: iiko。
  3. 在 Connection 下的 Server URL 中填入 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。
  4. 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
  5. 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。

可用工具

工具功能
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 应该使用它们时在连接器页面上启用它们。

ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。

下一步

这份指南对你有帮助吗?

2 分钟将 iiko 连接到 ChatGPT

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 iiko,再把你的 MCP URL 添加到 ChatGPT。无需代码,也无需自行运行服务器。

相关指南

连接器

iiko MCP 接入 Claude:订单与菜单

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

连接器

iiko MCP 接入 Microsoft Copilot

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

连接器

iiko MCP 接入 Cursor:订单与菜单

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

连接器

iiko MCP 接入 Gemini CLI:订单与菜单

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

连接器

iiko MCP 接入 Meta Muse:订单与菜单

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网络后台登录 API。

连接器

iiko MCP 服务器:菜单、订单与预订

通过 iikoCloud API (Syrve Cloud API) 管理 iiko 和 Syrve 餐厅:组织和终端组、菜单和外部菜单、停用列表、配送和桌面订单、预订、快递员、订单和支付类型、折扣和忠诚客户。通过网页后台登录 API。