关于 Vision Helpdesk MCP by usefulapi
Vision Helpdesk MCP by usefulapi 将助手连接到 Vision Helpdesk,用于分流工单和查询客户。它支持读取工单对话及确认后修改;创建工单和回复时默认关闭客户邮件。
主要功能
- 01搜索和筛选工单
- 02查看工单详情和仪表板计数
- 03查找客户并查看摘要
- 04创建工单及添加回复或备注
- 05更新工单属性和员工分配
适用场景
- 01按状态、标签或优先级分流工单
- 02查看工单及其对话
- 03记录内部备注或重新分配工单
MCP 相关
这是一个 MCP 服务,向 MCP 客户端提供 Vision Helpdesk 工单和客户工具,包括读取与写入操作。写入需要明确确认;创建工单和回复时默认关闭客户邮件。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://vision-helpdesk.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-vision-helpdesk https://vision-helpdesk.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-vision-helpdesk":{"type":"http","url":"https://vision-helpdesk.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-vision-helpdesk":{"type":"http","url":"https://vision-helpdesk.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-vision-helpdesk":{"type":"http","url":"https://vision-helpdesk.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-vision-helpdesk":{"serverUrl":"https://vision-helpdesk.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
usefulapi 的 Vision Helpdesk MCP
在 https://vision-helpdesk.usefulapi.io/mcp 连接你的助手。
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://vision-helpdesk.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http vision-helpdesk https://vision-helpdesk.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code:添加到 VS Code。
- **Cursor 和其他客户端:**将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"vision-helpdesk": {
"url": "https://vision-helpdesk.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Vision Helpdesk 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/vision-helpdesk/
输入你的公开 HTTPS 帮助台地址,以及管理员或员工 API 访问令牌(vis_txttoken)。如果你还没有令牌,请向帮助台管理员索取。你的角色需要具备 API Access 权限,并且供应商的 Starter 方案不包含 REST API。
请使用托管帮助台的 URL,或可从公网访问的安装地址;如适用,请包含其文件夹路径。连接器只会将令牌发送到该地址,并且不会跟随 API 重定向。
每次写入操作都需要明确确认。创建工单和回复默认不会向客户发送电子邮件。内部工单会保持私密,且不能包含客户端收件人或客户电子邮件标记。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
vision_get_dashboard_counts | 读取 | 获取仪表板计数 |
vision_list_tickets | 读取 | 列出工单 |
vision_search_tickets | 读取 | 按引用编号或主题搜索工单 |
vision_get_ticket | 读取 | 获取工单 |
vision_list_tickets_by_tag | 读取 | 按标签列出工单 |
vision_list_tickets_by_label | 读取 | 按标记列出工单 |
vision_list_statuses | 读取 | 列出工单状态 |
vision_list_priorities | 读取 | 列出工单优先级 |
vision_list_ticket_types | 读取 | 列出工单类型 |
vision_list_clients | 读取 | 列出客户端 |
vision_search_clients | 读取 | 搜索客户端 |
vision_get_client_summary | 读取 | 获取客户端摘要 |
vision_create_ticket | 写入 | 创建工单 |
vision_reply_to_ticket | 写入 | 回复工单 |
vision_add_ticket_note | 写入 | 添加工单备注 |
vision_add_client_note | 写入 | 添加客户端备注 |
vision_update_ticket_property | 写入 | 更新工单状态、优先级、部门或类型 |
vision_assign_ticket_staff | 写入 | 分配或取消分配工单员工 |
vision_add_ticket_tag | 写入 | 为工单添加标签 |
vision_usage_status | 元数据 | 使用情况(免费层计量) |
vision_request_feature | 元数据 | 请求添加缺失功能 |
vision_upgrade | 元数据 | 升级到 Pro(无限量*) |
vision_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应先确认);meta 工具用于报告使用情况、管理订阅或发送功能请求。
定价
| 方案 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(每个帮助台) | $9/mo 或 $90/yr(免费 2 个月) | 无限量* |
*此服务上的 Pro 方案设有每月 10,000 次工具调用的合理使用限额。如需更多调用,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 vision_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 vision_cancel_subscription 取消:Pro 将持续至已付费周期结束,当前周期不予退款;在此之前运行 vision_upgrade 则会撤销取消操作。也可以发送邮件至 [email protected]。
许可证
MIT。由 usefulapi 独立集成,与 Vision Helpdesk 无关。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。