Freshservice MCP Server
概述
一个强大的 MCP（Model Control Protocol）服务器实现，与 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 |
search_tickets | 查找符合条件的工单 | query |
get_ticket_fields | 获取工单字段定义 | 无 |
get_tickets | 分页列出所有工单 | page, per_page |
get_ticket | 获取单个工单详情 | ticket_id |
快速开始
通过 Smithery 安装
通过 Smithery 自动安装 freshservice_mcp：
先决条件
- Freshservice 账户（在 freshservice.com 注册）
- Freshservice API 密钥
- 已安装
uvx（pip install uv或brew install uv）
配置
- 从管理面板生成 Freshservice API 密钥：
- 导航到 Profile Settings → API Settings
- 复制 API 密钥以进行配置
- 如下所示设置您的域名和认证信息
与 Claude Desktop 集成使用
- 从 官方网站 安装 Claude Desktop
- 将以下配置添加到
claude_desktop_config.json中：
重要提示：将
<YOUR_FRESHSERVICE_API_KEY> 替换为您的实际 API 密钥，并将 <YOUR_FRESHSERVICE_DOMAIN> 替换为您的域名（例如 yourcompany.freshservice.com）示例操作
配置完成后，您可以要求 Claude 执行以下操作：
- "创建一个新的工单，主题为 '市场部网络连接问题'，描述为 '市场部用户无法连接 Wi-Fi'，优先级设为高"
- "将变更请求 #45678 的状态更新为 '已批准'"
- "列出过去 24 小时内报告的所有严重事件"
- "显示资产标签为 'LT-2023-087' 的笔记本电脑的详细信息"
- "为下周二凌晨 2 点的计划服务器维护创建一个变更请求"
测试
出于测试目的，您可以手动启动服务器：
故障排除
- 确认您的 Freshservice API 密钥和域名正确无误
- 确保与 Freshservice 服务器的网络连接正常
- 检查 API 速率限制和配额
- 确认
uvx命令在您的 PATH 中可用
许可证
该 MCP 服务器采用 MIT 许可证授权。有关完整详细信息，请参阅项目仓库中的 LICENSE 文件。
其他资源
- Author:waytomcp
- URL:https://www.waytomcp.com/article/effytech/freshservice_mcp
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
