Freshservice MCP サーバー

概要

Freshserviceとシームレスに統合する強力なMCP（モデル制御プロトコル）サーバー実装により、AIモデルがFreshserviceモジュールと連携し、様々なITサービス管理オペレーションを実行できるようになります。この統合ブリッジにより、AIアシスタントがITサービスチケットの管理と解決を行えるようになり、サポートワークフローが効率化されます。

Related MCP server: Freshdesk MCP Server by CData

主な特徴

• エンタープライズグレードのFreshservice統合：Freshservice APIエンドポイントとの直接かつ安全な通信

• AIモデルの互換性: Claudeやその他のAIモデルがFreshserviceを通じてサービスデスク操作を実行できるようにします。

• 自動化されたITSM管理：チケットの作成、更新、対応、資産管理を効率的に処理します

• ワークフローの加速: 日常的なITサービスタスクにおける手動介入を削減

サポートされているFreshserviceモジュール

この MCP サーバーは現在、幅広い Freshservice モジュールにわたる操作をサポートしています。

• チケット

• 会話

• 製品

• 依頼者

• エージェント

• エージェントグループ

• リクエストグループ

• 定型返信

• 定型返信フォルダ

• ワークスペース

• ソリューションカテゴリ

• ソリューションフォルダー

• ソリューション記事

コンポーネントとツール

サーバーは、Freshservice 操作のための包括的なツールキットを提供します。

チケット管理

はじめる

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_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 APIドキュメント

• Claude デスクトップ統合ガイド

• MCPプロトコル仕様