# HiWelink AI 智能体（MCP）使用帮助说明

> 更新日期：2026-08-26 适用对象：外贸线索 AI 管理用户（主账号 / 雇员子账号均可绑定） 功能入口：登录 www.hiwelink.com → 用户中心 → **AI 智能体绑定**

---

## 一、这是什么

HiWelink AI 智能体通过标准 **MCP（Model Context Protocol）** 协议，把你自己常用的 AI 工具（Codex、Claude、Cursor、WorkBuddy 等）接入你的外贸线索库。

绑定账号后，你可以用**自然语言**让 AI 智能体直接操作业务数据，例如：

- 「帮我统计一下线索经营情况」
- 「查询状态为 qualified 的线索」
- 「新建一条客户线索，邮箱是 xxx」
- 「给这条线索做个意向评分」
- 「把最近 5 条跟进记录做个总结」

AI 以**你的账号身份**操作数据，全程受租户隔离保护：子账号只能看到自己可见的数据，主账号可操作全量数据。

---

## 二、支持的工具与接入端点

<table id="bkmrk-%E9%A1%B9%E7%9B%AE-%E8%AF%B4%E6%98%8E-%E5%8D%8F%E8%AE%AE-mcp%EF%BC%88streama"><thead><tr><th>项目</th><th>说明</th></tr></thead><tbody><tr><td>协议</td><td>MCP（Streamable HTTP + SSE）</td></tr><tr><td>接入地址</td><td>`https://www.hiwelink.com/api/mcp/sse`</td></tr><tr><td>消息端点</td><td>`https://www.hiwelink.com/api/mcp/message`</td></tr><tr><td>服务器信息</td><td>`https://www.hiwelink.com/api/mcp`</td></tr><tr><td>服务器名称</td><td>`hiwelink-mcp`（v1.0.0）</td></tr></tbody></table>

支持的 AI 客户端：**OpenAI Codex**、**Claude（Desktop）**、**Cursor**、**腾讯 WorkBuddy** 及其他支持自定义 MCP 的工具。

---

## 三、使用前提

1. 已注册并登录 www.hiwelink.com，**主账号或雇员子账号均可绑定**（子账号绑定后仅可操作自建 + 分配给本人的数据）。
2. 已在客户库（联系人/公司）中录入数据，或希望通过 AI 录入新数据。
3. 已安装/可运行上述任意一种 AI 客户端。

---

## 四、使用流程（三步）

### 第 1 步：让智能体发起操作

在 AI 智能体对话中，直接说你的需求，例如：

> 「查询我的高意向线索」

智能体首次尝试操作你的数据时，会返回一个 **6 位绑定码**（如 `PZJI67`）。

### 第 2 步：输入绑定码

1. 打开 www.hiwelink.com 用户中心 → **AI 智能体绑定**。
2. 在「绑定智能体」输入框中输入智能体返回的 **6 位绑定码**。
3. 点击 **确认绑定**，提示「绑定成功」即完成。

### 第 3 步：回到智能体继续

回到 AI 智能体对话，让 TA **重新执行刚才的请求**，即可正常查询/操作你的线索数据。

> 提示：绑定码有效期 15 分钟，过期请在智能体侧重新发起一次操作以获取新码。 绑定成功后，同一智能体无需重复绑定。

---

## 五、各 AI 客户端接入配置

### 1. OpenAI Codex CLI / SDK

```
codex mcp add hiwelink --sse https://www.hiwelink.com/api/mcp/sse

```

### 2. 腾讯 WorkBuddy

- 方式一：WorkBuddy 设置 → MCP → 添加自定义 MCP，粘贴配置
- 方式二：编辑 `~/.workbuddy/mcp.json`（Windows：`C:\Users\用户名\.workbuddy\mcp.json`）

```
{
  "mcpServers": {
    "hiwelink": {
      "url": "https://www.hiwelink.com/api/mcp/sse"
    }
  }
}

```

### 3. Claude Desktop / Cursor

编辑 `claude_desktop_config.json` 或 Cursor 的 MCP 配置：

```
{
  "mcpServers": {
    "hiwelink": {
      "url": "https://www.hiwelink.com/api/mcp/sse"
    }
  }
}

```

---

## 六、AI 技能清单（共 19 项）

绑定后，智能体可调用以下技能操作你的数据：

