关于 Freshdesk MCP by usefulapi
Freshdesk MCP by usefulapi 是面向 Freshdesk 支持团队的托管 MCP 服务。MCP 客户端可查看工单及相关记录,并创建或更新工单和联系人、回复工单及添加备注。
主要功能
- 01列出、查看和搜索工单
- 02读取工单对话
- 03浏览联系人和公司
- 04查看客服人员和分组
- 05创建、更新和回复工单
- 06添加工单备注并管理联系人
适用场景
- 01通过搜索查找工单
- 02查看工单对话历史
- 03回复支持请求或添加备注
- 04创建或更新联系人或公司
MCP 相关
它将 Freshdesk 工单、对话、联系人、公司、客服人员和分组作为 MCP 工具提供,并支持工单和联系人写入操作。托管服务在登录时使用提供的 Freshdesk 域名和 API 密钥连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://freshdesk.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-freshdesk https://freshdesk.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-freshdesk":{"type":"http","url":"https://freshdesk.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-freshdesk":{"serverUrl":"https://freshdesk.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
19| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 分页页码(从 1 开始)。 |
| string | 否 | 按请求者邮箱筛选。 | |
| filter | enum | 否 | 预定义筛选条件:new_and_my_open、watching、spam 或 deleted。new_and_my_open | watching | spam | deleted |
| include | string | 否 | 嵌入额外数据,以逗号分隔,例如 "requester,stats,description"。 |
| order_by | enum | 否 | 排序字段:created_at、due_by、updated_at 或 status。created_at | due_by | updated_at | status |
| per_page | integer | 否 | 每页结果数(1-100,最多 100,默认 30)。 |
| company_id | integer | 否 | 按公司 ID 筛选。 |
| order_type | enum | 否 | 排序方向:asc 或 desc。asc | desc |
| requester_id | integer | 否 | 按请求者(联系人)ID 筛选。 |
| updated_since | string | 否 | 仅显示此 ISO 8601 时间戳之后更新的工单。 |
详细介绍
usefulapi 提供的 Freshdesk MCP
通过 Claude、Cursor 或任何 MCP 客户端使用你的 Freshdesk 账户——读取工单、联系人、公司、客服人员和群组,并创建、更新或回复工单。托管服务, 无需本地安装:使用你自己的凭据连接。
在线端点: https://freshdesk.usefulapi.io/mcp · 主页: https://usefulapi.io
连接
- Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴
https://freshdesk.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http freshdesk https://freshdesk.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将此 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"freshdesk": {
"url": "https://freshdesk.usefulapi.io/mcp"
}
}
}
仅添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Freshdesk 凭据。
分步设置指南、凭据查找方式和常见问题解答:https://usefulapi.io/freshdesk/
首次连接时,你需要提供 Freshdesk 域名和 API 密钥(在个人资料设置中)。系统会验证密钥,并按用户单独存储和限定使用范围——配置文件中不会包含 密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
freshdesk_list_tickets | 读取 | 列出工单 |
freshdesk_get_ticket | 读取 | 获取工单 |
freshdesk_search_tickets | 读取 | 搜索工单 |
freshdesk_list_ticket_conversations | 读取 | 列出工单对话 |
freshdesk_list_contacts | 读取 | 列出联系人 |
freshdesk_get_contact | 读取 | 获取联系人 |
freshdesk_search_contacts | 读取 | 搜索联系人 |
freshdesk_list_companies | 读取 | 列出公司 |
freshdesk_get_company | 读取 | 获取公司 |
freshdesk_list_agents | 读取 | 列出客服人员 |
freshdesk_get_agent | 读取 | 获取客服人员 |
freshdesk_list_groups | 读取 | 列出群组 |
freshdesk_create_ticket | 写入 | 创建工单 |
freshdesk_update_ticket | 写入 | 更新工单 |
freshdesk_reply_ticket | 写入 | 回复工单 |
freshdesk_add_note | 写入 | 为工单添加备注 |
freshdesk_create_contact | 写入 | 创建联系人 |
freshdesk_update_contact | 写入 | 更新联系人 |
freshdesk_create_company | 写入 | 创建公司 |
freshdesk_usage_status | 元数据 | 使用情况状态(免费套餐用量计数) |
freshdesk_request_feature | 元数据 | 申请所需功能 |
freshdesk_upgrade | 元数据 | 升级到 Pro(无限制*) |
freshdesk_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应要求确认);meta 工具用于报告使用情况、管理订阅或提交功能申请。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费 | $0 | 每月 50 次工具调用 |
| Pro | $9/月 或 $90/年(免费 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 freshdesk_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。可随时使用 freshdesk_cancel_subscription 取消:Pro 服务会持续到已付费周期结束,当前周期不予退款;在此之前运行 freshdesk_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。
许可证
MIT — 参见 LICENSE。仅提供文档;服务由托管方提供。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。