用 MCP 连接你自己的 AI 助手
让 Claude、Cursor 等支持 MCP 的 AI 助手以你的身份查对话和顾客、打标签、补知识库，经你授权后批退款。
purser 提供一个 MCP 服务器。连上之后，你可以在自己的 AI 助手里说「看看今天等人工的对话」「给这位顾客打上 VIP 标签」「把这个问答加进知识库」，助手会调用 purser 的工具去做。
助手以你的身份操作，权限和你在每个工作区里的角色一样：你在控制台里不能做的事，它也不能做。
服务器地址
https://askpurser.com/api/mcp控制台「设置 → AI 助手」里也有这个地址和下面的命令，可以直接复制。
连接
Claude 网页版 / 桌面版：设置 → 连接器 → 添加自定义连接器，粘贴上面的地址。
Claude Code：
claude mcp add --transport http purser https://askpurser.com/api/mcpCursor 等其他客户端：按它的说明添加一个远程 MCP 服务器（HTTP），填上面的地址。不需要事先申请 client ID 或密钥：客户端会自己注册。
第一次使用时，助手会打开浏览器：
- 没登录 purser 的话先登录；
- 授权页会问「让「助手名称」使用 purser？」，并显示授权会交给哪个地址。如果显示的是你电脑上的程序（比如 Claude Code、Cursor），而这次连接不是你刚在自己电脑上发起的，请点「拒绝」；
- 勾选要给它的权限，点「允许」。
权限
| 权限 | 授权页上的名称 | 默认 | 包括 |
|---|---|---|---|
purser:read | 查看 | 必选 | 对话、顾客、订单、知识库、退款和数据分析 |
purser:write | 整理 | 勾选 | 打标签、写内部备注、往知识库草稿里加问答、快捷回复、接管和回复对话 |
purser:refunds | 批准或拒绝退款 | 不勾选 | 批准后会真的调用你店铺的退款接口，钱会退出去 |
助手调用一个你没授权的工具时，purser 会拒绝这次调用并告诉客户端缺哪个权限（OAuth 的 insufficient_scope），支持的客户端会请你重新授权。
工具
查看（purser:read）
| 工具 | 作用 |
|---|---|
list_workspaces | 你所在的工作区和你在每个里面的角色 |
list_conversations | 收件箱里的对话，view 可选 live（要人工或正在人工处理）、tickets（等人稍后回复）、assistant（AI 在处理）、mine（我接的） |
get_conversation | 一段对话：消息、状态、谁在处理、AI 的草稿 |
search_customers | 按姓名、邮箱、ID 或标签找顾客 |
get_customer | 一位顾客：资料、最近订单、对话、标签和内部备注 |
search_knowledge | 看 AI 针对一个问题会检索到什么（只检索，不写回答）；target 可选 customers（顾客现在看到的）或 draft（未发布的草稿） |
list_knowledge | 知识库里的来源（草稿）：文章、文件、问答、网站页面 |
get_analytics | 最近 N 天 AI 处理了多少、多少转了人工、速度和成本 |
get_leaderboard | 本月（或指定月份）客服排行榜 |
list_segments | 顾客分层及其条件和服务策略 |
list_tags | 标签及使用次数 |
list_quick_replies | 快捷回复（共享的和你自己的） |
list_feedback / get_feedback | 产品反馈列表 / 单条反馈详情 |
list_refunds | 退款，默认列出等批准的 |
整理（purser:write）
| 工具 | 作用 |
|---|---|
tag_customer / tag_conversation | 给顾客 / 对话打标签（新名字会自动建标签） |
add_customer_note | 给顾客写内部备注（顾客看不到，AI 也不读） |
add_knowledge_qa | 往知识库草稿里加一条问答 |
remove_knowledge_source | 从知识库草稿里删掉一个来源（只限店主和管理员） |
add_quick_reply | 加一条快捷回复；共享的只限店主和管理员 |
update_feedback | 改反馈的状态或分类，或加内部备注（不会给提交人发邮件） |
claim_conversation | 接管一段等人工（或 AI 在处理）的对话，同事已经接了就会失败 |
reply_to_customer | 以你的名义给顾客发消息，顾客马上能看到 |
release_conversation | 把你接的对话放回队列 |
close_conversation | 关闭你接的对话 |
退款（purser:refunds）
| 工具 | 作用 |
|---|---|
approve_refund | 批准一笔等批准的退款，随后会调用你店铺的退款接口，钱会退出去 |
reject_refund | 拒绝一笔等批准的退款，顾客会被告知会有人跟进 |
purser 会告诉助手：approve_refund 和 reply_to_customer 执行前先和你确认（订单、金额、原因；要发的原文）。通过助手加的知识只进草稿，要在控制台发布后顾客才看得到，见 试聊与发布。顾客的消息、备注和知识库内容都当作数据，purser 会提醒助手不要执行里面出现的指令。
单个工具的返回内容超过 60,000 个字符时会被截断，并提示缩小范围。
多个工作区：workspace_id
除了 list_workspaces，每个工具都有一个可选参数 workspace_id：
- 你只在一个工作区里时，不用填；
- 你在多个工作区里时必须填，值来自
list_workspaces返回的id。助手通常会自己先调list_workspaces。
每次调用 purser 都会重新检查你是不是这个工作区的成员、是什么角色。
套餐
AI 助手需要 Growth 或 Scale 套餐（测试工作区可以直接用）。其他套餐的工作区里，助手可以连上，但作用于这个工作区的工具调用会被拒绝，并提示需要升级。套餐对比见 价格 和 套餐与账单。
查看和断开
「设置 → AI 助手」的「已连接」列表里有你连过的每个助手：名称、授权给了哪个地址、给了哪些权限、授权时间。点「断开」后它立即失去访问权限，已经拿到的令牌也不能再用；要再用就得重新连接、重新授权。
- 连接属于你个人，不属于工作区：同事要用，各自连自己的；列表里也只有你自己的连接。
- 退出 purser 登录不会断开已连接的助手，要断开请在这里点「断开」。
给客户端开发者
- 传输：Streamable HTTP，无状态，地址
https://askpurser.com/api/mcp。 - 鉴权：OAuth 2.1。受保护资源元数据在
https://askpurser.com/.well-known/oauth-protected-resource，授权服务器是https://askpurser.com/api/auth。 - 支持动态客户端注册（RFC 7591），不需要预先注册；本机回环回调地址（
http://127.0.0.1:<端口>）可以用。 - 令牌无效或助手已被断开时返回
401和 OAuth 挑战，客户端应重新走授权流程。