用途:通过 Composio 的 HelpDesk 工具包,借助 Rube MCP 自动化帮助台工单操作。工具包文档:composio.dev/toolkits/helpdesk。
前提条件:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit helpdesk 建立有效的 HelpDesk 连接;始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式。
设置:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥。确认 RUBE_SEARCH_TOOLS 响应;调用 RUBE_MANAGE_CONNECTIONS 并选择 helpdesk;若连接非 ACTIVE,按返回的授权链接完成认证;确认状态为 ACTIVE 后再运行工作流。
主要能力:HELPDESK_LIST_TICKETS 列出工单,支持 silo(tickets、archive、trash、spam,默认 tickets)、sortBy(createdAt、updatedAt、lastMessageAt,默认 createdAt)、order(asc、desc,默认 desc)、pageSize(1-100,默认 20)及 next.value/next.ID、prev.value/prev.ID 游标分页。HELPDESK_LIST_VIEWS 列出代理视图;HELPDESK_LIST_CANNED_RESPONSES 获取预设回复模板;HELPDESK_LIST_CUSTOM_FIELDS 查看自定义字段定义。
使用方式:先搜索工具,再按序调用对应 slug。分页需同时使用时间戳与 ID 游标,前后向游标不可混用。
限制:当前工具包主要提供列表/读取操作,工单创建、更新与回复可能需其他工具;视图、预设回复、自定义字段在 HelpDesk UI 中管理,无法通过 API 创建或修改;各 silo 独立,无跨 silo 搜索;API 有账户级速率限制,429 时需退避;响应可能嵌套在 data 或 data.data 下,需防御性解析;工单 ID 为字符串。若资料未提供的内容暂未提供。