freshservice-mcp

AI アシスタントを Freshservice ITSM インスタンスに接続する MCP (Model Context Protocol) サーバーです。チケット、資産、変更管理、問題管理、サービスカタログ、ナレッジベースなどを自然言語で管理できます。

機能

9 つのカテゴリにわたる 53 個のツール:

カテゴリ	ツール数	説明
チケット	9	一覧表示、取得、作成、更新、削除、返信、メモ追加、会話取得、検索
資産	5	一覧表示、取得、作成、更新、削除
人物	8	リクエスター、エージェント、グループ、部署 (一覧表示 + 取得)
チケットタスク	5	チケットのサブタスクの一覧表示、取得、作成、更新、削除
時間記録	4	時間ログの一覧表示、作成、更新、削除
変更管理	5	変更リクエストの一覧表示、取得、作成、更新、削除
問題管理	5	問題レコードの一覧表示、取得、作成、更新、削除
サービスカタログ	3	カタログアイテムの閲覧、詳細取得、サービスリクエストの送信
ナレッジベース	9	カテゴリ、フォルダ、記事 (完全な CRUD)

クイックスタート

前提条件

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_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

Freshservice MCP Server