Happyfox

io.usefulapiv1.0.0更新于 Sep 30, 2026

Triage HappyFox tickets, contacts and KB articles, run reports, and reply or add private notes.

已验证Streamable HTTP可网页运行Business & CommerceProductivity & Workflow

概览

AI 生成的概览

让助手读取和更新 HappyFox 服务台的工单、联系人、知识库文章和报表。

功能
通过托管 MCP 端点把助手连接到 HappyFox 服务台。读取类工具可列出或获取工单、联系人、联系人组、分类、客服人员、状态、优先级、自定义字段、报表和知识库文章。写入类工具可创建工单和联系人、编辑联系人、以客服身份回复工单、添加内部备注，以及修改工单标签或自定义字段。元工具用于查看用量和管理订阅。
适用场景
适合客服工作集中在 HappyFox、希望助手帮忙分拣工单、查询联系人或知识库文章、提取报表数据，或起草回复和备注而无需切换到网页界面的场景。如果不使用 HappyFox 作为服务台，则用处不大。
运行要求
远程 MCP 端点，无需本地安装。需要提供 HappyFox 服务台子域名、区域、API 密钥和授权码（在 Manage、Integrations、API 中创建）。凭据会经过校验并按用户存储，不写入配置文件。需要能访问该端点的网络。
安装前请注意
写入类工具会改动真实服务台数据：创建工单和联系人、编辑联系人、以客服身份回复工单、添加内部备注，以及修改标签或自定义字段。回复和备注可能对客户或员工可见，发送前请确认。API 密钥和授权码属于敏感凭据。免费版每月限 100 次工具调用；Pro 版每位用户每月 9 美元或每年 90 美元。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Happyfox，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

HappyFox MCP by usefulapi

Use HappyFox from Claude, Cursor, or any MCP client — triage tickets, contacts and KB articles, run reports, and reply or add private notes. Hosted, no local install: connect with your own HappyFox credentials.

Live endpoint: https://happyfox.usefulapi.io/mcp · Homepage: https://usefulapi.io/happyfox

Add to Claude

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

On first connect you'll provide your HappyFox help-desk subdomain, region, API key and auth code (Manage → Integrations → API → Create API key). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
happyfox_list_ticketsreadList or search tickets
happyfox_get_ticketreadGet one ticket
happyfox_list_contactsreadList or search contacts
happyfox_get_contactreadGet one contact
happyfox_list_contact_groupsreadList contact groups
happyfox_get_contact_groupreadGet one contact group
happyfox_list_categoriesreadList categories
happyfox_list_staffreadList agents
happyfox_list_statusesreadList statuses
happyfox_list_prioritiesreadList priorities
happyfox_list_ticket_custom_fieldsreadList ticket custom fields
happyfox_list_contact_custom_fieldsreadList contact custom fields
happyfox_list_reportsreadList reports
happyfox_get_report_summaryreadGet a report summary
happyfox_get_report_tabular_datareadGet a report's ticket rows
happyfox_list_kb_articlesreadExport knowledge-base articles
happyfox_create_ticketwriteCreate a ticket
happyfox_add_staff_replywriteReply to a ticket as an agent
happyfox_add_private_notewriteAdd a private note to a ticket
happyfox_update_ticket_tagswriteAdd or remove ticket tags
happyfox_update_ticket_custom_fieldswriteEdit a ticket's custom fields
happyfox_create_contactwriteCreate a contact
happyfox_update_contactwriteEdit a contact
happyfox_usage_statusmetaUsage status (free-tier meter)
happyfox_upgrademetaUpgrade to Pro (unlimited)

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

MIT © usefulapi. Not affiliated with or endorsed by HappyFox.

来源：servers/happyfox/README.md，提交 1ec23c2

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Sep 30, 2026