Freshservice

🚀 Freshservice MCP 服务器

一个强大的MCP（模型控制协议）服务器实现，可与Freshservice无缝集成，让AI模型与Freshservice模块交互，执行各类IT服务管理操作，简化支持工作流程。

🚀 快速开始

📦 安装指南

使用Smithery CLI进行自动安装：

smithery install @effytech/freshservice-mcp

🔧 配置说明

1. 生成Freshservice API密钥：

   • 登录到您的Freshservice账户。
   • 进入“设置” > “集成与API” > “API密钥”。
   • 创建新的API密钥并获取api_key_id和secret_key。

2. 配置环境变量：

export FRESHSERVICE_API_KEY_ID="your_api_key_id"
export FRESHSERVICE_SECRET_KEY="your_secret_key"

💻 使用Claude Desktop

将MCP服务器配置添加到claude_desktop_config.json文件中：

{
  "mcp_servers": {
    "freshservice_mcp": {
      "type": "http",
      "url": "http://localhost:8080",
      "auth": {
        "api_key_id": "your_api_key_id",
        "secret_key": "your_secret_key"
      }
    }
  }
}

✨ 主要特性

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

📚 详细文档

支持的 Freshservice 模块

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

• 票务
• 对话
• 产品
• 请求者
• 代理
• 代理组
• 请求者组
• 常用响应
• 常用响应文件夹
• 工作区
• 解决方案分类
• 解决方案文件夹
• 解决方案文章

组件与工具

服务器提供了执行Freshservice操作的全面工具包：

票务管理

💻 使用示例

基础用法

创建新票务

create_ticket \
--subject "IT支持请求" \
--description "无法访问公司网络" \
--priority "high" \
--email "support@example.com"

更新现有票务

update_ticket --ticket_id 12345 --status "in_progress"

🛠️ 测试

手动启动服务器：

uvx run freshservice-mcp:latest

❗ 故障排除

• 确保API密钥已正确设置。
• 检查网络连接是否正常。
• 验证Freshservice API文档以获取更多详细信息。

📚 参考资料

• Freshservice API 文档
• Claude Desktop集成指南
• MCP协议规范

由effy倾心打造