Freshservice MCP Server
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
快速入门
前置要求
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 子域名(例如 |
| 是 | 您的 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 设置中
可用工具
工单
工具 | 描述 |
| 按过滤器(状态、优先级、请求者、日期)列出工单 |
| 获取完整工单详情 |
| 创建新工单 |
| 更新工单字段(状态、优先级、分配等) |
| 删除工单(移至回收站) |
| 发送工单回复 |
| 添加公开或私有备注 |
| 查看所有回复和备注 |
| 使用查询语法过滤工单 |
资产
工具 | 描述 |
| 列出所有资产/CI |
| 获取包含自定义字段的资产详情 |
| 注册新资产 |
| 更新资产字段 |
| 移除资产 |
人员与组织
工具 | 描述 |
| 最终用户 |
| 支持人员 |
| 包含成员的代理组 |
| 部门 |
工单任务
工具 | 描述 |
| 列出工单上的子任务 |
| 获取任务详情 |
| 向工单添加任务 |
| 更新任务状态/分配 |
| 移除任务 |
时间条目
工具 | 描述 |
| 查看工单上记录的时间 |
| 记录花费的时间 |
| 修改时间条目 |
| 移除时间条目 |
变更
工具 | 描述 |
| 列出变更请求 |
| 获取变更详情(类型、风险、计划) |
| 创建变更请求 |
| 更新变更字段 |
| 删除变更 |
问题
工具 | 描述 |
| 列出问题记录 |
| 获取问题详情 |
| 创建问题记录 |
| 更新问题字段 |
| 删除问题 |
服务目录
工具 | 描述 |
| 浏览可用服务 |
| 获取服务详情和必需字段 |
| 提交服务请求 |
知识库
工具 | 描述 |
| 浏览知识库分类 |
| 浏览知识库文件夹 |
| 阅读文章 |
| 撰写新文章 |
| 编辑文章 |
| 移除文章 |
示例提示词
配置完成后,您可以询问 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 toolsadd_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
Scored across 53 tools
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.
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.
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.
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
Related MCP Connectors
Manage tickets, run agents and workflows, query tables, and search workspace knowledge.
AI-native ITSM and ESM platform. resolve IT and HR requests inside Slack and Teams.
Search, reply, tag, assign and report on ThriveDesk help desk conversations from your AI assistant.
Read tickets, contacts, companies, agents and groups; create, update and reply to tickets.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- FlicenseNot gradedqualityDmaintenanceIntegrates 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-
- AlicenseNot gradedqualityBmaintenanceProvides 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
- AlicenseAqualityCmaintenanceEnables 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.362MIT