Freshdesk MCP server

Freshdesk MCP サーバー

Freshdesk と統合された MCP サーバー実装。AI モデルが Freshdesk モジュールと対話し、さまざまなサポート操作を実行できるようになります。

特徴

• Freshdesk 統合: Freshdesk API エンドポイントとのシームレスなインタラクション
• AIモデルサポート：AIモデルがFreshdeskを通じてサポート業務を実行できるようにします。
• 自動チケット管理: チケットの作成、更新、応答を処理します

コンポーネント

ツール

サーバーは Freshdesk 操作用のいくつかのツールを提供します。

• create_ticket : 新しいサポートチケットを作成する
  • 入力:
    • subject （文字列、必須）: チケットの件名
    • description （文字列、必須）: チケットの説明
    • source （数値、必須）: チケットのソースコード
    • priority （数値、必須）: チケットの優先度
    • status （数値、必須）: チケットステータスコード
    • email (文字列、オプション): リクエスト者のメールアドレス
    • requester_id (数値、オプション): リクエスト者のID
    • custom_fields (オブジェクト、オプション): チケットに設定するカスタムフィールド
• update_ticket : 既存のチケットを更新する
  • 入力:
    • ticket_id （数値、必須）: 更新するチケットのID
    • updates （オブジェクト、必須）: 更新するフィールド
• delete_ticket : チケットを削除する
  • 入力:
    • ticket_id (数値、必須): 削除するチケットのID
• search_tickets : 条件に基づいてチケットを検索する
  • 入力:
    • query (文字列、必須): 検索クエリ文字列
• get_ticket_fields : すべてのチケットフィールドを取得する
  • 入力:
    • なし
• get_tickets : すべてのチケットを取得する
  • 入力:
    • page （数値、オプション）：取得するページ番号
    • per_page (数値、オプション): ページあたりのチケット数
• get_ticket : チケット1枚を取得する
  • 入力:
    • ticket_id (数値、必須): 取得するチケットのID

はじめる

Smithery経由でインストール

Smithery経由で Claude Desktop 用の freshdesk_mcp を自動的にインストールするには:

前提条件

• Freshdeskアカウント（ freshdesk.comでサインアップ）
• Freshdesk APIキー
• uvxがインストールされている ( pip install uvまたはbrew install uv )

構成

1. Freshdesk管理パネルからFreshdesk APIキーを生成します
2. ドメインと認証の詳細を設定する

Claude Desktopでの使用

1. Claude Desktopをまだインストールしていない場合はインストールしてください
2. claude_desktop_config.jsonに次の構成を追加します。

重要な注意事項:

• YOUR_FRESHDESK_API_KEY実際のFreshdesk APIキーに置き換えます。
• YOUR_FRESHDESK_DOMAIN Freshdesk ドメインに置き換えます (例: yourcompany.freshdesk.com )

操作例

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

• 「件名を「顧客 A101 の支払い問題」、説明を「顧客 A101 の先月の支払い問題に関する連絡」とし、顧客のメールアドレスをa101@acme.comとし、優先度を「高」に設定する新しいチケットを作成します。」
• 「チケット#12345のステータスを「解決済み」に更新する」
• 「エージェント John Doe に割り当てられたすべての高優先度チケットを一覧表示する」
• 「顧客 A101 の過去 30 日間のチケットを一覧表示する」

テスト

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

トラブルシューティング

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

ライセンス

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