关于 Enchant MCP by usefulapi
Enchant MCP by usefulapi 是托管的 MCP 服务,可供客服团队通过 MCP 客户端处理 Enchant 工单和客户资料。它涵盖只读查询与工单、回复、备注、标签及客户资料修改,并通过 OAuth 登录。
主要功能
- 01列出并读取工单
- 02回复工单并添加内部备注
- 03添加或移除工单标签
- 04查询及管理客户资料
- 05读取用户与附件
适用场景
- 01查看待处理工单及其详情
- 02通过回复或内部备注跟进工单
- 03按标签整理工单
- 04查找或更新客户及联系方式
MCP 相关
此服务通过托管的远程 MCP 服务向 MCP 客户端提供 Enchant 工具,支持工单与客户资料的查询和修改。使用 OAuth 登录并提交 Enchant 凭据。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://enchant.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-enchant https://enchant.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-enchant":{"type":"http","url":"https://enchant.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-enchant":{"type":"http","url":"https://enchant.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-enchant":{"type":"http","url":"https://enchant.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-enchant":{"serverUrl":"https://enchant.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
16| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | array | 否 | 仅包含这些工单 ID。 |
| page | integer | 否 | 页码(从 1 开始)。结果超过 10,000 条后,请改用 since_created_at 进行筛选。 |
| sort | enum | 否 | 排序顺序;前置 - 表示降序。updated_at | -updated_at | created_at | -created_at | user_id | user_id,-updated_at |
| spam | boolean | 否 | 仅包含垃圾(true)或非垃圾(false)工单。 |
| count | boolean | 否 | 如果为 true,还会返回匹配结果总数(额外消耗 1 个速率限制额度)。 |
| trash | boolean | 否 | 仅包含已移至回收站(true)或未移至回收站(false)的工单。 |
| types | array | 否 | 工单类型,例如 email、chat、sms、phone、web、twitter、whatsapp。 |
| states | array | 否 | 仅包含处于这些状态的工单。 |
| per_page | integer | 否 | 每页结果数(0-100,默认值为 10)。与 count 一起使用 0 可仅获取总数。 |
| user_ids | array | 否 | 仅包含分配给这些用户 ID 的工单("null" = 未分配)。 |
| inbox_ids | array | 否 | 仅包含位于这些收件箱 ID 中的工单。 |
| label_ids | array | 否 | 仅包含带有这些标签 ID 的工单。 |
| since_created_at | string | 否 | 仅包含自此 UTC ISO 8601 时间以来创建的工单,例如 2026-01-31T13:41:10Z。 |
| since_updated_at | string | 否 | 仅包含自此 UTC ISO 8601 时间以来更新的工单。 |
详细介绍
usefulapi 的 Enchant MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Enchant——管理工单、回复、备注、标签和客户。 托管服务,无需本地安装:使用你自己的 Enchant 凭据连接。
在线端点: https://enchant.usefulapi.io/mcp · 主页: https://usefulapi.io/enchant
连接
- Claude(claude.ai、桌面应用):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://enchant.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http enchant https://enchant.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"enchant": {
"url": "https://enchant.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Enchant 凭据。
分步设置说明、凭据查找位置及常见问题:https://usefulapi.io/enchant/
工具
| 工具 | 类型 | 用途 |
|---|---|---|
enchant_list_tickets | read | 列出工单 |
enchant_get_ticket | read | 获取工单 |
enchant_list_users | read | 列出用户(客服人员) |
enchant_list_customers | read | 列出客户 |
enchant_get_customer | read | 获取客户 |
enchant_get_attachment | read | 获取附件 |
enchant_create_ticket | write | 创建工单 |
enchant_update_ticket | write | 更新工单 |
enchant_add_ticket_labels | write | 为工单添加标签 |
enchant_remove_ticket_labels | write | 移除工单标签 |
enchant_reply_to_ticket | write | 回复客户 |
enchant_add_note | write | 添加内部备注 |
enchant_create_customer | write | 创建客户 |
enchant_update_customer | write | 更新客户 |
enchant_add_customer_contact | write | 添加客户联系方式 |
enchant_delete_customer_contact | write | 删除客户联系方式 |
enchant_usage_status | meta | 使用情况(免费套餐用量计数) |
enchant_request_feature | meta | 申请添加缺失功能 |
enchant_upgrade | meta | 升级到 Pro(无限制*) |
enchant_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告用量、管理订阅或提交功能申请。
定价
| 套餐 | 价格 | 限制 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。需要更多用量,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 enchant_upgrade 订阅(它会返回 Stripe Checkout 链接)。你可以随时使用 enchant_cancel_subscription 取消:Pro 将持续至已付费周期结束,当前周期费用不予退款;在此之前运行 enchant_upgrade 可撤销取消。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Enchant 无关联,也未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。