helpdesk-mender-mcp

Helpdesk Mender MCP — AI エージェント向け Zendesk、Freshdesk、Help Scout 書き込みツール

Zendesk、Freshdesk、Help Scoutでチケットを作成し、返信やメモを追加して、チケットのステータスを変更できる無料のローカル MCP サーバーです。3つすべてで一貫したツール語彙を使えるため、ヘルプデスクごとに異なる連携を3つ作る必要はありません。

AI サポートワークフローを構築する際に、Zendesk の Basic／OAuth 認証、Freshdesk の API キー認証、Help Scout の OAuth2 クライアント認証情報フローに合わせて、同じチケット作成／返信ロジックを何度も書き直しているなら、まさにその問題を解決する MCP サーバーです。

解決する問題

Zendesk、Freshdesk、Help Scout にはいずれも優れた書き込み対応のチケット管理 API がありますが、それぞれ認証方式やフィールド名、「チケット」の概念（Help Scout では「会話」と呼びます）が異なります。3つすべてを一連の呼び出しで統一する、無料のオープンソースツールはありません。このツールがその役割を果たします。

ツール

• create_ticket — 新しいチケット／会話を作成します。
• add_reply — 顧客に表示される公開返信を追加します。
• add_note — 非公開の内部メモを追加します（Freshdesk と Help Scout。Zendesk には独立したメモ用エンドポイントがありません。そのプラットフォームでは、公開コメントではないコメントを指定して add_reply を使用してください）。
• update_status — チケット／会話のステータスを変更します。
• list_tickets — チケット／会話の一覧を取得します。

セットアップ

1. Node.js をインストールします（v18 以降）：https://nodejs.org

2. クローンしてインストールします：

git clone https://github.com/headlessherm-creator/helpdesk-mender-mcp.git
cd helpdesk-mender-mcp
npm install

3. 使用するプラットフォームの API 認証情報を取得します：

• Freshdesk： プロフィール設定から API キーを取得します。重要： Freshdesk の無料プランでは、API のレート制限が毎分0回です。API を利用するには有料プラン（Growth 以上）が必要です。Freshdesk の API ドキュメントをご覧ください。
• Zendesk： 管理センター → アプリおよびインテグレーション → API → Zendesk API から API トークンを作成するか、OAuth を使用します。Zendesk の API ドキュメントをご覧ください。
• Help Scout： 「Your Profile」→「My Apps」から、クライアント認証情報フローを使用する OAuth2 アプリを作成します。注：Help Scout のクライアント認証情報トークンは48時間で期限切れになり、リフレッシュトークンはありません。このサーバーはキャッシュされたトークンの期限が切れると、自動的に新しいトークンを再リクエストするため、ご自身で処理する必要はありません。Help Scout の認証ドキュメントをご覧ください。

4. 環境変数を設定します：

export FRESHDESK_DOMAIN=yourcompany
export FRESHDESK_API_KEY=your_api_key
export ZENDESK_SUBDOMAIN=yourcompany
export [email protected]
export ZENDESK_API_TOKEN=your_api_token
export HELPSCOUT_APP_ID=your_app_id
export HELPSCOUT_APP_SECRET=your_app_secret

使用するプラットフォームの変数だけを設定してください。

5. MCP クライアントから接続します：

{
  "mcpServers": {
    "helpdesk-mender": {
      "command": "node",
      "args": ["/path/to/helpdesk-mender-mcp/src/index.js"],
      "env": {
        "FRESHDESK_DOMAIN": "yourcompany",
        "FRESHDESK_API_KEY": "your_api_key"
      }
    }
  }
}

一般的なクライアント向けのセットアップドキュメント：

• Claude Desktop：https://modelcontextprotocol.io/quickstart/user
• Cursor：https://docs.cursor.com/context/model-context-protocol
• Claude Code：https://docs.claude.com/en/docs/claude-code/mcp

セキュリティに関する注意

このサーバーは、指定した認証情報を使って Zendesk、Freshdesk、Help Scout の API に実際のネットワーク経由でアクセスします。完全なローカルツールとは異なり、データはお使いのマシンから、すでに利用しているヘルプデスクのベンダーへ直接送信されます。サードパーティによるアクセス、テレメトリ、ログ記録はありません。

キーワード

Zendesk MCP サーバー、Freshdesk MCP サーバー、Help Scout MCP サーバー、ヘルプデスク MCP サーバー、サポートチケット自動化 MCP、カスタマーサポート AI エージェント、チケット管理システム MCP、Claude MCP サポートツール。

関連ツール

同じローカルファーストの理念で、異なる問題を解決します：

• polymath-megablaster-mcp — 決定論的な数学、日付、単位変換、ネットワーク機能
• json-mender-mcp — 不正な JSON の修正、JSON Schema の検証、正規表現のテスト
• hiring-mender-mcp — BambooHR と Greenhouse ATS の書き込みツールを一つの語彙で提供

ライセンス

MIT