Skip to main content
Glama
Freshservice MCP Server
by tannertm0

freshservice-mcp

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

功能

53 个工具,涵盖 9 个类别:

类别

工具数量

描述

工单

9

列出、获取、创建、更新、删除、回复、添加备注、对话、搜索

资产

5

列出、获取、创建、更新、删除

人员

8

请求者、代理、组、部门(列出 + 获取)

工单任务

5

列出、获取、创建、更新、删除工单子任务

时间条目

4

列出、创建、更新、删除时间日志

变更

5

列出、获取、创建、更新、删除变更请求

问题

5

列出、获取、创建、更新、删除问题记录

服务目录

3

浏览目录项、获取详情、提交服务请求

知识库

9

分类、文件夹、文章(完整 CRUD)

Related MCP server: Service Desk Plus MCP Server

快速入门

前置要求

通过 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

Available Tools

53 tools
add_note_to_ticketC

Add a note to a Freshservice ticket

Inputs: ticket_id (required), body (required), private.

create_assetC

Create a new Freshservice asset

Inputs: name (required), asset_type_id (required), description, user_id, +3 more.

create_changeC

Create a new Freshservice change request

Inputs: subject (required), description (required), requester_id (required), priority, +9 more.

create_problemC

Create a new Freshservice problem

Inputs: subject (required), description (required), requester_id (required), priority, +7 more.

create_solution_articleC

Create a new knowledge base article

Inputs: title (required), description (required), folder_id (required), status, +1 more.

create_ticketC

Create a new Freshservice ticket

Inputs: subject (required), description (required), email, requester_id, +10 more.

create_ticket_taskC

Create a new task on a Freshservice ticket

Inputs: ticket_id (required), title (required), description, status, +3 more.

create_time_entryB

Log time spent on a Freshservice ticket

Inputs: ticket_id (required), agent_id (required), time_spent (required), note, +2 more.

delete_assetC

Delete a Freshservice asset

Inputs: display_id (required).

delete_changeC

Delete a Freshservice change request

Inputs: change_id (required).

delete_problemB

Delete a Freshservice problem

Inputs: problem_id (required).

delete_solution_articleC

Delete a knowledge base article

Inputs: article_id (required).

delete_ticketC

Delete a Freshservice ticket (moves to trash)

Inputs: ticket_id (required).

delete_ticket_taskC

Delete a task from a Freshservice ticket

Inputs: ticket_id (required), task_id (required).

delete_time_entryC

Delete a time entry from a Freshservice ticket

Inputs: ticket_id (required), entry_id (required).

get_agentC

Get details of a specific agent

Inputs: agent_id (required).

get_assetC

Get details of a specific asset

Inputs: display_id (required).

get_changeC

Get details of a specific change request

Inputs: change_id (required).

get_departmentB

Get details of a specific department

Inputs: department_id (required).

get_groupB

Get details of a specific agent group

Inputs: group_id (required).

get_problemB

Get details of a specific Freshservice problem

Inputs: problem_id (required).

get_requesterC

Get details of a specific requester

Inputs: requester_id (required).

get_service_catalog_itemC

Get details of a specific service catalog item

Inputs: item_id (required).

get_solution_articleC

Get a knowledge base article with full content

Inputs: article_id (required).

get_solution_categoryC

Get details of a knowledge base category

Inputs: category_id (required).

get_solution_folderC

Get details of a knowledge base folder

Inputs: folder_id (required).

get_ticketB

Get details of a specific Freshservice ticket

Inputs: ticket_id (required).

get_ticket_conversationsB

Get all conversations (replies and notes) for a ticket

Inputs: ticket_id (required).

get_ticket_taskB

Get details of a specific task on a ticket

Inputs: ticket_id (required), task_id (required).

list_agentsC

List Freshservice agents (support staff)

Inputs: page, per_page, email, active.

list_assetsC

List Freshservice assets/configuration items

