---

name: freshservice-automation description: "通过 Rube MCP (Composio) 自动化 Freshservice ITSM 任务：创建/更新工单、批量操作、服务请求和外发邮件。始终先搜索工具以获取当前架构。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Freshservice 自动化

通过 Rube MCP 的 Composio Freshservice 工具包自动化 Freshservice IT 服务管理操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Freshservice 连接，工具包为 freshservice
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 freshservice 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，按照返回的认证链接完成 Freshservice 认证
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 列出和搜索工单

何时使用：用户想要查找、列出或搜索工单

工具序列：

1. FRESHSERVICE_LIST_TICKETS - 列出工单，支持可选过滤和分页 [必需]
2. FRESHSERVICE_GET_TICKET - 获取特定工单的详细信息 [可选]

列出的关键参数：

• filter：预定义过滤器（'all_tickets'、'deleted'、'spam'、'watching'）
• updated_since：ISO 8601 时间戳，获取此时间之后更新的工单
• order_by：排序字段（'created_at'、'updated_at'、'status'、'priority'）
• order_type：排序方向（'asc' 或 'desc'）
• page：页码（从 1 开始）
• per_page：每页结果数（1-100，默认 30）
• include：附加字段（'requester'、'stats'、'description'、'conversations'、'assets'）

获取的关键参数：

• ticket_id：唯一工单 ID 或 display_id
• include：要包含的附加字段

注意事项：

• 默认只返回过去 30 天内创建的工单
• 使用 updated_since 检索更早的工单
• 每个 include 值消耗额外的 API 配额
• page 从 1 开始；最小值为 1
• per_page 最大为 100；默认为 30
• 工单 ID 可以是内部 ID 或 UI 中显示的 display_id

2. 创建工单

何时使用：用户想要记录新的事件或请求

工具序列：

1. FRESHSERVICE_CREATE_TICKET - 创建新工单 [必需]

关键参数：

• subject：工单主题行（必需）
• description：工单的 HTML 描述（必需）
• status：工单状态 - 2（开放）、3（待处理）、4（已解决）、5（已关闭）（必需）
• priority：工单优先级 - 1（低）、2（中）、3（高）、4（紧急）（必需）
• email：请求者的邮箱地址（提供 email 或 requester_id）
• requester_id：请求者的用户 ID

注意事项：

• 必须提供 email 或 requester_id 之一
• description 支持 HTML 格式
• 状态和优先级使用数字代码，不是文本

3. 更新工单

何时使用：用户想要修改现有工单

工具序列：

1. FRESHSERVICE_UPDATE_TICKET - 更新工单属性 [必需]

关键参数：

• ticket_id：要更新的工单 ID（必需）
• status、priority、subject、description 等可选字段

4. 批量操作

何时使用：用户需要对多个工单执行相同操作

工具序列：

1. FRESHSERVICE_LIST_TICKETS - 获取目标工单列表 [前置]
2. 循环调用 FRESHSERVICE_UPDATE_TICKET - 逐个更新 [必需]

5. 发送外发邮件

何时使用：用户想要通过工单发送邮件通知

工具序列：

1. FRESHSERVICE_SEND_REPLY - 发送工单回复/邮件 [必需]

通用注意事项

• 始终先调用 RUBE_SEARCH_TOOLS 获取最新的工具架构和参数
• Freshservice API 有速率限制；在批量操作之间添加适当延迟
• 某些操作需要特定的代理权限级别
• 工单字段可能因 Freshservice 实例配置而异