Freshdesk MCP by usefulapi について
Freshdesk MCP by usefulapiは、Freshdeskのサポートデータを扱うチーム向けのホスト型MCPサーバーです。チケットや関連情報を参照し、チケットや連絡先の作成・更新、返信、メモの追加を行えます。
主な機能
- 01チケットの一覧、詳細表示、検索
- 02チケットの会話履歴の参照
- 03連絡先と会社の閲覧
- 04エージェントとグループの確認
- 05チケットの作成、更新、返信
- 06チケットへのメモ追加と連絡先管理
活用シーン
- 01検索でチケットを探す
- 02チケットの会話履歴を確認
- 03サポート依頼への返信やメモの追加
- 04連絡先または会社の作成・更新
MCP 対応
Freshdeskのチケット、会話、連絡先、会社、エージェント、グループをMCPツールとして提供し、チケットと連絡先の書き込みにも対応します。ホスト型サーバーは、サインイン時に入力するFreshdeskドメインとAPIキーで接続します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://freshdesk.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-freshdesk https://freshdesk.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-freshdesk":{"serverUrl":"https://freshdesk.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
19| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| page | integer | いいえ | ページ番号(1 始まり)。 |
| string | いいえ | 依頼者のメールアドレスで絞り込みます。 | |
| filter | enum | いいえ | 定義済みフィルター:new_and_my_open、watching、spam、deleted。new_and_my_open | watching | spam | deleted |
| include | string | いいえ | 追加データを埋め込みます。カンマ区切りで指定します(例:"requester,stats,description")。 |
| order_by | enum | いいえ | 並べ替えフィールド:created_at、due_by、updated_at、status。created_at | due_by | updated_at | status |
| per_page | integer | いいえ | 1 ページあたりの結果数(1~100、最大 100、デフォルト 30)。 |
| company_id | integer | いいえ | 会社 ID で絞り込みます。 |
| order_type | enum | いいえ | 並べ替え順:asc または desc。asc | desc |
| requester_id | integer | いいえ | リクエスター(連絡先)IDで絞り込みます。 |
| updated_since | string | いいえ | この ISO 8601 タイムスタンプ以降に更新されたチケットのみを対象にします。 |
詳細
usefulapi による Freshdesk MCP
Claude、Cursor、または任意の MCP クライアントから Freshdesk アカウントを利用できます。チケット、連絡先、企業、エージェント、グループを読み取り、チケットの作成、更新、返信ができます。ホスト型のため、ローカルへのインストールは不要です。お客様自身の認証情報で接続できます。
ライブエンドポイント: https://freshdesk.usefulapi.io/mcp · ホームページ: https://usefulapi.io
接続
- Claude(claude.ai、デスクトップ):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://freshdesk.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http freshdesk https://freshdesk.usefulapi.io/mcpを実行し、続いて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: リモート MCP サーバーとして URL を追加します。
{
"mcpServers": {
"freshdesk": {
"url": "https://freshdesk.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定には Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Freshdesk の認証情報を入力するよう求められます。
手順を追ったセットアップ、認証情報の確認方法、FAQ:https://usefulapi.io/freshdesk/
初回接続時に、Freshdesk ドメインとAPI キー(プロフィール設定)を入力します。入力内容は検証され、ユーザーごとに保存され、お客様専用の範囲に設定されるため、設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 内容 |
|---|---|---|
freshdesk_list_tickets | 読み取り | チケットの一覧表示 |
freshdesk_get_ticket | 読み取り | チケットの取得 |
freshdesk_search_tickets | 読み取り | チケットの検索 |
freshdesk_list_ticket_conversations | 読み取り | チケットの会話一覧の表示 |
freshdesk_list_contacts | 読み取り | 連絡先の一覧表示 |
freshdesk_get_contact | 読み取り | 連絡先の取得 |
freshdesk_search_contacts | 読み取り | 連絡先の検索 |
freshdesk_list_companies | 読み取り | 企業の一覧表示 |
freshdesk_get_company | 読み取り | 企業の取得 |
freshdesk_list_agents | 読み取り | エージェントの一覧表示 |
freshdesk_get_agent | 読み取り | エージェントの取得 |
freshdesk_list_groups | 読み取り | グループの一覧表示 |
freshdesk_create_ticket | 書き込み | チケットの作成 |
freshdesk_update_ticket | 書き込み | チケットの更新 |
freshdesk_reply_ticket | 書き込み | チケットへの返信 |
freshdesk_add_note | 書き込み | チケットへのメモの追加 |
freshdesk_create_contact | 書き込み | 連絡先の作成 |
freshdesk_update_contact | 書き込み | 連絡先の更新 |
freshdesk_create_company | 書き込み | 企業の作成 |
freshdesk_usage_status | メタ | 使用状況(無料プランの利用量) |
freshdesk_request_feature | メタ | 未対応機能のリクエスト |
freshdesk_upgrade | メタ | Pro へのアップグレード(無制限*) |
freshdesk_cancel_subscription | メタ | Pro サブスクリプションのキャンセル |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で実行前に確認する必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月あたり50回のツール呼び出し |
| Pro | $9/mo または $90/yr(2か月分無料) | 無制限* |
*Pro では、このサーバー上で月あたり10,000回のツール呼び出しという公正利用上限が適用されます。それ以上必要な場合は、[email protected] までご連絡ください。
Pro はこのサーバーのみが対象です。freshdesk_upgrade で登録してください(Stripe Checkout のリンクが返されます)。freshdesk_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用できます。現在の期間については返金されません。また、その前に freshdesk_upgrade を実行するとキャンセルが取り消されます。[email protected] へのお問い合わせも可能です。
ライセンス
MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホストされています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。