INDIVIDUAL MCP TOOL

zhini_search_customers

搜索客户通讯录，用于根据客户名、手机号、微信号、客服、负责人、明确标签、渠道、性别、联系人类型或时间范围完整召回符合条件的客户 UID。用户只要求查询当天或某个时间范围内咨询过的客户时，默认查询当前授权账号关联的所有渠道范围，不代表当前调用客服本人接待或回复过；除非用户明确说“我处理过、我接待过、我回复过、归属于我”或指定某客服/渠道，否则不要自动传 kfid、pic_kfids 或 channel_id。用户要求查询某天或某段时间内的全部用户、包括会话已经结束/关闭的用户时，应使用本工具分页查询，不能用 zhini_list_active_sessions 代替。重要边界：自然语言中的“XXX 用户/客户”默认是业务语义或筛选条件，不应自动转换为 tag_id。可由名称、时间、渠道、客服等结构化字段表达的条件直接使用本工具；必须根据聊天内容判断的条件，应结合 zhini_search_sessions 和 zhini_fetch_messages 识别。只有用户明确要求某标签或上下文已有 tag_id 时才按标签筛选，且 tag_id 只覆盖已标注客户。用户给客户姓名/手机号/微信号时先用本工具召回候选客户；如果匹配多个客户，应让用户确认。用户明确给出标签名、渠道名、客服名时，应先分别调用 zhini_search_tags、zhini_list_channels、zhini_list_kefu 解析 ID。禁止空条件拉全量；page 从 0 开始；page_size 最大 20。后续：拿到 uid 后通常调用 zhini_get_customer_profile 或 zhini_fetch_messages。

zhinikefu.comnone authenticationAvailability not checked

LIVE ENDPOINT

https://mcp.h5bqb.top/mcp

No auth detected

Connect to this endpoint to inspect the live schema for zhini_search_customers and invoke it with your own arguments.

Indexed input schema

{}

Risk classification

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

Parent server

zhinikefu.com

CONNECT WITH APPROVAL

Client installation

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.zhini-mcp-service]
url = "https://mcp.h5bqb.top/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "zhini-mcp-service": {
      "type": "http",
      "url": "https://mcp.h5bqb.top/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: zhini-mcp-service
Remote MCP URL: https://mcp.h5bqb.top/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "zhini-mcp-service": {
      "url": "https://mcp.h5bqb.top/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "zhini-mcp-service": {
      "type": "http",
      "url": "https://mcp.h5bqb.top/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "zhini-mcp-service",
  "transport": "streamable-http",
  "url": "https://mcp.h5bqb.top/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

Related tools

zhini_get_current_kefu — 获取当前调用者的客服 ID，即 kfid。用于在调用 zhini_list_active_sessions 前识别当前会话列表中哪些是自己正在接待的会话，或在用户明确说“我处理过、我接待过、我回复过、归属于我”等第一人称归属条件时构造 kfid 筛选。重要边界：用户只要求查询当天或某个时间范围内的对话、咨询过的客户时，默认范围是当前授权账号关联的所有渠道，不表示当前调用客服本人处理过，不应调用本工具或自动附加当前 kfid。本工具只输出 kfid，不输出手机号、姓名、团队、企业或负责渠道等身份信息。
zhini_list_active_sessions — 获取当前授权客服账号所负责渠道下尚未关闭、尚未结束的当前会话队列。用于查看此刻的待接待、我的会话、同事会话、AI 会话状态，或从当前队列选定会话后读取消息/客户资料。重要边界：这是当前队列快照，不是历史查询；当天或更早已经由当前授权账号、其他客服结束/关闭的会话不会返回，不能用本工具汇总某天或某段时间内的全部用户、全部接待或完整会话。需要完整用户范围时调用 zhini_search_customers；需要已结束、已关闭或历史会话时调用 zhini_search_sessions，必要时再用 zhini_fetch_messages 按消息时间验证。范围：只返回当前授权账号负责渠道下的会话，不是全企业所有会话；我的会话全部返回，同事会话最多显示 250 个，排队中/等待接待会话最多显示 100 个，达到上限时摘要应提示可能被截断。前置：需要区分“我的会话/同事会话”时，先调用 zhini_get_current_kefu 获取当前 kfid。
zhini_get_customer_profile — 按客户 UID 获取客户资料和标签，用于确认客户身份、来源、负责人、联系方式、备注和标签。适用于客服回复前、销售跟进前、复盘客户历史前。边界：只读查询，不修改客户资料、备注、负责人或标签。前置：如果用户只给姓名/手机号/微信号，先用 zhini_search_customers 找 uid；如果已经有 uid，直接调用本工具。后续：需要聊天上下文时调用 zhini_fetch_messages。
zhini_list_tag_groups — 获取标签分组，用于了解标签体系、解释标签归属，或在列出某分组标签前获取 tag_group_id。边界：只读字典工具，不新增、修改或删除标签分组。前置：无。后续：已知分组后可调用 zhini_list_tags；用户直接给标签名时通常优先调用 zhini_search_tags。
zhini_list_tags — 分页获取标签列表，用于在已知标签分组 ID 时列出该分组下的标签，并为客户搜索或历史会话搜索提供 tag_id。page 从 1 开始；page_size 最大 20。前置：可先调用 zhini_list_tag_groups 获取分组；如果用户只提供标签中文名，优先调用 zhini_search_tags 解析 tag_id。后续：拿到 tag_id 后可调用 zhini_search_customers 或 zhini_search_sessions。
zhini_search_tags — 按关键词搜索标签，用于把用户明确提出的标签名解析成稳定 tag_id。典型场景：用户说“查带高意向标签的客户”“按高意向标签筛选”，先调用本工具搜索“高意向”，再用 tag_id 调用 zhini_search_customers 或 zhini_search_sessions。重要边界：自然语言中的“XXX 用户/客户”默认表示业务语义或筛选条件，不表示名为 XXX 的标签；只有用户明确提到“标签、带标签、按标签筛选”，或上下文已给出 tag_id 时才调用本工具。标签只代表已经被人工或系统标注的客户，不等于业务语义上的完整人群。空关键词应返回参数错误。include_grouped=true 时按 tag_group_id 聚合，便于用户确认同名或相似标签。
zhini_fetch_messages — 读取聊天消息。支持按 sid 首次加载会话消息、按 mid 游标翻页、按 uid 查询某客户消息。适用于查看当前会话上下文、查看历史会话命中词前后文、按 UID 拉取某段时间内消息并总结诉求/投诉/售后问题。已知 uid/sid/mid 时直接调用本工具，不要先搜索。约束：sid、mid、uid 至少传一个；传 mid 时建议同时传 direction；按 uid 查询时 start_time/end_time 可选；size 最大 20。时间语义：start_time/end_time 是消息发生时间过滤，不是会话开启时间。
zhini_list_kefu — 获取当前授权范围内的客服列表，用于把客服姓名解析成 kfid。适用于“客服A负责哪些客户”“抽查某客服历史接待”“队列统计时把 kfid 转成人名”等场景。only_active=true 时只返回可用客服；name 为空时可标准化为未命名。前置：无。后续：拿到 kfid 后可调用 zhini_search_customers、zhini_search_sessions，或在 zhini_list_active_sessions 中辅助标记 mine/colleague。