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 以你的账号身份操作数据，全程受租户隔离保护：子账号只能看到自己可见的数据，主账号可操作全量数据。
二、支持的工具与接入端点
| 项目 | 说明 |
|---|---|
| 协议 | MCP（Streamable HTTP + SSE） |
| 接入地址 | https://www.hiwelink.com/api/mcp/sse |
| 消息端点 | https://www.hiwelink.com/api/mcp/message |
| 服务器信息 | https://www.hiwelink.com/api/mcp |
| 服务器名称 | hiwelink-mcp（v1.0.0） |
支持的 AI 客户端：OpenAI Codex、Claude（Desktop）、Cursor、腾讯 WorkBuddy 及其他支持自定义 MCP 的工具。
三、使用前提
- 已注册并登录 www.hiwelink.com，主账号或雇员子账号均可绑定（子账号绑定后仅可操作自建 + 分配给本人的数据）。
- 已在客户库（联系人/公司）中录入数据，或希望通过 AI 录入新数据。
- 已安装/可运行上述任意一种 AI 客户端。
四、使用流程（三步）
第 1 步：让智能体发起操作
在 AI 智能体对话中，直接说你的需求，例如：
「查询我的高意向线索」
智能体首次尝试操作你的数据时，会返回一个 6 位绑定码（如 PZJI67）。
第 2 步：输入绑定码
- 打开 www.hiwelink.com 用户中心 → AI 智能体绑定。
- 在「绑定智能体」输入框中输入智能体返回的 6 位绑定码。
- 点击 确认绑定，提示「绑定成功」即完成。
第 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 项）
绑定后，智能体可调用以下技能操作你的数据：
线索（联系人）
| 技能 | 作用 |
|---|---|
leads_list |
查询线索列表：按关键词、阶段、星级、分配人、来源、分页筛选 |
leads_stats |
线索经营统计：总数、各阶段数量、星级、活跃/阻断、来源分布 |
leads_create |
新建线索（邮箱/电话/网址任一重复自动拦截） |
leads_update |
更新线索：资料、阶段、星级、评分、备注、标签、归属 |
leads_score |
智能分级评分（0-100）：采购频次/互动/需求明确度/企业实力/意向 5 维加权，自动给出高/中/低意向与跟进建议 |
leads_dedupe_check |
查重：检查邮箱/电话/网址是否已存在 |
leads_assign |
线索批量分配/取消分配（仅主账号） |
客户公司
| 技能 | 作用 |
|---|---|
companies_list |
查询客户公司列表（关键词/行业/国家/归属人筛选） |
companies_create |
新建客户公司（同名自动拦截） |
companies_update |
更新公司资料与归属 |
companies_assign |
公司批量分配/取消分配（仅主账号） |
团队
| 技能 | 作用 |
|---|---|
team_members |
查询本账号团队成员，用于线索/公司分配 |
跟进记录
| 技能 | 作用 |
|---|---|
follow_ups_list |
查询跟进记录（按线索/公司、方式、关键词、日期筛选） |
follow_ups_create |
新增跟进记录 |
follow_ups_update |
更新跟进记录（乐观锁防冲突） |
follow_ups_delete |
删除跟进记录（软删除） |
follow_ups_summary_save |
同步 AI 总结（整体摘要/关键点/待办/建议）到跟进记录 |
follow_ups_summary_get |
查询已同步的跟进总结 |
其他
| 技能 | 作用 |
|---|---|
binding_status |
查询当前绑定账号、账号类型、可操作数据范围、可用技能 |
七、数据安全与权限
- 租户隔离：数据按账号（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。