### 线索（联系人）

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-leads_list-%E6%9F%A5%E8%AF%A2%E7%BA%BF"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`leads_list`</td><td>查询线索列表：按关键词、阶段、星级、分配人、来源、分页筛选</td></tr><tr><td>`leads_stats`</td><td>线索经营统计：总数、各阶段数量、星级、活跃/阻断、来源分布</td></tr><tr><td>`leads_create`</td><td>新建线索（邮箱/电话/网址任一重复自动拦截）</td></tr><tr><td>`leads_update`</td><td>更新线索：资料、阶段、星级、评分、备注、标签、归属</td></tr><tr><td>`leads_score`</td><td>智能分级评分（0-100）：采购频次/互动/需求明确度/企业实力/意向 5 维加权，自动给出高/中/低意向与跟进建议</td></tr><tr><td>`leads_dedupe_check`</td><td>查重：检查邮箱/电话/网址是否已存在</td></tr><tr><td>`leads_assign`</td><td>线索批量分配/取消分配（仅主账号）</td></tr></tbody></table>

### 客户公司

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-companies_list"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`companies_list`</td><td>查询客户公司列表（关键词/行业/国家/归属人筛选）</td></tr><tr><td>`companies_create`</td><td>新建客户公司（同名自动拦截）</td></tr><tr><td>`companies_update`</td><td>更新公司资料与归属</td></tr><tr><td>`companies_assign`</td><td>公司批量分配/取消分配（仅主账号）</td></tr></tbody></table>

### 团队

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-team_members-%E6%9F%A5"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`team_members`</td><td>查询本账号团队成员，用于线索/公司分配</td></tr></tbody></table>

### 跟进记录

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-follow_ups_lis"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`follow_ups_list`</td><td>查询跟进记录（按线索/公司、方式、关键词、日期筛选）</td></tr><tr><td>`follow_ups_create`</td><td>新增跟进记录</td></tr><tr><td>`follow_ups_update`</td><td>更新跟进记录（乐观锁防冲突）</td></tr><tr><td>`follow_ups_delete`</td><td>删除跟进记录（软删除）</td></tr><tr><td>`follow_ups_summary_save`</td><td>同步 AI 总结（整体摘要/关键点/待办/建议）到跟进记录</td></tr><tr><td>`follow_ups_summary_get`</td><td>查询已同步的跟进总结</td></tr></tbody></table>

### 其他

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-binding_status"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`binding_status`</td><td>查询当前绑定账号、账号类型、可操作数据范围、可用技能</td></tr></tbody></table>

---

## 七、数据安全与权限

- **租户隔离**：数据按账号（client\_id）隔离，互不可见。
- **角色权限**： 
    - 主账号：可操作全量数据，可分配线索/公司。
    - 子账号（员工）：只能看到自建 + 分配给本人的数据，不可执行分配操作。
- **绑定规则**： 
    - 一个智能体只能绑定**一个**账号；
    - 一个账号可绑定**多个**智能体；
    - 主账号与雇员子账号均可绑定；子账号可操作范围为**自建 + 分配给本人**的数据。
- **解绑**：在「AI 智能体绑定」页的已绑定列表中点击「解绑」，即时撤销授权。

---

## 八、常见问题（FAQ）

**Q1：绑定码过期/无效怎么办？** 绑定码有效期 15 分钟。回到 AI 智能体重新发起一次操作，让 TA 重新返回一个新绑定码，再到绑定页输入。

**Q2：提示「该绑定码已被其他账号绑定」？** 同一智能体只能绑定一个账号。如需更换账号，先在原账号解绑，再让智能体重新发起操作获取新绑定码。

**Q3：子账号绑定后能操作哪些数据？** 子账号（员工）绑定后，智能体只能查询和操作**自建 + 分配给本人**的线索/公司/跟进记录，与登录用户中心看到的数据范围一致；线索/公司的分配操作仍仅限主账号。

**Q4：智能体说「操作失败 / 无权访问」？** 确认操作对象是否在当前账号数据范围内；子账号只能操作可见数据。

**Q5：绑定后如何查看当前绑定状态？** 对智能体说「查询我的绑定状态」，TA 会调用 `binding_status` 返回绑定账号、类型与数据范围。

---

## 九、注意事项

- 数据操作请谨慎授权，解绑或离职员工账号后请及时在绑定页撤销对应智能体。
- AI 智能体的输出基于你的真实数据，操作前建议核对关键字段（如邮箱、电话）。
- 若 AI 智能体返回技术报错，请核对 MCP 配置地址是否为 `https://www.hiwelink.com/api/mcp/sse`。