跳转到主要内容

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


更新日期：2026-08-25适用对象：外贸线索 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 的工具。

三、使用前提

  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 项）

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

线索（联系人）

技能 作用
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：提示「子账号不可绑定 AI 智能体」？ AI 智能体由主账号统一授权。请用主账号登录绑定。

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

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

九、注意事项

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