HappyFox MCP by usefulapi

usefulapi による HappyFox MCP

Claude、Cursor、または任意の MCP クライアントから HappyFox を利用できます。チケット、連絡先、ナレッジベースの記事をトリアージし、レポートを実行して、返信や非公開メモの追加ができます。 ホスト型のため、ローカルへのインストールは不要です。ご自身の HappyFox 認証情報で接続できます。

ライブエンドポイント： https://happyfox.usefulapi.io/mcp · ホームページ： https://usefulapi.io/happyfox

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://happyfox.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http happyfox https://happyfox.usefulapi.io/mcp を実行し、続いて /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "happyfox": {
      "url": "https://happyfox.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインし、ログインページで HappyFox の認証情報を求めます。

詳しい設定手順、認証情報の確認場所、よくある質問：https://usefulapi.io/happyfox/

初回接続時に、HappyFox のヘルプデスクのサブドメイン、リージョン、API キー、認証コードを入力します（Manage → Integrations → API → Create API key）。 これらは検証され、ユーザーごとに保存され、本人にのみ適用されます。設定ファイルにキーが保存されることはありません。

ツール

ツール	種類	機能
happyfox_list_tickets	読み取り	チケットの一覧表示または検索
happyfox_get_ticket	読み取り	チケットを 1 件取得
happyfox_list_contacts	読み取り	連絡先の一覧表示または検索
happyfox_get_contact	読み取り	連絡先を 1 件取得
happyfox_list_contact_groups	読み取り	連絡先グループの一覧表示
happyfox_get_contact_group	読み取り	連絡先グループを 1 件取得
happyfox_list_categories	読み取り	カテゴリの一覧表示
happyfox_list_staff	読み取り	エージェントの一覧表示
happyfox_list_statuses	読み取り	ステータスの一覧表示
happyfox_list_priorities	読み取り	優先度の一覧表示
happyfox_list_ticket_custom_fields	読み取り	チケットのカスタムフィールドの一覧表示
happyfox_list_contact_custom_fields	読み取り	連絡先のカスタムフィールドの一覧表示
happyfox_list_reports	読み取り	レポートの一覧表示
happyfox_get_report_summary	読み取り	レポートの概要を取得
happyfox_get_report_tabular_data	読み取り	レポートのチケット行を取得
happyfox_list_kb_articles	読み取り	ナレッジベースの記事をエクスポート
happyfox_create_ticket	書き込み	チケットを作成
happyfox_add_staff_reply	書き込み	エージェントとしてチケットに返信
happyfox_add_private_note	書き込み	チケットに非公開メモを追加
happyfox_update_ticket_tags	書き込み	チケットタグを追加または削除
happyfox_update_ticket_custom_fields	書き込み	チケットのカスタムフィールドを編集
happyfox_create_contact	書き込み	連絡先を作成
happyfox_update_contact	書き込み	連絡先を編集
happyfox_usage_status	メタ	使用状況（無料プランの利用状況メーター）
happyfox_request_feature	メタ	不足している機能をリクエスト
happyfox_upgrade	メタ	Pro にアップグレード（無制限*）
happyfox_cancel_subscription	メタ	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で実行を確認する必要があります。meta ツールは使用状況の報告、サブスクリプションの管理、または機能リクエストの送信を行います。

料金プラン

プラン	料金	上限
無料	$0	月50回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2か月無料）	無制限*

*Pro には、このサーバーで月10,000回のツール呼び出しという公正利用上限があります。それ以上必要な場合は、[email protected] までお問い合わせください。

Pro の対象はこのサーバーのみです。happyfox_upgrade で登録してください（Stripe Checkout のリンクが返されます）。happyfox_cancel_subscription でいつでもキャンセルできます。Pro は有料期間の終了まで利用でき、現在の期間分の返金はありません。また、終了前に happyfox_upgrade を実行すると、キャンセルが取り消されます。あるいは、[email protected] までお問い合わせください。

ライセンス

MIT © usefulapi。HappyFox との提携や、同社からの承認はありません。