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	读取	获取单个工单
happyfox_list_contacts	读取	列出或搜索联系人
happyfox_get_contact	读取	获取单个联系人
happyfox_list_contact_groups	读取	列出联系人组
happyfox_get_contact_group	读取	获取单个联系人组
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 无关联，也未获得其认可。