首页 帮助中心 WorkBuddy 接入易特 ERP MCP 完整教程
帮助文档

WorkBuddy 接入易特 ERP MCP 完整教程

发布时间:2026-08-16 来源:易特软件 编辑:易特 ERP

三步搞定,全程不超过 2 分钟

  1. 在 WorkBuddy 连接器 → 自定义连接器 → 配置 MCP,粘贴 JSON 配置并保存
  2. 返回 MCP 列表,点 信任 启用
  3. 在对话里直接提问(如「查一下库存」),按提示报三项即可

第 1 步 · 主界面打开添加菜单

1在输入框下方的 + 按钮上点击

打开 WorkBuddy 主对话界面,鼠标移到输入框左下角的 + 图标上,会浮出提示「可添加文件、专家、技能、连接器」。

WorkBuddy 主界面,红色箭头指向 + 号

第 2 步 · 选「连接器 → 管理连接器」

2选择「连接器」并进入「管理连接器」

弹出菜单依次选 连接器 → 管理连接器(底部那一项)。

+号菜单,红色箭头指向 连接器→管理连接器

第 3 步 · 打开「自定义连接器」

3右上角点「自定义连接器」

进入「连接器」总览页后,右上角有一个 自定义连接器 入口,点击进入 MCP 服务管理页面。

连接器列表,红色箭头指向 自定义连接器

第 4 步 · 打开 MCP 服务管理,点「配置 MCP」

4首次使用点「配置 MCP」新建

页面显示「暂无 MCP 服务器」,右上角点 配置 MCP 进入配置编辑器。

MCP 服务管理空状态,红色箭头指向 配置 MCP

第 5 步 · 粘贴 JSON 配置并保存

5把下面这段 JSON 整段粘进去,点保存

编辑器路径即 C:\Users\你的用户名\.workbuddy\mcp.json。把下面整段 JSON 完整复制,粘进去后点 保存

复制{
  "mcpServers": {
    "yite-erp": {
      "type": "streamable_http",
      "url": "https://chat.yitesoft.com/api/mcp",
      "description": "易特 ERP 工具(标准 MCP 直连;令牌在对话中用 erp_login 提交,无需改配置)",
      "disabled": false
    }
  }
}

保存后状态会显示 未保存 → 已保存(右上角徽章变化)。

MCP 配置 JSON 页面,红色箭头指向 保存

第 6 步 · 返回列表,点「信任」

6首次连接需要信任确认

保存后会自动返回 MCP 列表,看到新条目「易特 ERP」状态为「首次连接此 MCP 服务器需要您的信任确认」。点右边的 信任 按钮。

安全性:这里点「信任」只是允许 WorkBuddy 调用这个 URL 的工具,不会泄漏任何数据。真正的数据范围由 ERP 后端按账套 JWT 隔离。
MCP 列表,红色箭头指向 信任 按钮

第 7 步 · 启用成功(21 个工具已启用)

721/21 个工具已启用,绿灯常亮

信任后状态变为「1 启用」,列表显示「易特 ERP 工具 · 21/21 个工具已启用」,右侧开关变绿。

21 个工具包含 2 个内置(erp_login + set_erp_token)+ 19 个 ERP 操作工具(查仓库、开单、查库存等)。

MCP 已启用状态,21/21 工具

第 8 步 · 在对话框直接提问

8用自然语言提问

回到主对话界面,直接输入你想做的事,例如:

  • 「查一下易特ERP有多少库存」
  • 「开一张销售单,客户张三,空调 2 台单价 3000」
  • 「看一下仓库 A01 有什么产品」
对话框提问 查一下易特ERP有多少库存

第 9 步 · 按提示报三项登录

9WorkBuddy 会自动要求登录凭证

首次使用还没登录 ERP,WorkBuddy 会自动向你询问凭证,并提供两种方式(推荐方式一,最省事)。

方式一 · 推荐(免复制长 JWT)

直接报:

复制我的云账号是 test123,操作员是 管理员,密码是 和易特ERP软件登陆密码一致

模型会调用 erp_login 工具,网关向 APIV2 换取 JWT 并存入本次会话。密码仅用于本次换令牌,不落盘、不会返回给模型

方式二 · 备用(已有 JWT)

登录 ERP 网页 → F12 → Console 执行 window.__MCP_TOKEN__ 复制三段式令牌,然后说:

复制设置 ERP 令牌:eyJhbGciOi...
下次直接复用:会话内 30 分钟内再聊,会话还在就不用重新报。令牌过期或被踢,再报一次三项即可,全过程无需改任何配置文件。
WorkBuddy 要求登录凭证的回复

第 10 步 · 查看查询结果

10WorkBuddy 自动汇总真实 ERP 数据

登录成功后 WorkBuddy 会按你的需求自动调用工具、把原始 ERP 数据汇总成清晰的报表(指标表 + 负库存清单)。

试试这些:「查一下易特ERP有多少库存」「查销售订单列表」「开一张采购单,供应商飞杨,产品空调 10 台单价 5」「帮我审核这张单」……
库存查询结果(指标表+负库存清单)

常见问题

? WorkBuddy 报「尚未登录 ERP」?

在对话里说三项凭证即可。如果已经报过一次但还是报这个,说明会话过期了(30 分钟无活动),重新报一次就行。

? 登录报「用户名或密码错误」?

核对 云账号/操作员/密码 三项是否正确。账号被锁定或密码过期也会这样。

? 报「ERP 令牌已失效」?

JWT 已过期(一般几小时到一天)。在对话里再报一次三项即可,无需改任何文件。

? mcp.json 被清空了 / 配置丢了?

已知坑:WorkBuddy 在连接器管理里做删除/信任等操作时可能把 mcp.json 重置为空。文件路径:C:\Users\你的用户名\.workbuddy\mcp.json。按第 5 步重新粘一遍 JSON 即可。

?? 完成:至此 WorkBuddy 已成功接入易特 ERP MCP,享受 21 个工具随时对话操作 ERP,无需复制长令牌、无需改任何配置文件。
关于作者
本文由易特软件团队撰写。易特软件专注中小企业管理软件研发 15 年,服务超过 5000 家五金、机加工、电子、模具、汽配类工厂及商贸企业,产品涵盖进销存、ERP、仓库管理、物资出入库等一体化解决方案,并提供引导式上线与实施手册,帮助企业按节奏稳稳落地,避免“上了一半荒废”。