Freshdesk

@mindstone/mcp-server-freshdesk

Model Context Protocol ホスト向けの Freshdesk サポート MCP サーバーです。ヘルプデスクチケットの管理、サポートリクエストの検索とフィルタリング、顧客への返信、内部メモの追加、Freshdesk アカウントの設定を、すべて標準化された MCP インターフェースを通じて行えます。

ステータス

• バージョン： 0.3.1 · npm
• 認証： API キー（アカウントごとに、FRESHDESK_CONFIG_PATH 経由でディスク上に保存）
• ツール： 20（アカウント、チケット、連絡先、企業、ナレッジベース、検出）
• 対象： cloud-api
• 機械可読： STATUS.json

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストで FRESHDESK_CONFIG_PATH の入力を求められます。

{
  "mcpServers": {
    "Freshdesk": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-freshdesk"
      ],
      "env": {
        "FRESHDESK_CONFIG_PATH": "~/.mcp/freshdesk"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/freshdesk
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-freshdesk

ローカル

node dist/index.js

設定

環境変数

• FRESHDESK_CONFIG_PATH — アカウント認証情報を保存する設定ディレクトリへのパス（デフォルトは ~/.mcp/freshdesk）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルへの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE との後方互換性を保つ別名

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Freshdesk": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-freshdesk"],
      "env": {
        "FRESHDESK_CONFIG_PATH": "~/.mcp/freshdesk"
      }
    }
  }
}

ローカル開発（npm での公開は不要）

{
  "mcpServers": {
    "Freshdesk": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/freshdesk/dist/index.js"],
      "env": {
        "FRESHDESK_CONFIG_PATH": "~/.mcp/freshdesk"
      }
    }
  }
}

ツール（20）

アカウント管理

• configure_freshdesk — サブドメインと API キーを使用して Freshdesk アカウントに接続します
• list_freshdesk_accounts — 接続済みの Freshdesk アカウントとエージェントのメールアドレスを一覧表示します
• remove_freshdesk_account — Freshdesk アカウントの接続を解除します

チケット

• list_freshdesk_tickets — 定義済みのフィルターを使用してチケットを一覧表示します
• get_freshdesk_ticket — ID で単一のチケットを取得します。会話を含めるかどうかは任意です
• search_freshdesk_tickets — Freshdesk のクエリ構文を使用してチケットを検索します
• create_freshdesk_ticket — 新しいチケットを作成します
• update_freshdesk_ticket — チケットのフィールド、ステータス、または担当者を更新します
• reply_to_freshdesk_ticket — チケットに公開返信を追加します
• add_freshdesk_note — チケットに非公開または公開メモを追加します

検出

• list_freshdesk_ticket_fields — カスタムフィールドを含む、すべてのチケットフィールドを一覧表示します
• list_freshdesk_agents — エージェント（サポート担当者）を一覧表示します。チケットの割り当て時に ID を responder_id として使用します
• list_freshdesk_groups — グループ（エージェントチーム）を一覧表示します。チケットの割り当て時に ID を group_id として使用します

連絡先と企業

• list_freshdesk_contacts — 連絡先を一覧表示します。必要に応じて、メールアドレスまたは企業 ID の完全一致で絞り込めます
• search_freshdesk_contacts — Freshdesk のクエリ構文を使用して連絡先を検索します
• get_freshdesk_contact — ID を指定して単一の連絡先を取得します
• list_freshdesk_companies — 顧客企業を一覧表示します
• get_freshdesk_company — ID を指定して単一の企業を取得します

ナレッジベース

• search_freshdesk_solutions — キーワードでソリューション記事を検索します（ページネーション対応：1 ページあたり 30 件、page パラメーター、hasMore インジケーター）
• get_freshdesk_solution_article — ID を指定してソリューション記事の全文を取得します

セキュリティ

• Freshdesk API から返されるすべての文字列（名前、本文、タグ、メールアドレス、電話番号、企業ドメイン、カスタムフィールドのキー／値、チケットフィールドのメタデータなど）は、ホスト LLM が指示ではなくデータとして扱うよう、<untrusted-content source="…"> エンベロープで囲まれます。数値のコネクタメタデータ（ID、ステータス、優先度）のみ、加工せずに返されます。
• 認証情報は、FRESHDESK_CONFIG_PATH 配下の accounts.json に、アクセス許可 0600（設定ディレクトリは 0700）で保存されます。
• ベンダーのエラー本文、Retry-After ヘッダーの生テキスト、およびクエリを含む URL がログに書き込まれたり、ツールのエラーとして表示されたりすることはありません。
• 無効な status／priority の値や、範囲外の ID／ページネーション入力は、リクエストを行う前に拒否されます。

ライセンス

FSL-1.1-MIT — Functional Source License Version 1.1（MIT の将来ライセンス付き）。このソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。