Freshservice MCP サーバー

概要

Freshserviceとシームレスに統合する強力なMCP（モデル制御プロトコル）サーバー実装により、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`
`search_tickets`	条件に一致するチケットを検索	`query`
`get_ticket_fields`	チケットフィールド定義を取得する	なし
`get_tickets`	ページ区切りですべてのチケットを一覧表示する	`page` 、 `per_page`
`get_ticket`	チケットの詳細を個別に取得する	`ticket_id`

はじめる

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 )

構成

管理パネルから Freshservice API キーを生成します。
- プロフィール設定→API設定へ移動
- 設定��のAPIキーをコピーします
ドメインと認証の詳細を以下のように設定します

Claude Desktopでの使用

公式サイトからClaude Desktopをインストールする
claude_desktop_config.jsonに次の構成を追加します。

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

重要: <YOUR_FRESHSERVICE_API_KEY>実際の API キーに置き換え、 <YOUR_FRESHSERVICE_DOMAIN>ドメイン (例: yourcompany.freshservice.com ) に置き換えます。

操作例

設定が完了すると、Claude に次のような操作の実行を依頼できるようになります。

「件名を「マーケティング部門のネットワーク接続の問題」、説明を「マーケティングエリアのユーザーがWi-Fiに接続できない」として、新しいインシデントチケットを作成し、優先度を「高」に設定します」
「変更リクエスト #45678 のステータスを「承認済み」に更新します」
「過去24時間以内に報告されたすべての重大なインシデントを一覧表示する」
「資産タグ「LT-2023-087」のラップトップの資産詳細を表示する」
「来週火曜日の午前2時に予定されているサーバーメンテナンスの変更リクエストを作成します」

テスト

テスト目的で、サーバーを手動で起動できます。

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

トラブルシューティング

Freshservice APIキーとドメインが正しいことを確認してください
Freshservice サーバーへの適切なネットワーク接続を確保する
API レート制限と割り当てを確認する
uvxコマンドがPATHで使用可能であることを確認します

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。詳細はプロジェクトリポジトリのLICENSEファイルをご覧ください。

Freshservice MCP server