Windows
EXE · x64- 运行下载的安装器,按系统提示允许管理员权限。
- 按向导完成安装。首次安装默认启用访问密钥认证。
- 安装完成后打开管理页;以后双击桌面的“IoTube MCP 管理”。服务会在后台运行,无需保留终端窗口。
覆盖安装请沿用已有数据目录,以保留 ERP 连接与配置。
IoTube MCP把采购、销售和库存数据接入 WorkBuddy。查询真实业务信息,整理明细与报表,让日常查数更直接。
IoTube MCP
按实际模型和字段查询,返回单号、供应商、日期与状态。
页面为功能示意,业务结果以您连接的 ERP 返回为准。
02 / 安装与启动
覆盖安装请沿用已有数据目录,以保留 ERP 连接与配置。
选择 Linux 并取得下载信息后,显示对应安装命令。若系统策略阻止自动启动,运行 sudo systemctl start sufai-erp-mcp 启动服务。
安装后由 systemd 管理后台服务。在服务器本机浏览器访问管理页;无桌面时,可在管理员自己的电脑上建立 SSH 本地端口转发:
ssh -N -L 127.0.0.1:27200:127.0.0.1:27200 用户名@服务器地址替换 SSH 用户名与服务器地址,保持终端连接,再在自己电脑的浏览器打开下方管理页。如需让本机 WorkBuddy 也通过此隧道连接,在命令的用户名之前再加 -L 127.0.0.1:27201:127.0.0.1:27201,WorkBuddy 即可使用本页的同机连接地址。
本机已有服务占用端口时,改用空闲的本地端口,并相应调整浏览器或 WorkBuddy 地址。供同事直接连接远程 MCP 时,需要管理员配置可达的服务监听地址、访问密钥及网络访问规则,再分享实际地址。
在安装服务的电脑上打开;此地址用于管理,不是 WorkBuddy 的连接地址。
http://127.0.0.1:27200本页 27200(管理)和 27201(MCP)是安装版的初始默认端口。使用自定义端口、SSH 转发或外网映射时,请使用管理员提供的实际访问地址,保留其端口及路径。
03 / 连接 WorkBuddy
从“IoTube MCP 管理”复制实际地址和密钥。
同事接入时,使用管理员分享的内网地址。
IoTube MCP 已提交 WorkBuddy 审核,尚未正式上架。账号已有测试安装入口,或正式上架后,可添加连接器并按以下方式填写。
新版连接器的配置表单提供“首次使用?下载安装与连接指南”,打开本页下载安装,再返回 WorkBuddy 填写连接信息。旧版表单未显示此链接时,也可直接访问本页;已有服务则跳过安装。
| 表单字段 | 填写方式 |
|---|---|
| 协议 | http若管理员提供 HTTPS 地址,则填 https。 |
| 服务地址(不含协议) | 127.0.0.1:27201/mcp去掉开头的 http:// 或 https://,保留端口及路径。 |
| 访问密钥 | 复制管理页中的密钥不加 Bearer 前缀;仅管理员明确关闭认证时留空。 |
打开 WorkBuddy 设置中的自定义 MCP 配置,按实际管理页信息填写。已有其他 MCP 配置时,把 iotube-mcp 条目加入现有 mcpServers,保留其他服务。
{
"mcpServers": {
"iotube-mcp": {
"type": "streamableHttp",
"url": "http://127.0.0.1:27201/mcp",
"headers": {
"Authorization": "Bearer 替换为管理页中的访问密钥"
}
}
}
}将示例中的密钥文字替换为实际密钥;地址有变化时也要修改。此 JSON 的请求头需要 Bearer 前缀。仅在管理员明确关闭认证时删除整个 headers 项。自定义 MCP 可以调用服务工具,市场包中的查询 Skill 需通过相应安装方式加载。
04 / 首次 ERP 查询
在 WorkBuddy 中说“连接金蝶云星空”或“连接用友 U8”。按工具返回的说明提供所需参数;已有连接时直接查询。
管理员在服务电脑查看待批准请求,核对 ERP、地址、账套和账号。确认后人工批准,返回原对话继续测试和保存。
从一个指定单号或明确日期范围开始,与 ERP 界面核对结果。后续复用已保存的连接,不必重复初始化。
通常需要登录网址、账套 ID、用户名和密码。账套 ID 不是账套中文名称。
需要 SQL Server 地址、端口、账套数据库和授权的数据库账号;建议使用专用只读账号,业务登录账号不能替代数据库账号。
查询本月采购订单,列出供应商、订单日期和单据状态。
查询当前库存,按仓库列出存货和数量。
根据已查询的销售订单整理明细表,说明数据范围。
可查询范围由实际 ERP 版本、模型和账号权限决定。分页或统计未完整时,应按工具返回说明数据范围。
当前连接器只开放 ERP 业务只读工具,不提供新增、修改、删除或审核业务单据的工具。首次创建及修改连接需要管理员人工批准。
服务部署在您选择的电脑或服务器上,直接访问所配置的 ERP。查询结果会返回给 WorkBuddy,用于回答问题和整理报表,其后续处理遵循您使用的 WorkBuddy 与模型服务配置。通过对话提供 ERP 参数时,相关内容也会进入对话处理流程。
可以连接同一内网服务。当前每个服务实例只有一个活动 ERP 连接,客户端共享相同的 ERP 账号和可查询范围,尚不提供按员工划分的 ERP 权限或多租户隔离。
先确认服务电脑开机、管理页可打开,且 WorkBuddy 能访问服务地址。连接其他电脑时不能使用 127.0.0.1。核对访问密钥是否被轮换;已有 ERP 连接异常时先诊断,不要反复重新初始化。
使用管理员提供的完整访问地址,在 WorkBuddy 中分别填写协议和不含协议的服务地址,保留实际端口与 /mcp 路径,并填写 MCP 访问密钥。服务 1.0.1 起支持启用密钥认证时由代理保留公共域名和外部端口,HTTPS 可在代理处终止。仅映射 MCP 端口,本机管理页仍只在服务电脑上访问。
覆盖安装应沿用已有数据目录,保留连接和设置。更新 WorkBuddy 连接器与更新本地服务是两项操作,市场包升级不会自动替换本地服务程序。
需要引导?
复制安装指引到你的 AI 助手。系统提权和 ERP 连接批准仍由管理员完成。