Skip to main content
Glama
Freshservice MCP Server
by tannertm0

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

빠른 시작

사전 요구 사항

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.freshservice.com의 경우 yourcompany)

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

KB 카테고리 탐색

list_solution_folders / get_solution_folder

KB 폴더 탐색

list_solution_articles / get_solution_article

문서 읽기

create_solution_article

새 문서 작성

update_solution_article

문서 편집

delete_solution_article

문서 제거

예시 프롬프트

구성이 완료되면 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 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