当前客服
查询当前调用者的客服 ID。
通过MCP将知你上的各平台客户数据接入AI客户端
Codex、Workbuddy等AI工具通过 Streamable HTTP 连接到知你AI助手的MCP后，查询客户、标签、渠道、客服及历史对话等信息。
知你MCP连接配置方法
调用限制：同一个 API Key 每秒调用不超过 5 次。
1选择AI客户端
为 Codex 生成远程 MCP 添加命令和环境变量鉴权方式。
2选择认证方式
使用已创建的 API Key，以 Bearer 方式连接。
登录后加载 API Key；页面配置示例仅展示打码后的 Key。
3获取配置并配置到AI客户端
复制提示词，让当前 AI 客户端自动完成 MCP 配置。
两种方式的区别：手动配置是自己动手逐项填写；AI 配置是把提示词发给 AI，由它自动完成全部配置。
怎么选：想省事，用 AI 配置；想自己把控每一步，用手动配置。
支持能力
连接后，AI 可以先查询客服数据，再在用户确认后批量打开会话或发送文本/图片消息。
进行中会话
查询正在接待与等待中的会话。
会话消息
按会话、消息游标或客户读取消息。
客户资料
查询客户资料、来源、负责人及标签。
搜索客户
按名称、手机号、客服、渠道或标签筛选客户。
标签分组
查询当前授权范围内的标签分组。
标签列表
分页读取指定标签分组下的标签。
搜索标签
按关键词查找标签并获取标签 ID。
客服列表
查询当前团队的客服列表。
渠道列表
查询渠道名称与渠道 ID。
搜索历史会话
查询已结束、已关闭在内的历史会话。
API Key 用量
查询账号总额、账号已用和剩余额度，以及当前 Key 实时用量。
批量打开对话
将选定用户的对话打开到当前客服“我的对话”；其他客服正在接待的会话不会转接。
批量发送文本/图片消息
用户确认后批量发送文本或图片消息，并查询发送任务进度及历史群发任务。
配置后如何使用
配置完成后，直接在 AI 客户端提问，建议带上时间范围、客户或关键词。
“看看这个客户最近聊了什么，还有哪些事情待确认？”
“现在有哪些客户正在等待接待？”
“把这 5 位客户的对话打开到我的对话。”
“筛选出最近咨询过产品的客户，批量向有意的用户发送：您考虑的怎么样了？”
“找近 7 天提到退款的历史会话。”
“找出提过报价或试用的客户。”
“搜索登录异常的历史案例，整理共同问题。”
“找出近 30 天有对话且带有高意向标签的客户。”
常见问题
连接和查询时遇到问题，可先按下面检查。
API Key 由客户端作为 Bearer 凭据发送；OAuth 2.1 由客户端打开浏览器完成知你账号登录和授权，客户端管理访问令牌，连接配置中不需要 API Key。两种方式选一种即可。
将不带 API Key 的 MCP 配置添加到支持 MCP OAuth 的客户端，首次连接时按提示登录知你账号并确认授权。若客户端不支持 OAuth，请选择 API Key 方式。
检查 URL 是否以 /mcp 结尾、客户端是否支持 Streamable HTTP，以及 API Key 是否有效。
尽量说明时间范围，并组合客户、平台、客服、标签或关键词；关键词命中后继续核对完整消息。
连接器不修改客户资料或标签。用户明确确认收件 UID、任务标题和最终内容后，首次创建调用只返回短时确认凭证；携带相同内容、confirmation_token 和 user_confirmed=true 才会创建异步任务。单次最多 100 个 UID、每个任务最多 2 条 text/image 消息。可查询任务状态和列表，删除任务不可逆且不会撤回已发送消息。