Freshservice MCP Server
freshservice-mcp
AI 어시스턴트를 Freshservice ITSM 인스턴스에 연결하는 MCP(Model Context Protocol) 서버입니다. 자연어를 통해 티켓, 자산, 변경, 문제, 서비스 카탈로그, 지식 베이스 등을 관리하세요.
기능
9개 카테고리에 걸친 53개의 도구:
카테고리 | 도구 | 설명 |
티켓 | 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 목록 조회 |
| 사용자 지정 필드를 포함한 자산 세부 정보 조회 |
| 새 자산 등록 |
| 자산 필드 업데이트 |
| 자산 제거 |
사용자 및 조직
도구 | 설명 |
| 최종 사용자 |
| 지원 담당자 |
| 구성원이 포함된 상담원 그룹 |
| 부서 |
티켓 작업
도구 | 설명 |
| 티켓의 하위 작업 목록 조회 |
| 작업 세부 정보 조회 |
| 티켓에 작업 추가 |
| 작업 상태/담당자 업데이트 |
| 작업 제거 |
시간 기록
도구 | 설명 |
| 티켓에 기록된 시간 보기 |
| 소요 시간 기록 |
| 시간 기록 수정 |
| 시간 기록 제거 |
변경
도구 | 설명 |
| 변경 요청 목록 조회 |
| 변경 세부 정보(유형, 위험, 일정) 조회 |
| 변경 요청 생성 |
| 변경 필드 업데이트 |
| 변경 삭제 |
문제
도구 | 설명 |
| 문제 레코드 목록 조회 |
| 문제 세부 정보 조회 |
| 문제 레코드 생성 |
| 문제 필드 업데이트 |
| 문제 삭제 |
서비스 카탈로그
도구 | 설명 |
| 사용 가능한 서비스 탐색 |
| 서비스 세부 정보 및 필수 필드 조회 |
| 서비스 요청 제출 |
지식 베이스
도구 | 설명 |
| KB 카테고리 탐색 |
| KB 폴더 탐색 |
| 문서 읽기 |
| 새 문서 작성 |
| 문서 편집 |
| 문서 제거 |
예시 프롬프트
구성이 완료되면 AI 어시스턴트에게 다음과 같이 요청할 수 있습니다:
"모든 오픈 P1 티켓을 보여줘"
"3층 프린터가 오프라인 상태라는 티켓을 생성해줘"
"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