AI 问数演示与体验

1. 先连接 Chinook

在线环境无需注册或服务端 API Key。AI 客户端本身是否需要账号、订阅或模型额度，以所用客户端为准。

在客户端的 MCP 设置中新增远程服务：

这种地址已固定 Namespace，不需要额外填写 Header。Namespace（下文简称 NS）用来选择一组样例模型与数据，例如 chinook 和 wwi-dw。

如果客户端使用 mcpServers JSON 配置，点击代码块顶部的**“一键复制完整配置”**，再粘贴到客户端即可：

{
  "mcpServers": {
    "foggy-chinook": {
      "url": "https://mcp-demo.qlfloor.com/mcp",
      "headers": {
        "X-NS": "chinook"
      }
    }
  }
}

客户端的配置位置和字段以自身说明为准。固定 NS 地址与 X-NS 二选一即可，同时设置时两者必须一致。

连接成功后，AI 应能发现 dataset.list_models、模型描述和查询等工具。本演示使用 HTTP POST 的 MCP JSON-RPC 入口；只支持旧 SSE 接口的客户端需要适配，不能直接把地址改成 /sse。

2. 发出第一组问题

先发送：

看看这个演示环境能查什么，先读取模型和字段说明。

然后发送：

查一下 2012 年的账单金额合计。

再继续：

按客户统计 2012 年的账单金额，列出前五名。

AI 应先发现模型、读取引擎实时生成的字段说明，再校验并执行查询。这里只需连接 MCP；服务器已准备好语义层模型，无需你提前生成 Markdown 或安装建模 Skill。

本环境实测的核对点：

金额含义按各样例的字段说明理解，不应自行称为人民币。WWI 的事实数据截至 2016-05-31，最后一项不能说成完整全年销售额；订单金额与开票销售额也不能混用。

3. 换一个样例

将固定地址中的 NS 替换即可，例如：

https://mcp-demo.qlfloor.com/ns/chinook-multidim/mcp
https://mcp-demo.qlfloor.com/ns/wwi-oltp/mcp
https://mcp-demo.qlfloor.com/ns/wwi-dw/mcp

如果同时连接多个服务，给它们不同的名称，提问时说明使用哪一个。模型和字段应从当前 NS 实时获取，不能把其他 NS 的名称直接搬过来。

已验证的部署共 16 个 NS、44 个 QM（查询模型），当前可用清单以线上目录为准。教材中的层级、日历、工单等补充数据包含教学构造，不应当作 Chinook 原库固有业务。

可以尝试这些简短问题：

• chinook-multidim：按支持人员和国家比较 2012 年十月、十一月的账单金额。
• time-business：先看看有哪些库存和工单模型，说明它们分别按什么日期统计。
• wwi-oltp：2016 年现有数据中，哪些客户的含税开票金额最高？
• wwi-dw：按月查看 2015 年的含税销售额。

缺少所需指标或定义时，AI 应说明限制或请求澄清。

4. 体验权限范围

普通样例无需认证。第 13 章的 chinook-scope 则专门演示权限效果，需要选择一个公开教学角色：

{
  "mcpServers": {
    "foggy-scope-usa": {
      "url": "https://mcp-demo.qlfloor.com/ns/chinook-scope/mcp",
      "headers": {
        "Authorization": "Demo-USA"
      }
    }
  }
}

查询 2012 年账单金额，Demo-USA 得到 127.98，改为 Demo-Canada 得到 42.57。不传角色时该受限查询被拒绝，受限单价字段也不能查询。切换角色后需让客户端重新连接并获取元数据。

两个值只是公开的教学选择值，不是账号或生产密钥。其他 NS 仍公开完整 Chinook 样例，因此这个演示用于观察权限如何执行，不代表真实客户数据的登录与隔离系统。

5. 与本地实操有什么区别

在线环境已经完成数据接入和模型创建，适合先体验查询，再回到教材理解实现。第 6—8 章的安装、探查和建模，以及后续修改 TM/QM、导入文件和运行回归脚本，仍需在自己的练习环境进行。

公开 MCP 提供模型发现、实时元数据、查询、Compose 和查询解释；不开放原始 SQL、数据库写入、文件上传或模型维护。文件系列展示的是已导入快照，不会接收你的 Excel 文件。Console、FDP 和自定义 Dashboard 将在后续阶段讲解。

普通查询每次最多返回 500 行，默认 200 行；Pivot 使用轴上的 TopN，不添加顶层 limit。较大结果应缩小范围或分页。共享演示环境还限制并发和响应大小，返回超时不等于查询结果为零。

6. 常见情况

服务版本与验证日期：Launcher 0.1.42，2026-10-27。已有模型的字段说明由引擎按加载状态实时生成；本文给出的是连接方法与样例边界。