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
    ResponsivenessOutdated data

    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