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。