Inputs: page, per_page.

list_changesC

List Freshservice change requests

Inputs: page, per_page, filter, order_by, +1 more.

list_departmentsC

List Freshservice departments

Inputs: page, per_page.

list_groupsC

List Freshservice agent groups

Inputs: page, per_page.

list_problemsC

List Freshservice problems

Inputs: page, per_page, order_by, order_type.

list_requestersC

List Freshservice requesters (end users)

Inputs: page, per_page, email.

list_service_catalog_itemsC

List items in the Freshservice service catalog

Inputs: page, per_page.

list_solution_articlesC

List articles in a knowledge base folder

Inputs: folder_id (required), page, per_page.

list_solution_categoriesC

List knowledge base categories in Freshservice

Inputs: page, per_page.

list_solution_foldersC

List folders in a knowledge base category

Inputs: category_id (required), page, per_page.

list_ticketsC

List Freshservice tickets with optional filters

Inputs: page, per_page, filter, requester_id, +4 more.

list_ticket_tasksC

List all tasks for a Freshservice ticket

Inputs: ticket_id (required).

list_time_entriesC

List time entries for a Freshservice ticket

Inputs: ticket_id (required).

place_service_requestC

Place a service request from the Freshservice catalog

Inputs: item_id (required), quantity, email, custom_fields.

reply_to_ticketC

Reply to a Freshservice ticket

Inputs: ticket_id (required), body (required), cc_emails, bcc_emails.

search_ticketsC

Search/filter Freshservice tickets using a query string

Inputs: query (required).

update_assetC

Update an existing Freshservice asset

Inputs: display_id (required), name, description, user_id, +3 more.

update_changeC

Update an existing Freshservice change request

Inputs: change_id (required), subject, description, priority, +8 more.

update_problemC

Update an existing Freshservice problem

Inputs: problem_id (required), subject, description, priority, +6 more.

update_solution_articleC

Update an existing knowledge base article

Inputs: article_id (required), title, description, status, +1 more.

update_ticketC

Update an existing Freshservice ticket

Inputs: ticket_id (required), subject, description, priority, +7 more.

update_ticket_taskC

Update a task on a Freshservice ticket

Inputs: ticket_id (required), task_id (required), title, description, +4 more.

update_time_entryC

Update a time entry on a Freshservice ticket

Inputs: ticket_id (required), entry_id (required), time_spent, note, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 53 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes targeting specific resources and actions (e.g., create_ticket vs. update_ticket vs. delete_ticket). However, some potential overlap exists between list_tickets and search_tickets, and between get_ticket and get_ticket_conversations, which could cause minor confusion for agents about which to use in certain scenarios.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout (e.g., create_ticket, list_agents, get_asset, update_problem, delete_change). All tools use snake_case with clear, predictable naming conventions, making them easily readable and systematic.

    Tool Count2/5

    With 53 tools, the count is excessively high for a single server, likely overwhelming for agents to navigate efficiently. While Freshservice is a comprehensive ITSM platform, this many tools suggests over-fragmentation of operations that could be consolidated or scoped more narrowly.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage across all key Freshservice domains (tickets, assets, changes, problems, solutions, agents, requesters, etc.). It includes all essential operations from listing and getting to creating, updating, and deleting, with no obvious gaps for core workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI models to interact with Freshservice IT service management platform, allowing automated ticket management, change requests, asset tracking, and solution article operations through natural language commands.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Integrates with Service Desk Plus Cloud API to enable AI assistants perform CRUD operations on service desk entities, including request management, technician management, and email communication.
      4
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides AI assistants with structured access to the Freshdesk customer support platform, including tickets, contacts, companies, agents, groups, knowledge base, and SLA configuration. Features decision-tree navigation and destructive-action guardrails.
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI models to perform IT service management operations on Freshservice, including managing tickets, changes, problems, releases, assets, projects, and more through a set of MCP tools.
      36
      2
      MIT