用途:通过 Rube MCP 调用 Composio 的 Freshservice 工具包,自动化 Freshservice IT 服务管理操作,包括工单查询、创建、批量更新、外发邮件工单和服务请求。
前提条件:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 以 freshservice 工具包建立并激活 Freshservice 连接;每次操作前先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。
设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit freshservice;若连接非 ACTIVE,按返回的授权链接完成认证,确认状态为 ACTIVE 后再执行工作流。
主要能力:
- 列出与搜索工单:FRESHSERVICE_LIST_TICKETS 支持 filter、updated_since、order_by、order_type、page、per_page、include 等参数;FRESHSERVICE_GET_TICKET 获取单个工单详情。默认仅返回近 30 天工单,需用 updated_since 获取更早数据;page 从 1 开始,per_page 最大 100、默认 30;每个 include 值会消耗额外 API 配额。
- 创建工单:FRESHSERVICE_CREATE_TICKET,subject、description、status、priority 必填;status 用数字(2 Open、3 Pending、4 Resolved、5 Closed),priority 用数字(1 Low、2 Medium、3 High、4 Urgent);需提供 email 或 requester_id;description 支持 HTML;邮箱不匹配现有联系人时会新建联系人。
- 批量更新:FRESHSERVICE_BULK_UPDATE_TICKETS,参数 ids 与 update_fields;允许字段包括 subject、description、status、priority、responder_id、group_id、type、tags、custom_fields;内部顺序执行,大批量可能耗时;所有工单应用相同更新;自定义字段须用内部字段名。
- 外发邮件创建工单:FRESHSERVICE_CREATE_TICKET_OUTBOUND_EMAIL,email、subject 必填,可设 description、status、priority、cc_emails、email_config_id、name;通过 /api/v2/tickets 端点创建并发送邮件。
- 创建服务请求:FRESHSERVICE_CREATE_SERVICE_REQUEST,item_display_id 必填,可设 email、quantity(默认 1)、custom_fields、parent_ticket_id;遵循目录项审批流程。
常见模式与限制:状态与优先级使用数字编码;来源渠道 1-6;影响与紧急度使用数字编码;日期过滤默认近 30 天,格式为 ISO 8601;Freshservice API 有账户级速率限制,遇 429 应退避;响应数据可能嵌套在 data 或 data.data 下,需防御性解析;工单 ID 为数字整数。
适用场景:需要以自动化方式管理 Freshservice 工单、批量操作、服务目录请求和邮件通知的 ITSM 工作流。
限制:必须依赖 Rube MCP 与已激活的 Freshservice 连接;工具结构以 RUBE_SEARCH_TOOLS 返回为准;批量更新无法为不同工单设置不同字段;include 与批量操作可能消耗额外配额或耗时。