MCP-сервер (Model Context Protocol), который подключает ИИ-ассистентов к вашему экземпляру Freshservice ITSM. Управляйте заявками, активами, изменениями, проблемами, каталогом услуг, базой знаний и многим другим с помощью естественного языка.
53 инструмента в 9 категориях:
Категория | Инструменты | Описание |
Заявки | 9 | Список, получение, создание, обновление, удаление, ответ, добавление заметок, обсуждения, поиск |
Активы | 5 | Список, получение, создание, обновление, удаление |
Люди | 8 | Заявители, агенты, группы, отделы (список + получение) |
Задачи по заявкам | 5 | Список, получение, создание, обновление, удаление подзадач в заявках |
Учет времени | 4 | Список, создание, обновление, удаление записей о времени |
Изменения | 5 | Список, получение, создание, обновление, удаление запросов на изменения |
Проблемы | 5 | Список, получение, создание, обновление, удаление записей о проблемах |
Каталог услуг | 3 | Просмотр элементов каталога, получение деталей, оформление запросов на услуги |
База знаний | 9 | Категории, папки, статьи (полный CRUD) |
Related MCP server: Service Desk Plus MCP Server
Node.js 18+
Учетная запись Freshservice с доступом к API
Ваш API-ключ Freshservice (Значок профиля > Настройки профиля > API-ключ на правой панели)
Установка не требуется. Настройте ваш 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 (например, |
| Да | Ваш API-ключ Freshservice |
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 |
| Получение сведений об активе с пользовательскими полями |
| Регистрация нового актива |
| Обновление полей актива |
| Удаление актива |
Инструмент | Описание |
| Конечные пользователи |
| Сотрудники поддержки |
| Группы агентов с участниками |
| Отделы |
Инструмент | Описание |
| Список подзадач в заявке |
| Получение сведений о задаче |
| Добавление задачи к заявке |
| Обновление статуса/назначения задачи |
| Удаление задачи |
Инструмент | Описание |
| Просмотр времени, затраченного на заявку |
| Регистрация затраченного времени |
| Изменение записи о времени |
| Удаление записи о времени |
Инструмент | Описание |
| Список запросов на изменения |
| Получение сведений об изменении (тип, риск, расписание) |
| Создание запроса на изменение |
| Обновление полей изменения |
| Удаление изменения |
Инструмент | Описание |
| Список записей о проблемах |
| Получение сведений о проблеме |
| Создание записи о проблеме |
| Обновление полей проблемы |
| Удаление проблемы |
Инструмент | Описание |
| Просмотр доступных услуг |
| Получение сведений об услуге и обязательных полей |
| Отправка запроса на услугу |
Инструмент | Описание |
| Просмотр категорий БЗ |
| Просмотр папок БЗ |
| Чтение статей |
| Написание новой статьи |
| Редактирование статьи |
| Удаление статьи |
После настройки вы можете спрашивать своего ИИ-ассистента о следующем:
"Покажи мне все открытые заявки P1"
"Создай заявку о том, что принтер на 3-м этаже не работает"
"Какие активы назначены на Джона Смита?"
"Добавь приватную заметку к заявке #5678 о том, что мы ждем ответа от поставщика"
"Создай запрос на изменение для обновления брандмауэра, запланированного на следующий вторник"
"Поищи в базе знаний инструкции по настройке VPN"
"Запиши 2 часа работы в заявку #1234 для отладки сетевой проблемы"
"Покажи мне все открытые проблемы и их уровни влияния"
"Оформи запрос на новый ноутбук из каталога услуг"
Инструмент 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 dategit clone https://github.com/tannertm0/freshservice-mcp.git
cd freshservice-mcp
npm install
npm testMIT
Add a note to a Freshservice ticket
Inputs: ticket_id (required), body (required), private.
Create a new Freshservice asset
Inputs: name (required), asset_type_id (required), description, user_id, +3 more.
Create a new Freshservice change request
Inputs: subject (required), description (required), requester_id (required), priority, +9 more.
Create a new Freshservice problem
Inputs: subject (required), description (required), requester_id (required), priority, +7 more.
Create a new knowledge base article
Inputs: title (required), description (required), folder_id (required), status, +1 more.
Create a new Freshservice ticket
Inputs: subject (required), description (required), email, requester_id, +10 more.
Create a new task on a Freshservice ticket
Inputs: ticket_id (required), title (required), description, status, +3 more.
Log time spent on a Freshservice ticket
Inputs: ticket_id (required), agent_id (required), time_spent (required), note, +2 more.
Delete a Freshservice asset
Inputs: display_id (required).
Delete a Freshservice change request
Inputs: change_id (required).
Delete a Freshservice problem
Inputs: problem_id (required).
Delete a knowledge base article
Inputs: article_id (required).
Delete a Freshservice ticket (moves to trash)
Inputs: ticket_id (required).
Delete a task from a Freshservice ticket
Inputs: ticket_id (required), task_id (required).
Delete a time entry from a Freshservice ticket
Inputs: ticket_id (required), entry_id (required).
Get details of a specific agent
Inputs: agent_id (required).
Get details of a specific asset
Inputs: display_id (required).
Get details of a specific change request
Inputs: change_id (required).
Get details of a specific department
Inputs: department_id (required).
Get details of a specific agent group
Inputs: group_id (required).
Get details of a specific Freshservice problem
Inputs: problem_id (required).
Get details of a specific requester
Inputs: requester_id (required).
Get details of a specific service catalog item
Inputs: item_id (required).
Get a knowledge base article with full content
Inputs: article_id (required).
Get details of a knowledge base category
Inputs: category_id (required).
Get details of a knowledge base folder
Inputs: folder_id (required).
Get details of a specific Freshservice ticket
Inputs: ticket_id (required).
Get all conversations (replies and notes) for a ticket
Inputs: ticket_id (required).
Get details of a specific task on a ticket
Inputs: ticket_id (required), task_id (required).
List Freshservice agents (support staff)
Inputs: page, per_page, email, active.
List Freshservice assets/configuration items
Inputs: page, per_page.
List Freshservice change requests
Inputs: page, per_page, filter, order_by, +1 more.
List Freshservice departments
Inputs: page, per_page.
List Freshservice agent groups
Inputs: page, per_page.
List Freshservice problems
Inputs: page, per_page, order_by, order_type.
List Freshservice requesters (end users)
Inputs: page, per_page, email.
List items in the Freshservice service catalog
Inputs: page, per_page.
List articles in a knowledge base folder
Inputs: folder_id (required), page, per_page.
List knowledge base categories in Freshservice
Inputs: page, per_page.
List folders in a knowledge base category
Inputs: category_id (required), page, per_page.
List Freshservice tickets with optional filters
Inputs: page, per_page, filter, requester_id, +4 more.
List all tasks for a Freshservice ticket
Inputs: ticket_id (required).
List time entries for a Freshservice ticket
Inputs: ticket_id (required).
Place a service request from the Freshservice catalog
Inputs: item_id (required), quantity, email, custom_fields.
Reply to a Freshservice ticket
Inputs: ticket_id (required), body (required), cc_emails, bcc_emails.
Search/filter Freshservice tickets using a query string
Inputs: query (required).
Update an existing Freshservice asset
Inputs: display_id (required), name, description, user_id, +3 more.
Update an existing Freshservice change request
Inputs: change_id (required), subject, description, priority, +8 more.
Update an existing Freshservice problem
Inputs: problem_id (required), subject, description, priority, +6 more.
Update an existing knowledge base article
Inputs: article_id (required), title, description, status, +1 more.
Update an existing Freshservice ticket
Inputs: ticket_id (required), subject, description, priority, +7 more.
Update a task on a Freshservice ticket
Inputs: ticket_id (required), task_id (required), title, description, +4 more.
Update a time entry on a Freshservice ticket
Inputs: ticket_id (required), entry_id (required), time_spent, note, +2 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
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.
Read tickets, contacts, companies, agents and groups; create, update and reply to tickets.
Use your connected apps from your agent: search synced data, act in apps and set up automations.