freshservice-mcp

一个将 AI 助手连接到您的 Freshservice ITSM 实例的 MCP（模型上下文协议）服务器。通过自然语言管理工单、资产、变更、问题、服务目录、知识库等。

功能

53 个工具，涵盖 9 个类别：

类别	工具数量	描述
工单	9	列出、获取、创建、更新、删除、回复、添加备注、对话、搜索
资产	5	列出、获取、创建、更新、删除
人员	8	请求者、代理、组、部门（列出 + 获取）
工单任务	5	列出、获取、创建、更新、删除工单子任务
时间条目	4	列出、创建、更新、删除时间日志
变更	5	列出、获取、创建、更新、删除变更请求
问题	5	列出、获取、创建、更新、删除问题记录
服务目录	3	浏览目录项、获取详情、提交服务请求
知识库	9	分类、文件夹、文章（完整 CRUD）

快速入门

前置要求

Node.js 18+
具有 API 访问权限的 Freshservice 账户
您的 Freshservice API 密钥（个人资料图标 > 个人资料设置 > 右侧面板上的 API 密钥）

通过 npx 安装（推荐）

无需安装。配置您的 MCP 客户端以运行：

{
  "mcpServers": {
    "freshservice": {
      "command": "npx",
      "args": ["-y", "freshservice-mcp"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

全局安装

npm install -g freshservice-mcp

然后配置您的 MCP 客户端：

{
  "mcpServers": {
    "freshservice": {
      "command": "freshservice-mcp",
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

从源码安装

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install

{
  "mcpServers": {
    "freshservice": {
      "command": "node",
      "args": ["/path/to/freshservice-mcp/src/index.js"],
      "env": {
        "FRESHSERVICE_DOMAIN": "yourcompany",
        "FRESHSERVICE_API_KEY": "your-api-key"
      }
    }
  }
}

配置

变量	必需	描述
`FRESHSERVICE_DOMAIN`	是	您的 Freshservice 子域名（例如 `yourcompany`，对应 `yourcompany.freshservice.com`）
`FRESHSERVICE_API_KEY`	是	您的 Freshservice API 密钥

MCP 客户端设置

Claude Desktop - 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)

Claude Code - 运行 claude mcp add freshservice -- npx -y freshservice-mcp 然后设置环境变量

Cursor / VS Code - 按照编辑器文档添加到您的 MCP 设置中

可用工具

工单

工具	描述
`list_tickets`	按过滤器（状态、优先级、请求者、日期）列出工单
`get_ticket`	获取完整工单详情
`create_ticket`	创建新工单
`update_ticket`	更新工单字段（状态、优先级、分配等）
`delete_ticket`	删除工单（移至回收站）
`reply_to_ticket`	发送工单回复
`add_note_to_ticket`	添加公开或私有备注
`get_ticket_conversations`	查看所有回复和备注
`search_tickets`	使用查询语法过滤工单

资产

工具	描述
`list_assets`	列出所有资产/CI
`get_asset`	获取包含自定义字段的资产详情
`create_asset`	注册新资产
`update_asset`	更新资产字段
`delete_asset`	移除资产

人员与组织

工具	描述
`list_requesters` / `get_requester`	最终用户
`list_agents` / `get_agent`	支持人员
`list_groups` / `get_group`	包含成员的代理组
`list_departments` / `get_department`	部门

工单任务

工具	描述
`list_ticket_tasks`	列出工单上的子任务
`get_ticket_task`	获取任务详情
`create_ticket_task`	向工单添加任务
`update_ticket_task`	更新任务状态/分配
`delete_ticket_task`	移除任务

时间条目

工具	描述
`list_time_entries`	查看工单上记录的时间
`create_time_entry`	记录花费的时间
`update_time_entry`	修改时间条目
`delete_time_entry`	移除时间条目

变更

工具	描述
`list_changes`	列出变更请求
`get_change`	获取变更详情（类型、风险、计划）
`create_change`	创建变更请求
`update_change`	更新变更字段
`delete_change`	删除变更

问题

工具	描述
`list_problems`	列出问题记录
`get_problem`	获取问题详情
`create_problem`	创建问题记录
`update_problem`	更新问题字段
`delete_problem`	删除问题

服务目录

工具	描述
`list_service_catalog_items`	浏览可用服务
`get_service_catalog_item`	获取服务详情和必需字段
`place_service_request`	提交服务请求

知识库

工具	描述
`list_solution_categories` / `get_solution_category`	浏览知识库分类
`list_solution_folders` / `get_solution_folder`	浏览知识库文件夹
`list_solution_articles` / `get_solution_article`	阅读文章
`create_solution_article`	撰写新文章
`update_solution_article`	编辑文章
`delete_solution_article`	移除文章

示例提示词

配置完成后，您可以询问 AI 助手如下内容：

“显示所有打开的 P1 工单”
“为三楼离线的打印机创建一个工单”
“John Smith 分配了哪些资产？”
“给工单 #5678 添加一条私有备注，说明我们正在等待供应商回复”
“为下周二计划的防火墙升级创建一个变更请求”
“在知识库中搜索 VPN 设置说明”
“在工单 #1234 上记录 2 小时，用于调试网络问题”
“显示所有打开的问题及其影响级别”
“从服务目录中提交一个新的笔记本电脑请求”

搜索查询语法

search_tickets 工具使用 Freshservice 的过滤器查询语法：

"priority:4 AND status:2"          - Urgent + Open tickets
"group_id:12345"                   - Tickets assigned to a specific group
"agent_id:67890"                   - Tickets assigned to a specific agent
"created_at:>'2024-01-01'"         - Tickets created after a date

开发

git clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install
npm test

许可证

MIT

Freshservice MCP Server