Freshservice MCP Server

概述

这是一个强大的MCP（模型上下文协议）服务器实现，无缝集成到Freshservice中，使AI模型能够与Freshservice模块交互并执行各种IT服务管理操作。这种集成桥接使您的AI助手能够管理和解决IT服务工单，简化您的支持工作流程。

主要特性

• 企业级Freshservice集成：与Freshservice API端点进行直接、安全的通信
• AI模型兼容性：使Claude和其他AI模型能够通过Freshservice执行服务台操作
• 自动化ITSM管理：高效处理工单创建、更新、响应和资产管理
• 工作流加速：减少在常规IT服务任务中的手动干预

支持的Freshservice模块

此MCP服务器当前支持广泛的Freshservice模块的操作：

• 工单
• 变更
• 对话
• 产品
• 请求者
• 代理
• 代理组
• 请求者组
• 预定义回复
• 预定义回复文件夹
• 工作区
• 解决方案类别
• 解决方案文件夹
• 解决方案文章

组件及工具

该服务器提供了一整套用于Freshservice操作的工具包：

工单管理

工具	描述	关键参数
create_ticket	创建新的服务工单	subject, description, source, priority, status, email
update_ticket	更新现有工单	ticket_id, updates
delete_ticket	删除工单	ticket_id
filter_tickets	查找符合标准的工单	query
get_ticket_fields	获取工单字段定义	无
get_tickets	列出所有工单（分页）	page, per_page
get_ticket_by_id	获取单个工单详情	ticket_id

变更管理

工具	描述	关键参数
get_changes	列出所有变更（分页）	page, per_page, query
filter_changes	使用高级查询过滤变更	query, page, per_page
get_change_by_id	获取单个变更详情	change_id
create_change	创建新的变更请求	requester_id, subject, description, priority, impact, status, risk, change_type
update_change	更新现有变更	change_id, change_fields
close_change	关闭变更并解释结果	change_id, change_result_explanation
delete_change	删除变更	change_id
get_change_tasks	获取变更的任务	change_id
create_change_note	向变更添加备注	change_id, body

🚨 重要提示：过滤查询语法

使用get_changes或filter_changes时，如果带有query参数，查询字符串必须用双引号包裹，以确保Freshservice API正常工作：

✅ 正确： "status:3", "approval_status:1 AND status:<6"
❌ 错误： status:3 （会导致500内部服务器错误）

常见查询示例：

• "status:3" - 等待审批的变更
• "approval_status:1" - 已批准的变更
• "approval_status:1 AND status:<6" - 未关闭的已批准变更
• "planned_start_date:>'2025-07-14'" - 在特定日期之后开始的变更
• "status:3 AND priority:1" - 等待审批的高优先级变更

快速入门

通过Smithery安装

要通过Smithery自动安装freshservice_mcp：

npx -y @smithery/cli install @effytech/freshservice_mcp --client claude

先决条件

• 一个Freshservice账户（在freshservice.com注册）
• Freshservice API密钥
• 安装了uvx（pip install uv 或 brew install uv）

配置

1. 从管理面板生成您的Freshservice API密钥：

   • 导航至个人设置 → API设置
   • 复制您的API密钥用于配置

2. 如下所示设置您的域名和身份验证详细信息

与Claude桌面版一起使用

1. 从官方网站安装Claude桌面版
2. 将以下配置添加到您的claude_desktop_config.json：

"mcpServers": {
  "freshservice-mcp": {
    "command": "uvx",
    "args": [
        "freshservice-mcp"
    ],
    "env": {
      "FRESHSERVICE_APIKEY": "<YOUR_FRESHSERVICE_APIKEY>",
      "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>"
    }
  }
}

重要：将<YOUR_FRESHSERVICE_APIKEY>替换为您实际的API密钥，并将<YOUR_FRESHSERVICE_DOMAIN>替换为您的域名（例如，yourcompany.freshservice.com）

示例操作

配置完成后，您可以要求Claude执行如下操作：

工单：

• "创建一个新的主题为'Marketing部门网络连接问题'且描述为'营销区域用户无法连接Wi-Fi'的高优先级事件工单"
• "列出过去24小时内报告的所有关键事件"
• "将工单#12345的状态更新为已解决"

变更：

• "创建一个计划于下周二凌晨2点进行的服务器维护变更请求"
• "将变更请求#45678的状态更新为'已批准'"
• "以结果说明'成功部署到生产环境。所有测试均通过。'关闭变更#5092"
• "列出所有待处理变更"

其他操作：

• "显示资产标签为'LT-2023-087'的笔记本电脑的资产详情"
• "创建一篇关于密码重置程序的解决方案文章"

测试

为了测试目的，您可以手动启动服务器：

uvx freshservice-mcp --env FRESHSERVICE_APIKEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>

故障排除

• 核实您的Freshservice API密钥和域名是否正确
• 确保与Freshservice服务器有正确的网络连接
• 检查API速率限制和配额
• 核实uvx命令是否在您的PATH中可用

许可证

此MCP服务器根据MIT许可证发布。请参阅项目存储库中的LICENSE文件以获取详细信息。

额外资源

• Freshservice API文档
• Claude桌面版集成指南
• MCP协议规范

---

<p align="center">由effy用心打造</p>