Freshservice MCP 服务器

概述

强大的 MCP（模型控制协议）服务器实现，可与 Freshservice 无缝集成，使 AI 模型能够与 Freshservice 模块交互并执行各种 IT 服务管理操作。此集成桥使您的 AI 助手能够管理和解决 IT 服务工单，从而简化您的支持工作流程。

Related MCP server: Freshdesk MCP Server by CData

主要特点

• 企业级 Freshservice 集成：与 Freshservice API 端点直接、安全地通信

• AI 模型兼容性：使 Claude 和其他 AI 模型能够通过 Freshservice 执行服务台操作

• 自动化 ITSM 管理：高效处理票证创建、更新、响应和资产管理

• 工作流程加速：减少日常 IT 服务任务中的人工干预

支持的 Freshservice 模块

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

• 门票

• 对话

• 产品

• 请求者

• 代理商

• 代理组

• 请求者组

• 预设回复

• 预设回复文件夹

• 工作区

• 解决方案类别

• 解决方案文件夹

• 解决方案文章

组件和工具

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

票务管理

入门

通过 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 Desktop 一起使用

1. 从官方网站安装Claude Desktop

2. 将以下配置添加到您的claude_desktop_config.json ：

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

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

示例操作

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

• 创建一个新的事件单，主题为‘市场部门的网络连接问题’，描述为‘用户无法连接到市场区域的 Wi-Fi’，并将优先级设置为高”

• “将变更请求 #45678 的状态更新为‘已批准’”

• “列出过去 24 小时内报告的所有重大事件”

• “显示资产标签为‘LT-2023-087’的笔记本电脑的资产详细信息”

• “创建下周二凌晨 2 点的预定服务器维护变更请求”

测试

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

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

故障排除

• 验证您的 Freshservice API 密钥和域是否正确

• 确保与 Freshservice 服务器的网络连接正常

• 检查 API 速率限制和配额

• 验证uvx命令是否在您的 PATH 中可用

执照

此 MCP 服务器采用 MIT 许可证。请参阅项目仓库中的 LICENSE 文件以了解更多详细信息。

其他资源

• Freshservice API 文档

• Claude 桌面集成指南

• MCP 协议规范