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傾心打造