Freshservice

🚀 Freshservice MCP サーバー

このサーバーは、強力なMCP（モデル制御プロトコル）サーバーの実装で、Freshserviceとシームレスに統合されています。AIモデルがFreshserviceモジュールと対話し、さまざまなITサービス管理操作を実行できるようになります。この統合により、AIアシスタントがITサポートチケットを管理および解決でき、サポートワークフローを簡素化します。

✨ 主な機能

• エンタープライズレベルのFreshservice統合：直接かつ安全にFreshservice APIエンドポイントと通信します。
• AIモデル互換性：Claudeやその他のAIモデルがFreshserviceを介してサービスデスク操作を実行できるようにします。
• 自動化ITSM管理：チケットの作成、更新、返信、および資産管理作業を効率的に処理します。
• ワークフローの高速化：日常のITサービスタスクにおける手動介入を減らします。

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

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

• チケット
• ダイアログ
• 製品
• リクエスター
• エージェント
• エージェントグループ
• リクエスターグループ
• よく使う応答
• よく使う応答フォルダ
• ワークスペース
• ソリューション分類
• ソリューションフォルダ
• ソリューション記事

🔧 コンポーネントとツール

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

チケット管理

🚀 クイックスタート

インストール

Smithery CLIを使用して自動インストールします。

smithery install @effytech/freshservice-mcp

設定

1. Freshservice APIキーを生成します。
   • あなたのFreshserviceアカウントにログインします。
   • 「設定」>「統合とAPI」>「APIキー」にアクセスします。
   • 新しいAPIキーを作成し、api_key_idとsecret_keyを取得します。
2. 環境変数を設定します。

export FRESHSERVICE_API_KEY_ID="your_api_key_id"
export FRESHSERVICE_SECRET_KEY="your_secret_key"

Claude Desktopの使用

claude_desktop_config.jsonファイルにMCPサーバーの設定を追加します。

{
  "mcp_servers": {
    "freshservice_mcp": {
      "type": "http",
      "url": "http://localhost:8080",
      "auth": {
        "api_key_id": "your_api_key_id",
        "secret_key": "your_secret_key"
      }
    }
  }
}

💻 使用例

基本的な使用法

新しいチケットの作成

create_ticket \
--subject "IT支持请求" \
--description "无法访问公司网络" \
--priority "high" \
--email "support@example.com"

既存のチケットの更新

update_ticket --ticket_id 12345 --status "in_progress"

テスト

手動でサーバーを起動します。

uvx run freshservice-mcp:latest

トラブルシューティング

• APIキーが正しく設定されていることを確認してください。
• ネットワーク接続が正常であることを確認してください。
• 詳細情報はFreshservice APIドキュメントを参照してください。

参考資料

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

由effy倾心打造