Freshdesk

mcp-freshdesk

Freshdesk MCP Pack — Freshdesk API v2 を使用したヘルプデスクチケットおよび連絡先の管理。

Pipeworx の一部です。AI エージェントを 1879 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとの提携、承認、または公開はありません。

ツール

ツール	説明
freshdesk_list_tickets	ステータス（例：「open」、「closed」）や優先度（例：緊急を示す「1」）で絞り込んだサポートチケットを一覧表示します。チケット ID、件名、ステータス、優先度、依頼者を返します。
freshdesk_get_ticket	ID を指定してチケットの詳細を取得します。件名、ステータス、優先度、説明、会話、添付ファイル、解決メモが含まれます。
freshdesk_search_tickets	クエリ（例：「status:2 AND priority:3」またはキーワードテキスト）でチケットを検索します。一致したチケットの ID、件名、ステータス、優先度を返します。
freshdesk_list_contacts	顧客の連絡先を一覧表示します。絞り込みやページネーションに使用する名前、メールアドレス、電話番号、会社名、連絡先 ID を返します。
freshdesk_get_contact	ID を指定して連絡先の詳細を取得します。名前、メールアドレス、電話番号、会社名、住所、チケット履歴が含まれます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "freshdesk": {
      "url": "https://gateway.pipeworx.io/freshdesk/mcp"
    }
  }
}

このエンドポイントが実際に提供する内容

https://gateway.pipeworx.io/freshdesk/mcp の tools/list は、上記の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールと併せて、およそ 30 個の共有ツールが一覧表示されます。接続の initialize 応答に正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックの対象外の質問にも ask_pipeworx 経由でカタログ全体を横断して回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現在、これらのメタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1879 以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

このパックでは、ご自身の API キー（_apiKey）を使用します。こちらでは API キーを用意していないため、キーなしで実行できる curl の例はありません。ツールの情報を確認するには、GET https://gateway.pipeworx.io/v1/tools/freshdesk_list_tickets を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへのラウンドトリップも必要ありません。

{
  "mcpServers": {
    "freshdesk": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-freshdesk"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-freshdesk

stdin／stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続が追加する共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも使用できます。

ask_pipeworx({ question: "your question about Freshdesk data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT