跳转至

AI 助手

BringCRM 提供两种 AI 使用方式：

  • CRM 内 AI 助手：浏览器里右下角悬浮窗或顶部「AI 助手」，适合边录单边问
  • 外部 Agent（MCP）：在 WorkBuddy、Cursor 等客户端里连接 BringCRM，在外部助手中查改 CRM 数据

须购买 AI 功能包 并由管理员完成配置；外部 MCP 连接另需 bring-engine 服务在线。

使用前（管理员）

  1. 打开 管理 → Bring AI → AI 助手设置
  2. 查看页顶 「AI 助手就绪检查」，全部通过后再启用
  3. 勾选 启用 AI 助手，选择 AI 服务商（DeepSeek 或 Kimi），填写 API Key 与 模型 → 保存
  4. 管理 → 用户 → 为需要使用 AI 的业务员勾选 启用 AI / MCP 访问

系统提示词可留空，默认已内置外贸场景话术；仅在需要定制公司用语时再修改。

Docker 部署

官方 Docker Compose 会启动 bring-engine 容器，并把 MCP 端口映射到主机的 8092。就绪检查里「bring-engine 在线」通过即可。

CRM 内打开 AI 助手

  • 右下角悬浮窗：随时打开，适合边录单边问
  • 顶部导航「AI 助手」：大窗口模式，适合较长对话

两种方式共用同一份聊天历史。

界面说明

  • 支持 Markdown 显示（表格、列表、代码块等）
  • 悬浮窗可 拖拽左上角调整大小、最大化
  • 首次对话前会显示 推荐问题，点击即可发送
  • 聊天记录保存在浏览器本地，刷新页面后自动恢复

能帮您做什么

场景 示例
客户与跟进 「查一下 XX 公司的跟进进度和最近报价」
报价 / 订单 / 出运 「SO-202508001 的明细和状态」
财务对账 「某客户 8 月应收和已收款汇总」
待办查询 「还有哪些单待出运 / 待采购」
产品信息 「型号 ABC 的规格和库存相关字段」
系统怎么用 「报价单怎么拆单」「怎么按模板导出 Excel」

AI 会按您的权限访问 CRM 数据；看不到的数据同样无法回答。

使用建议

  • 尽量带上 客户名称、单号 等具体信息，回答更准确
  • 复杂问题可 拆成多轮 逐步问
  • 涉及写库操作时，请先核对 AI 给出的内容再确认保存

外部 Agent 连接（MCP）

MCP 让 WorkBuddy、Cursor 等外部 AI 客户端，通过标准 HTTP 接口调用 BringCRM 的工具（查客户、查订单、录入跟进等）。
不是 CRM 内部的聊天实现细节——对您而言，就是「在外部助手里连上自家 CRM」。

先决条件

  1. 已购买并开通 AI 功能包，管理员完成上文「使用前」配置
  2. bring-engine 服务在运行（就绪检查通过）
  3. 您的 CRM 用户已勾选 启用 AI / MCP 访问
  4. 若从外网连接，服务器防火墙/security group 需放行 8092 端口（见下文 URL 说明）

在 CRM 里查看连接信息

勾选 MCP 后，系统会为该用户自动创建专用 API 账号（登录名形如 张三_ai）。在 CRM 中可查看 MCP URL 与 API Key：

入口 说明
管理 → 用户 → 打开对应用户 → 底部 AI / MCP 访问 管理员或本人查看 URL、Key、WorkBuddy 配置 JSON
顶部 AI 助手 大窗口 → 外部客户端（WorkBuddy）连接设置 当前登录用户快捷查看
导航 AI / MCP 设置（已开通用户） 同上

页面上会显示完整的 WorkBuddy MCP 配置 JSON，可直接复制；其中的 url 与 X-EspoCRM-Api-Key 请按您实际环境使用，勿把 Key 发给无关人员或提交到公开仓库。

MCP 地址（url）怎么填

BringCRM 默认把 MCP 服务暴露在 CRM 站点同一主机的 8092 端口，路径固定为 /mcp。

CRM 站点地址（siteUrl） MCP 地址（外部客户端 url）
https://crm.贵司域名.com https://crm.贵司域名.com:8092/mcp
http://123.45.67.89:8080 http://123.45.67.89:8092/mcp
本机 Docker 试用 http://localhost:8092/mcp 或 http://127.0.0.1:8092/mcp

说明：

  • 8092 是 Docker Compose 默认映射端口（容器内 bring-engine 为 3100，主机为 8092）。若您改过编排端口，以实际映射为准。
  • WorkBuddy 与 CRM 装在同一台电脑时，可用 http://localhost:8092/mcp。
  • WorkBuddy 在别的电脑访问云服务器上的 CRM 时，url 须写 服务器的公网域名或 IP + :8092/mcp，并在云厂商防火墙放行 8092。
  • 若管理员在 AI 助手设置 里配置了 MCP URL 覆盖（例如走反代），以外部客户端能访问到的地址为准；以 CRM 页面显示的 MCP URL 为准。

X-EspoCRM-Api-Key 是什么

这是 EspoCRM 的 API 密钥，用于 MCP 请求鉴权：

  • 勾选 启用 AI / MCP 访问 后，系统自动为该 CRM 用户生成/关联一条 API 用户 及对应 Key
  • 外部客户端每次请求 MCP 时在 HTTP 头带上 X-EspoCRM-Api-Key: <您的密钥>
  • 数据权限与 CRM 里该业务员本人一致（能看哪些客户、订单，MCP 也只能操作哪些；不是超级管理员密钥）
  • Key 可在上文「在 CRM 里查看连接信息」的页面复制；丢失或泄露请联系管理员在用户详情重新处理 API 用户

WorkBuddy 配置示例

在 WorkBuddy 的 连接器 / MCP 配置中编辑 mcp.json（或界面里粘贴等价 JSON）。url 与 Key 必须换成 CRM 页面里显示的值：

{
  "mcpServers": {
    "bringcrm": {
      "type": "http",
      "url": "https://crm.贵司域名.com:8092/mcp",
      "headers": {
        "X-EspoCRM-Api-Key": "在此粘贴 CRM 里显示的 API Key"
      },
      "disabled": false
    }
  }
}

mcpServers 下的名称（如 bringcrm）可自定，只要 WorkBuddy 能识别即可。CRM 界面生成的 JSON 里键名可能是 espocrm，功能相同。

配置保存后，在 WorkBuddy 里启用该 MCP 服务器，即可用自然语言让 Agent 查询或操作 BringCRM（如「查 XX 公司最近报价」「有哪些单待出运」）。

Cursor 等其它客户端

同样使用 HTTP MCP、url 与 X-EspoCRM-Api-Key 请求头；具体配置文件路径以各客户端文档为准，参数含义与 WorkBuddy 相同。

连接不上时

  1. 管理 → Bring AI → AI 助手设置 → 刷新就绪检查，确认 bring-engine 在线
  2. 确认用户已勾选 启用 AI / MCP 访问，且 Key 未过期/未改
  3. 本机浏览器访问 {MCP URL} 是否可达（外网须放行 8092）
  4. WorkBuddy 所在网络能否访问 CRM 服务器该端口

仍无法连接，可 联系我们（官网首页底部电话 / 微信），我们可远程协助配置 WorkBuddy、防火墙与 MCP 地址。

相关文档