Final POS – Custom POS Builder
官方使用AI构建自定义POS系统。设计结账流程、自助结账终端和支付终端应用,实时预览并部署到支持刷卡支付的真实硬件。同时管理门店运营:商品、库存、订单、客户和销售报表。支持远程访问和OAuth认证。
你可以用 Final POS – Custom POS Builder MCP 做什么?
- 根据描述构建自定义POS应用 — 让您的助手创建结账流程,例如咖啡店自助点单机,并获取实时预览链接。
- 验证并部署POS流程 — 请求验证您应用的流程文件,然后将最新版本发布到您的支付终端和自助点单机。
- 监控并管理库存 — 检查库存水平,查找低库存商品,并为常用供应商起草采购订单。
- 分析销售表现 — 按类别比较各周销售额,或识别您的顶级客户及其购买记录。
- 管理目录和客户 — 从包含照片的电子表格中添加产品,或设置带指定员工的可预约服务。
托管 MCP 服务器
npx add-mcp 'https://ai.finalpos.com/mcp'可安装到 Claude Code、Codex、Cursor 等客户端
文档
Final MCP 服务器:使用 AI 构建自定义 POS 应用
将 Claude、ChatGPT、Gemini、Cursor、Codex 或任何 MCP 客户端连接到 Final:
使用 Flow(结账流程、自助结账终端、支付终端)构建自定义 POS 应用
,并通过 Hub 通过一个服务器管理其背后的门店。
https://ai.finalpos.com/mcp
连接 · 它能做什么 · 工具参考 · 常见问题 · finalpos.com
Final MCP 服务器是 Final 的官方 Model Context Protocol 服务器,Final 是自定义销售点(POS)的商业平台。
一个远程端点 https://ai.finalpos.com/mcp 即可让 AI 代理访问商家允许的每个 Final 产品:
- Flow,自定义 POS 应用构建器:描述一个结账流程,代理会基于经过审核的屏幕蓝图构建它,以 Final 版本锁定的 POS API 为基础,然后验证它,返回实时预览链接,并将其部署到支付终端、平板电脑和自助终端。包括柜台 POS、自助结账、餐厅点餐、厨房显示屏和面对面支付应用。
- Hub,这些应用背后的后台:产品和目录、库存和采购订单、订单、客户、销售报告、团队和角色、门店、税费、预订。
您使用 Final 账户(OAuth 2.1)登录,并选择公司和代理可以执行的操作。无需在本地安装或运行任何内容。
| 端点 | https://ai.finalpos.com/mcp |
| 传输方式 | Streamable HTTP |
| 认证 | 带 PKCE 的 OAuth 2.1(使用 Final 登录),或使用 fai_ 连接密钥作为 Authorization: Bearer |
| 注册表名称 | com.finalpos/final |
| 身份 | 连接者本人,在一个公司内,在其允许的包范围内 |
| 费用 | 连接免费;代理执行的操作遵循您的 Final 套餐,如同您在 Final 中自行操作一样 |
连接
大多数客户端只需要 URL。它们会打开一个 Final 登录页面,您在其中选择公司和包,然后即可连接。
Claude(claude.ai、Claude Desktop)
设置 → 连接器 → 添加自定义连接器,URL 为 https://ai.finalpos.com/mcp。
ChatGPT
设置 → 应用与连接器 → 高级设置 → 开发者模式,然后使用 URL https://ai.finalpos.com/mcp 创建。
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcp
在 Claude Code 中运行 /mcp 并选择 Authenticate。或者安装插件,该插件会连同 Final playbook 技能一起添加服务器。在 Claude Code 中:
/plugin marketplace add Final-Commerce/final-pos-mcp
/plugin install final@final
Gemini CLI
gemini extensions install https://github.com/Final-Commerce/final-pos-mcp
该扩展添加了服务器、Final playbook 和命令:
/final-pos:stock、/final-pos:sales、/final-pos:new、/final-pos:preview、
/final-pos:validate 和 /final-pos:deploy。在 Gemini CLI 中使用
/mcp auth final 登录一次。若仅添加服务器:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
或在 ~/.cursor/mcp.json 中:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code(GitHub Copilot)
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex、脚本和不支持 OAuth 的客户端
在 ai.finalpos.com/connections 创建连接密钥。
该密钥仅显示一次,页面会为每个客户端打印确切的代码片段。对于
Codex,请将其添加到 ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
任何其他客户端:使用 POST https://ai.finalpos.com/mcp 和
Authorization: Bearer fai_YOUR_KEY。
以
sk_(Flow)或fpm_(Hub)开头的密钥属于这些产品 自己的服务器,此处不接受。请创建fai_密钥,或使用 OAuth。
检查是否正常工作
向您的代理提问:“使用 Final 告诉我您连接到了哪个公司,以及您可以使用哪些包。” 它会调用 get_connection 和 list_packs。
您的代理能做什么
工具按包分组。连接时,您选择代理可以使用的包,这些包也是 OAuth 范围。为保持模型上下文较小,连接一次仅列出少数几个包。核心工具可访问其余工具:find_tools 搜索所有允许的包,call_tool 按名称调用任何允许的工具。
| 包 | 产品 | 涵盖内容 | 默认列出 |
|---|---|---|---|
catalog | Hub | 产品、变体、类别、选项、修饰符、产品照片和媒体库 | ✓ |
inventory | Hub | 库存水平和历史、调拨、供应商、采购订单、补货规则、库存 CSV 导入/导出 | |
orders | Hub | 订单、退款和电商订单同步(只读:收银台负责收款) | |
customers | Hub | 客户记录、备注、订单历史和客户导入 | |
reports | Hub | 财务摘要、销售和支付明细、员工销售、会话、交易、记录导出 | |
team | Hub | 团队成员、角色和权限 | |
store | Hub | 门店、工作站、税费和 Hub 扩展 | |
bookings | Hub | 可预订服务:规则、资源、可用性、保留和确认 | |
build | Flow | 构建和部署 Final POS 应用:API 基础、蓝图、流程文件、预览沙箱、验证、部署 | ✓ |
build_data | Flow | 自定义表(应用数据库)、密钥库和 Flow 扩展 |
工具名称带有其产品标识:hub_get_products、hub_find_low_stock、
flow_create_flow、flow_deploy_flow。TOOLS.md 列出了每个工具,包括其所属包、是否更改数据以及参数。
核心工具(始终列出):get_connection、list_packs、find_tools、
call_tool、enable_packs、disable_packs、switch_company。
可以尝试的请求
构建自定义 POS 应用(Flow)
- “构建一个咖啡店自助终端,包含产品网格、修饰符、购物车和卡支付,然后给我一个预览链接。”
- “给我的柜台应用添加一个小费屏幕并验证它。”
- “为一家小型杂货店创建一个带条码扫描和收据屏幕的自助结账流程。”
- “发布我的自助结账流程的最新版本。”
应用构建通常运行 flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame(基础)→ flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview,并
返回一个实时预览 URL。代理构建的所有内容也会出现在 Final
构建器中,每次文件写入都是一个可恢复的检查点。
管理门店(Hub)
- “Main Street 门店哪些产品低于补货点?为常用供应商起草一份采购订单。”
- “将上周按类别的销售与再前一周进行比较。”
- “从附带的电子表格中添加这 40 个产品,包括照片。”
- “我这个月的前十名客户是谁,他们买了什么?”
- “将 45 分钟的按摩设置为可预订服务,配备两名理疗师。”
安全与权限
-
您的角色仍然适用。 每次 Hub 调用都以连接者的身份运行,Hub 在每次调用时检查其实时角色。仅限所有者的操作仍仅限所有者。
-
包即权限。 代理只能调用您允许的包中的工具。您可以随时在 ai.finalpos.com/connections 更改包或断开连接, 断开连接会立即撤销所有令牌。
-
写入操作有标记。 读取工具带有
readOnlyHint,部署和 删除带有destructiveHint,因此客户端可以在操作前询问。服务器 会告知代理在部署、删除和批量更改前与您确认。 -
资金留在收银台。 收款、退款和作废订单 无法通过 MCP 进行。
-
密钥不会经过模型。
flow_request_secret会要求您在构建器中输入 API 密钥。 -
所有操作均有日志。 连接页面实时显示每个已连接的客户端 及其每次调用。
-
Flow 限制: Flow 允许每小时 30 次预览启动、12 次构建和部署,以及 300 次文件写入。
隐私与支持
- Final 保留的内容。 连接信息(谁创建的、公司和 包)、用于访问 Hub 和 Flow 的令牌(加密),以及每次 工具调用的日志:工具、结果、耗时以及参数和结果的脱敏 预览。您可以在 连接页面 查看该日志。
- Final 看不到的内容。 您的对话。MCP 客户端发送工具调用, 而不是周围的聊天内容。
- 断开连接 会删除存储的令牌并撤销颁发给该 连接的所有令牌。
- 隐私政策 · 条款
- 支持: support@finalpos.com。若 本指南或插件有问题,请打开 issue。
Flow 的直接端点
在网关之前创建的设置可能仍使用 https://flow.finalpos.com/api/mcp
和 Flow sk_ 密钥(注册表名称 com.finalpos.build/final-flows)。它
继续工作,但新设置应使用 https://ai.finalpos.com/mcp,其中包含
Flow。
常见问题
什么是 Final MCP 服务器?
它是 Final POS 的官方 MCP 服务器。一个远程 URL,
https://ai.finalpos.com/mcp,让 AI 助手读取和管理
商家的 Final 后台(Hub)并构建销售点应用(Flow)。
ChatGPT 或 Claude 可以管理我的 Final POS 库存吗?
可以。连接时允许 inventory 包。代理可以检查库存
水平、查找低库存、建议补货、创建采购订单并记录
收货。
AI 代理可以在 Final 上构建 POS 应用吗?
可以。使用 build 包,代理可以创建流程,基于 Final
版本锁定的 API 和经过审核的屏幕蓝图编写应用,验证它,并
返回实时预览 URL。您可以从 Final 构建器启动它。
我需要 API 密钥吗?
不需要,如果您的客户端支持 OAuth(Claude、ChatGPT、Claude Code、Cursor、
Gemini CLI、VS Code):只需使用 Final 登录。Codex 和脚本使用来自 ai.finalpos.com/connections 的 fai_
密钥。
它作用于哪个公司?
您连接时选择的那个。如果您的账户有多个公司,代理可以
调用 switch_company。
代理可以收款或退款吗?
不可以。支付、退款和作废在收银台上进行。订单在 MCP 上 是只读的。
为什么我的代理只看到几个工具?
客户端会将所有列出的工具放入模型的上下文中,列表过长会
降低质量。代理使用 find_tools 查找其余工具,使用
call_tool 调用它们,或使用 enable_packs 列出整个包。
有费用吗?
连接免费。代理执行的操作按照您在 Final 中自行完成相同工作的计费方式,在您的 Final 套餐下计费。
Final POS API 文档在哪里?
在 finalpos.com/docs。构建应用的代理
不需要单独查看:build 包会将每次调用基于 Final
版本锁定的 API(flow_lookup_pos_api、
flow_lookup_command_frame)。
关于此仓库
此仓库包含公开设置指南、MCP 注册表条目
(server.json、legacy/)、Gemini CLI 扩展
(gemini-extension.json、GEMINI.md、commands/)、Claude Code 和
Cursor 插件市场(.claude-plugin/、.cursor-plugin/ 和
plugins/final/,两者共享)以及生成的
工具参考 及其机器可读的孪生文件 catalog.json,
服务器卡片在 https://ai.finalpos.com/.well-known/mcp/server-card.json
也会读取。GEMINI.md 和 Claude 技能是同一个
playbook,CI 会检查它们是否匹配。服务器本身由 Final 托管;
此仓库中的代码不会在您的机器上运行。
许可证
Apache-2.0 © Final Commerce