Freshdesk MCP Server

Freshdesk MCP サーバー

Freshdesk と連携する MCP サーバーの実装です。AI モデルが Freshdesk のモジュールを操作し、さまざまなサポート業務を実行できるようにします。

機能

• Freshdesk との連携：Freshdesk API エンドポイントをシームレスに操作できます
• AI モデルのサポート：AI モデルが Freshdesk を通じてサポート業務を実行できます
• チケット管理の自動化：チケットの作成、更新、返信に対応します

コンポーネント

ツール

サーバーは Freshdesk の操作に対応する複数のツールを提供します。

• create_ticket：新しいサポートチケットを作成します

  • 入力：
    • subject（string、必須）：チケットの件名
    • description（string、必須）：チケットの説明
    • source（number、必須）：チケットのソースコード
    • priority（number、必須）：チケットの優先度
    • status（number、必須）：チケットのステータスコード
    • email（string、任意）：依頼者のメールアドレス
    • requester_id（number、任意）：依頼者の ID
    • custom_fields（object、任意）：チケットに設定するカスタムフィールド
    • additional_fields（object、任意）：追加のトップレベルフィールド

• update_ticket：既存のチケットを更新します

  • 入力：
    • ticket_id（number、必須）：更新するチケットの ID
    • ticket_fields（object、必須）：更新するフィールド

• delete_ticket：チケットを削除します

  • 入力：
    • ticket_id（number、必須）：削除するチケットの ID

• search_tickets：条件に基づいてチケットを検索します

  • 入力：
    • query（string、必須）：検索クエリ文字列

• get_ticket_fields：すべてのチケットフィールドを取得します

  • 入力：
    • なし

• get_tickets：すべてのチケットを取得します

  • 入力：
    • page（number、任意）：取得するページ番号
    • per_page（number、任意）：1 ページあたりのチケット数

• get_ticket：単一のチケットを取得します

  • 入力：
    • ticket_id（number、必須）：取得するチケットの ID

• get_ticket_conversation：チケットの会話を取得します

  • 入力：
    • ticket_id（number、必須）：チケットの ID

• create_ticket_reply：チケットに返信します

  • 入力：
    • ticket_id（number、必須）：チケットの ID
    • body（string、必須）：返信の内容
    • cc_emails（array of strings、任意）：送信メールの cc フィールドに追加するメールアドレス。常に主な宛先となるチケットの依頼者に加えて送信されます
    • bcc_emails（array of strings、任意）：送信メールの bcc フィールドに追加するメールアドレス。常に主な宛先となるチケットの依頼者に加えて送信されます
    • from_email（string、任意）：返信の送信元メールアドレス
    • user_id（number、任意）：返信を追加するエージェントの ID

• create_ticket_note：チケットにメモを追加します

  • 入力：
    • ticket_id（number、必須）：チケットの ID
    • body（string、必須）：メモの内容

• update_ticket_conversation：会話を更新します

  • 入力：
    • conversation_id（number、必須）：会話の ID
    • body（string、必須）：更新後の内容

• view_ticket_summary：チケットの要約を取得します

  • 入力：
    • ticket_id（number、必須）：チケットの ID

• update_ticket_summary：チケットの要約を更新します

  • 入力：
    • ticket_id（number、必須）：チケットの ID
    • body（string、必須）：新しい要約の内容

• delete_ticket_summary：チケットの要約を削除します

  • 入力：
    • ticket_id（number、必須）：チケットの ID

• get_agents: すべてのエージェントを取得

  • 入力：
    • page (number, optional)：ページ番号
    • per_page (number, optional)：1ページあたりのエージェント数

• view_agent: 1人のエージェントを取得

  • 入力：
    • agent_id (number, required)：エージェントのID

• create_agent: 新しいエージェントを作成

  • 入力：
    • agent_fields (object, required)：エージェントの詳細

• update_agent: エージェントを更新

  • 入力：
    • agent_id (number, required)：エージェントのID
    • agent_fields (object, required)：更新するフィールド

• search_agents: エージェントを検索

  • 入力：
    • query (string, required)：検索クエリ

• list_contacts: すべての連絡先を取得

  • 入力：
    • page (number, optional)：ページ番号
    • per_page (number, optional)：1ページあたりの連絡先数

• get_contact: 1件の連絡先を取得

  • 入力：
    • contact_id (number, required)：連絡先のID

• search_contacts: 連絡先を検索

  • 入力：
    • query (string, required)：検索クエリ

• update_contact: 連絡先を更新

  • 入力：
    • contact_id (number, required)：連絡先のID
    • contact_fields (object, required)：更新するフィールド

• list_companies: すべての企業を取得

  • 入力：
    • page (number, optional)：ページ番号
    • per_page (number, optional)：1ページあたりの企業数

• view_company: 1社の企業を取得

  • 入力：
    • company_id (number, required)：企業のID

• search_companies: 企業を検索

  • 入力：
    • query (string, required)：検索クエリ

• find_company_by_name: 名前で企業を検索

  • 入力：
    • name (string, required)：企業名

• list_company_fields: すべての企業フィールドを取得

  • 入力：
    • なし

はじめに

Smithery 経由でインストールする

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

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 のメールアドレスが [email protected] の場合に、件名を『Payment Issue for customer A101』、説明を『Reaching out for a payment issue in the last month for customer A101』として、優先度を高に設定した新しいチケットを作成して」
• 「チケット #12345 のステータスを『Resolved』に更新して」
• 「エージェント John Doe に割り当てられた、優先度の高いチケットをすべて一覧表示して」
• 「過去30日間の顧客 A101 の以前のチケットを一覧表示して」

テスト

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

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

トラブルシューティング

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

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。