Freshdesk MCP サーバー

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

特徴

• Freshdesk 統合: Freshdesk API エンドポイントとのシームレスなインタラクション

• AIモデルサポート：AIモデルがFreshdeskを通じてサポート業務を実行できるようにします。

• 自動チケット管理: チケットの作成、更新、応答を処理します

Related MCP server: mcp-jira-server

コンポーネント

ツール

サーバーは 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 を自動的にインストールするには:

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

前提条件

• 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に次の構成を追加します。

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

重要な注意事項:

• YOUR_FRESHDESK_API_KEY実際のFreshdesk APIキーに置き換えます。

• YOUR_FRESHDESK_DOMAIN Freshdesk ドメインに置き換えます (例: yourcompany.freshdesk.com )

操作例

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

• 「件名を「顧客 A101 の支払い問題」、説明を「顧客 A101 の先月の支払い問題に関する連絡」とし、顧客のメールアドレスをa101@acme.comとし、優先度を「高」に設定する新しいチケットを作成します。」

• 「チケット#12345のステータスを「解決済み」に更新する」

• 「エージェント John Doe に割り当てられたすべての高優先度チケットを一覧表示する」

• 「顧客 A101 の過去 30 日間のチケットを一覧表示する」

テスト

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

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

トラブルシューティング

• Freshdesk APIキーとドメインが正しいことを確認してください

• Freshdeskサーバーへの適切なネットワーク接続を確保する

• API レート制限と割り当てを確認する

• uvxコマンドがPATHで使用可能であることを確認します

ライセンス

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