关于 SupportBee MCP by usefulapi
SupportBee MCP by usefulapi 是托管式 MCP 服务,可让 Claude、Cursor 等 MCP 客户端处理 SupportBee 工单。它提供工单和报告访问,并支持回复、内部评论、分配、标签管理及归档。
主要功能
- 01列出、搜索和查看工单
- 02读取回复、评论和审计记录
- 03查看团队、用户和报告
- 04回复工单并添加内部评论
- 05分配、标记和归档工单
适用场景
- 01查找工单并查看对话记录
- 02通过分配团队或用户进行工单分流
- 03回复客户或添加内部备注
MCP 相关
通过托管端点向 MCP 客户端提供 SupportBee 工单与报告读取工具,以及工单管理写入工具。使用 OAuth 登录,并通过用户的 SupportBee 凭据连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://supportbee.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-supportbee https://supportbee.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-supportbee":{"type":"http","url":"https://supportbee.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-supportbee":{"type":"http","url":"https://supportbee.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-supportbee":{"type":"http","url":"https://supportbee.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-supportbee":{"serverUrl":"https://supportbee.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
22| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码,从 1 开始(默认值为 1)。使用上一条回复中的 next_page。 |
| spam | boolean | 否 | 包含标记为垃圾邮件的工单(默认为 false)。 |
| label | string | 否 | 仅包含标签名称与此值一致的工单(supportbee_list_labels)。 |
| since | string | 否 | 仅包含最后活动时间晚于此时间的工单(日期、ISO 日期时间或 Unix 时间戳)。 |
| trash | boolean | 否 | 包含已移至回收站的工单(默认值为 false)。 |
| until | string | 否 | 仅包含最后活动时间早于此时间的工单(日期、ISO 日期时间或 Unix 时间戳)。 |
| sort_by | enum | 否 | 排序顺序(默认值为 last_activity)。last_activity | creation_time |
| archived | enum | 否 | true = 仅归档工单,false = 不包含归档工单(默认值),any = 两者都包含。true | false | any |
| per_page | integer | 否 | 每页工单数,1-99(默认值为 15)。 |
| total_only | boolean | 否 | 仅返回匹配工单的总数。 |
| has_replies | boolean | 否 | true = 仅包含有回复的工单,false = 仅包含没有回复的工单。 |
| max_replies | integer | 否 | 仅包含回复数为此值的工单(不与 has_replies=false 同时使用)。 |
| assigned_team | string | 否 | mine = 分配给用户所属团队,团队 ID(来自 supportbee_list_teams),none = 未分配团队。 |
| assigned_user | string | 否 | me = 分配给令牌所属用户,Agent ID(来自 supportbee_list_users),any = 已分配给某人,none = 未分配。 |
| requester_emails | array | 否 | 仅包含来自这些请求者电子邮件地址的工单(最多 10 个)。 |
详细介绍
usefulapi 的 SupportBee MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 SupportBee——处理工单、回复、评论、标签、团队、用户和报告,还可回复和分拣工单。 托管服务,无需本地安装:使用你自己的 SupportBee 凭据连接。
在线端点: https://supportbee.usefulapi.io/mcp · 主页: https://usefulapi.io/supportbee
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://supportbee.usefulapi.io/mcp。 - Claude Code: 运行
claude mcp add --transport http supportbee https://supportbee.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"supportbee": {
"url": "https://supportbee.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 SupportBee 凭据。
分步设置说明、凭据查找位置和常见问题解答:https://usefulapi.io/supportbee/
工具
| 工具 | 类型 | 功能 |
|---|---|---|
supportbee_list_tickets | read | 列出工单 |
supportbee_search_tickets | read | 搜索工单 |
supportbee_get_ticket | read | 获取工单 |
supportbee_list_replies | read | 列出工单的回复 |
supportbee_get_reply | read | 获取工单的一条回复 |
supportbee_list_comments | read | 列出工单的内部评论 |
supportbee_get_ticket_audit | read | 获取工单的审计记录 |
supportbee_list_labels | read | 列出标签 |
supportbee_list_teams | read | 列出团队 |
supportbee_list_users | read | 列出用户 |
supportbee_get_user | read | 获取用户 |
supportbee_list_snippets | read | 列出片段 |
supportbee_list_forwarding_addresses | read | 列出转发地址 |
supportbee_get_report | read | 获取报告 |
supportbee_reply_to_ticket | write | 回复工单(会发送电子邮件) |
supportbee_add_comment | write | 为工单添加内部评论 |
supportbee_add_label | write | 为工单添加标签 |
supportbee_remove_label | write | 移除工单的标签 |
supportbee_assign_ticket | write | 将工单分配给用户或团队 |
supportbee_unassign_ticket | write | 移除工单的用户或团队分配 |
supportbee_set_ticket_archived | write | 归档或取消归档工单 |
supportbee_set_ticket_answered | write | 将工单标记为已回复或未回复 |
supportbee_usage_status | meta | 使用情况(免费套餐额度计量) |
supportbee_request_feature | meta | 请求添加缺失的功能 |
supportbee_upgrade | meta | 升级到 Pro(无限量*) |
supportbee_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告使用情况、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(每家公司) | $9/mo 或 $90/yr(免费 2 个月) | 无限量* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 supportbee_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。可随时使用 supportbee_cancel_subscription 取消:Pro 服务会持续到已付费周期结束,当前周期不予退款;在此之前运行 supportbee_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 SupportBee 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。