Go
Apache 2.0
Freshservice MCP 服务器
概述
强大的 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 |
search_tickets | 查找符合条件的票证 | query |
get_ticket_fields | 检索票证字段定义 | 没有任何 |
get_tickets | 列出所有票证并分页 | page ， per_page |
get_ticket | 检索单张票的详细信息 | ticket_id |
入门
通过 Smithery 安装
要通过 Smithery 自动安装 freshservice_mcp：
Copy
先决条件
- Freshservice 帐户（在freshservice.com注册）
- Freshservice API 密钥
- 已安装
uvx（pip install uv或brew install uv）
配置
- 从管理面板生成您的 Freshservice API 密钥：
- 导航至配置文件设置 → API 设置
- 复制您的 API 密钥以进行配置
- 设置您的域和身份验证详细信息，如下所示
与 Claude Desktop 一起使用
- 从官方网站安装Claude Desktop
- 将以下配置添加到您的
claude_desktop_config.json：
Copy
重要提示：将<YOUR_FRESHSERVICE_API_KEY>替换为您的实际 API 密钥，并将<YOUR_FRESHSERVICE_DOMAIN>替换为您的域名（例如， yourcompany.freshservice.com ）
示例操作
配置完成后，您可以要求 Claude 执行如下操作：
- 创建一个新的事件单，主题为‘市场部门的网络连接问题’，描述为‘用户无法连接到市场区域的 Wi-Fi’，并将优先级设置为高”
- “将变更请求 #45678 的状态更新为‘已批准’”
- “列出过去 24 小时内报告的所有重大事件”
- “显示资产标签为‘LT-2023-087’的笔记本电脑的资产详细信息”
- “创建下周二凌晨 2 点的预定服务器维护变更请求”
测试
为了测试目的，您可以手动启动服务器：
Copy
故障排除
- 验证您的 Freshservice API 密钥和域是否正确
- 确保与 Freshservice 服务器的网络连接正常
- 检查 API 速率限制和配额
- 验证
uvx命令是否在您的 PATH 中可用
执照
此 MCP 服务器采用 MIT 许可证。请参阅项目仓库中的 LICENSE 文件以了解更多详细信息。
其他资源
Related MCP Servers
- Python
- TypeScriptMIT License
- TypeScript