Freshservice MCP Server

Freshservice MCP サーバー

概要

Freshservice とシームレスに連携する強力な MCP（Model Context Protocol）サーバー実装です。AI モデルが Freshservice のモジュールを操作し、さまざまな IT サービス管理業務を実行できるようにします。この連携ブリッジにより、AI アシスタントが IT サービスチケットを管理・解決できるため、サポートのワークフローが効率化されます。

主な機能

• エンタープライズグレードの Freshservice 連携：Freshservice API エンドポイントとの直接かつ安全な通信
• AI モデルとの互換性：Claude などの AI モデルが Freshservice を通じてサービスデスク業務を実行できるようにします
• ITSM 管理の自動化：チケットの作成、更新、返信、アセット管理を効率的に処理します
• ワークフローの高速化：日常的な IT サービス業務における手作業を削減します

対応している Freshservice モジュール

この MCP サーバーは現在、幅広い Freshservice モジュールの操作に対応しています：

• チケット
• 変更
• 会話
• 製品
• リクエスター
• エージェント
• エージェントグループ
• リクエスターグループ
• 定型返信
• 定型返信フォルダー
• ワークスペース
• ソリューションカテゴリ
• ソリューションフォルダー
• ソリューション記事

コンポーネントとツール

このサーバーは Freshservice の操作に必要な包括的なツールセットを提供します。

チケット管理

ツール	説明	主なパラメーター
create_ticket	サービスチケットを新規作成します	subject、description、source、priority、status、email
update_ticket	既存のチケットを更新します	ticket_id、updates
delete_ticket	チケットを削除します	ticket_id
filter_tickets	条件に一致するチケットを検索します	query
get_ticket_fields	チケットのフィールド定義を取得します	なし
get_tickets	ページネーションを使用してすべてのチケットを一覧表示します	page、per_page
get_ticket_by_id	個別のチケットの詳細を取得します	ticket_id

変更管理

ツール	説明	主なパラメーター
get_changes	ページネーションを使用してすべての変更を一覧表示します	page、per_page、query
filter_changes	高度なクエリで変更を絞り込みます	query、page、per_page
get_change_by_id	個別の変更の詳細を取得します	change_id
create_change	変更リクエストを新規作成します	requester_id、subject、description、priority、impact、status、risk、change_type
update_change	既存の変更を更新します	change_id、change_fields
close_change	結果の説明を添えて変更をクローズします	change_id、change_result_explanation
delete_change	変更を削除します	change_id
get_change_tasks	変更に関連するタスクを取得します	change_id
create_change_note	変更にメモを追加します	change_id、body

🚨 重要：絞り込み時のクエリ構文

get_changes または filter_changes で query パラメーターを使用する場合、Freshservice API が正しく動作するよう、クエリ文字列を二重引用符で囲む必要があります。

✅ 正しい例："status:3"、"approval_status:1 AND status:<6"
❌ 誤った例：status:3（500 Internal Server Error が発生します）

一般的なクエリの例：

• "status:3" - 承認待ちの変更
• "approval_status:1" - 承認済みの変更
• "approval_status:1 AND status:<6" - クローズされていない承認済みの変更
• "planned_start_date:>'2025-07-14'" - 特定の日付より後に開始する変更
• "status:3 AND priority:1" - 承認待ちの高優先度の変更

はじめに

Smithery 経由でのインストール

Smithery 経由で freshservice_mcp を自動的にインストールするには：

npx -y @smithery/cli install @effytech/freshservice_mcp --client claude

前提条件

• Freshservice アカウント（freshservice.com で登録）
• Freshservice API キー
• uvx がインストールされていること（pip install uv または brew install uv）

設定

1. 管理パネルから Freshservice API キーを生成します：

   • プロフィール設定 → API 設定に移動します
   • 設定に使用する API キーをコピーします

2. 以下のように、ドメインと認証情報を設定します

Claude Desktop での使用方法

1. 公式ウェブサイトから Claude Desktop をインストールします
2. 次の設定を claude_desktop_config.json に追加します：

"mcpServers": {
  "freshservice-mcp": {
    "command": "uvx",
    "args": [
        "freshservice-mcp"
    ],
    "env": {
      "FRESHSERVICE_APIKEY": "<YOUR_FRESHSERVICE_APIKEY>",
      "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>"
    }
  }
}

重要：<YOUR_FRESHSERVICE_APIKEY> を実際の API キーに、<YOUR_FRESHSERVICE_DOMAIN> をドメイン（例：yourcompany.freshservice.com）に置き換えてください

操作の例

設定が完了したら、Claude に次のような操作を依頼できます：

チケット：

• 「件名を『マーケティング部門のネットワーク接続の問題』、説明を『マーケティングエリアでユーザーが Wi-Fi に接続できない』として、新しいインシデントチケットを作成し、優先度を高に設定して」
• 「過去 24 時間に報告された重大なインシデントをすべて一覧表示して」
• 「チケット #12345 のステータスを解決済みに更新して」

変更：

• 「来週火曜日の午前 2 時に予定されているサーバーメンテナンスの変更リクエストを作成して」
• 「変更リクエスト #45678 のステータスを『承認済み』に更新して」
• 「結果の説明を『本番環境へのデプロイに成功しました。すべてのテストに合格しました。』として、変更 #5092 をクローズして」
• 「保留中の変更をすべて一覧表示して」

その他の操作：

• 「資産タグ『LT-2023-087』のノートパソコンの資産詳細を表示して」
• 「パスワードのリセット手順に関するソリューション記事を作成して」

テスト

テストする場合は、サーバーを手動で起動できます：

uvx freshservice-mcp --env FRESHSERVICE_APIKEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>

トラブルシューティング

• Freshservice API キーとドメインが正しいことを確認してください
• Freshservice サーバーへのネットワーク接続が適切であることを確認してください
• API のレート制限とクォータを確認してください
• uvx コマンドが PATH から使用できることを確認してください

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。

追加リソース

• Freshservice API ドキュメント
• Claude Desktop 連携ガイド
• MCP プロトコル仕様

---

effy が ❤️ を込めて作成