{
  "markdown": "# 知你AI助手 MCP｜让 AI 查询多平台客户资料与客服会话\n\n> 将知你客服中的多平台客户资料、当前与历史会话及聊天记录连接到 Codex、Claude Code、WorkBuddy 等 AI 工具，通过自然语言完成客户查询、会话研判和业务分析。\n\n[知你AI助手官网](https://ai.zhinikefu.com/?f=github) · [知你客服官网](https://zhinikefu.com/?f=github) · MCP 服务地址：`https://mcp.h5bqb.top/mcp`\n\n## 产品介绍\n\n知你AI助手是一项面向 AI 工具的多平台客户沟通数据连接服务。它通过 Streamable HTTP MCP，将已接入知你客服的客户资料、标签、负责人、当前会话、历史会话和聊天记录连接到 AI 工具。\n\n团队可以直接用自然语言查找客户、了解沟通前情、检索退款或投诉记录、筛选目标客户、发现购买意向，并基于完整消息上下文整理业务结论。服务采用只读查询方式，查询范围由当前 API Key 权限决定，结果可以继续追溯到相关客户、会话和原始消息。\n\n## 支持的平台渠道\n\n**个微/企微/视频号/微信小程序/公众号/服务号/微信客服/微信小店/抖音号/小红书/微博/网站及H5客服等平台渠道。**\n\n## 核心能力\n\n1. **多平台客户数据统一查询**：查询已接入知你客服的个微、企微、视频号、微信小程序、公众号、服务号、微信客服、微信小店、抖音号、小红书、微博、网站及 H5 客服等平台渠道数据。\n2. **当前客服会话分诊**：查看个微、企微、微信客服、微信小程序、公众号、服务号、网站及 H5 客服等渠道的待接待、我的会话、同事会话和 AI 会话。\n3. **客户资料与沟通前情查询**：按姓名、手机号、微信号、渠道、客服、负责人、标签或时间，查找来自个微、企微、视频号、抖音号、小红书、微博等渠道的客户。\n4. **客户画像信息整理**：查询微信小店、微信小程序、公众号、服务号及其他已接入渠道客户的资料、标签、来源渠道、负责人和联系信息。\n5. **历史会话与聊天记录检索**：检索微信客服、个微、企微、抖音号、小红书、微博、网站及 H5 客服等渠道的历史会话。\n6. **消息关键词与时间查询**：按退款、投诉、报价、试用、购买等消息关键词和发生时间，定位视频号、微信小店、抖音号、小红书等渠道的相关客户会话。\n7. **完整消息上下文读取**：将 AI 整理结果追溯到对应平台渠道、客户、会话和原始消息。\n8. **渠道与业务字典查询**：查询平台账号、渠道、客服和标签字典。\n9. **API Key 用量查询**：查询当前 API Key 的总额度、已使用量和剩余额度。\n\n## MCP 工具\n\n| 工具 | 用途 |\n| --- | --- |\n| `zhini_get_current_kefu` | 查询当前调用者对应的客服身份 |\n| `zhini_list_active_sessions` | 查询当前客服会话队列 |\n| `zhini_get_customer_profile` | 查询客户资料与标签 |\n| `zhini_list_tag_groups` | 查询标签分组 |\n| `zhini_list_tags` | 分页查询标签 |\n| `zhini_search_tags` | 按关键词搜索标签 |\n| `zhini_fetch_messages` | 读取客户或会话的消息上下文 |\n| `zhini_list_kefu` | 查询客服列表 |\n| `zhini_list_channels` | 查询平台渠道列表 |\n| `zhini_search_customers` | 按业务条件搜索客户 |\n| `zhini_search_sessions` | 按业务条件搜索历史会话 |\n| `zhini_get_apikey_usage` | 查询 API Key 用量 |\n\n## 使用方法\n\n### 1. 获取 API Key\n\n访问[知你AI助手官网](https://ai.zhinikefu.com/?f=github)，注册或登录后创建 API Key。\n\n### 2. 添加 MCP 连接\n\n在 Codex、Claude Code、WorkBuddy 或其他支持 Streamable HTTP MCP 的 AI 工具中添加以下连接：\n\n```json\n{\n  \"mcpServers\": {\n    \"zhini\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.h5bqb.top/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${ZHINI_API_KEY}\"\n      }\n    }\n  }\n}\n```\n\n环境变量：\n\n```text\nZHINI_API_KEY=YOUR_API_KEY\n```\n\n### 3. 用自然语言查询\n\n- 现在有哪些客户正在等待接待？\n- 查一下这个客户最近聊了什么，还有哪些事情待确认？\n- 找出近 7 天提到退款的历史会话。\n- 哪些客户最近提过报价、试用或购买？\n- 整理最近登录异常反馈的共同问题。\n- 比较不同平台渠道客户最常咨询的问题。\n\n## 适用团队\n\n- 客服团队：会话分诊、回复前情查询、投诉与问题复盘\n- 销售团队：客户背景查询、意向识别、跟进线索整理\n- 客户运营：标签筛选、客户分群、跨渠道客户洞察\n- 质检与产品：历史问题检索、共性问题归纳、需求线索发现\n\n## 连接信息\n\n| 项目 | 信息 |\n| --- | --- |\n| 产品 | 知你AI助手 / Zhini AI Assistant |\n| 官网 | <https://ai.zhinikefu.com/?f=github> |\n| MCP 地址 | `https://mcp.h5bqb.top/mcp` |\n| 传输方式 | Streamable HTTP |\n| 鉴权方式 | Bearer API Key |\n| API Key 环境变量 | `ZHINI_API_KEY` |\n| MCP 标识 | `com.zhinikefu/zhini-mcp-service` |\n| npm 包 | `@zhinikefu/zhini-mcp-service` |\n\n## 数据与权限说明\n\n- 服务能力为只读查询，不执行消息发送、客户资料修改、标签修改、会话接待、转接或关闭等操作。\n- 查询结果受当前 API Key 对应的数据权限约束。\n- API Key 应保存在客户端环境变量或安全配置中。\n- “微信”“抖音”“小红书”“微博”等名称用于说明已接入的数据来源渠道，不代表相关平台对本产品的官方背书。\n\n## 关键词\n\n多平台客户数据 MCP、客户资料查询 MCP、客服会话查询 MCP、历史会话分析、客户画像、客户分群、投诉会话分析、销售线索识别、多平台客服、omnichannel customer data、customer conversation search、customer profile lookup、customer segmentation、read-only customer data。\n\n",
  "bytes": 3092,
  "sha": "101d082a47d51842e7a7bc42c2422489a230889b72a97464378904a3d703a543",
  "repo_slug": "zhinikefu/zhini-ai-assistant-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_zhinikefu_zhini_ai_assistant_ff2703b0/readme"
}