Freshdesk MCP server

Freshdesk MCP 服务器

与 Freshdesk 集成的 MCP 服务器实现，使 AI 模型能够与 Freshdesk 模块交互并执行各种支持操作。

特征

• Freshdesk 集成：与 Freshdesk API 端点无缝交互
• AI 模型支持：使 AI 模型能够通过 Freshdesk 执行支持操作
• 自动票务管理：处理票务创建、更新和响应

成分

工具

该服务器为 Freshdesk 操作提供了多种工具：

• create_ticket ：创建新的支持票
  • 输入：
    • subject （字符串，必填）：票证主题
    • description （字符串，必需）：票证描述
    • source （数字，必填）：票证源代码
    • priority （数字，必填）：工单优先级
    • status （数字，必填）：票证状态代码
    • email （字符串，可选）：请求者的电子邮件
    • requester_id （数字，可选）：请求者的 ID
    • custom_fields （对象，可选）：在工单上设置的自定义字段
• update_ticket ：更新现有票证
  • 输入：
    • ticket_id （数字，必填）：要更新的工单的 ID
    • updates （对象，必需）：要更新的字段
• delete_ticket ：删除票证
  • 输入：
    • ticket_id （数字，必填）：要删除的票证的 ID
• search_tickets ：根据条件搜索票证
  • 输入：
    • query （字符串，必需）：搜索查询字符串
• get_ticket_fields ：获取所有票证字段
  • 输入：
    • 没有任何
• get_tickets ：获取所有票证
  • 输入：
    • page （数字，可选）：要获取的页码
    • per_page （数字，可选）：每页票数
• get_ticket ：获取单程票
  • 输入：
    • ticket_id （数字，必填）：要获取的票证的 ID

入门

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 freshdesk_mcp：

先决条件

• Freshdesk 帐户（在freshdesk.com注册）
• Freshdesk API 密钥
• 已安装uvx （ pip install uv或brew install uv ）

配置

1. 从 Freshdesk 管理面板生成您的 Freshdesk API 密钥
2. 设置您的域和身份验证详细信息

与 Claude Desktop 一起使用

1. 如果你还没有安装 Claude Desktop
2. 将以下配置添加到您的claude_desktop_config.json ：

重要提示：

• 将YOUR_FRESHDESK_API_KEY替换为您的实际 Freshdesk API 密钥
• 将YOUR_FRESHDESK_DOMAIN替换为您的 Freshdesk 域名（例如， yourcompany.freshdesk.com ）

示例操作

配置完成后，您可以要求 Claude 执行如下操作：

• 创建一张新票据，主题为‘客户 A101 的付款问题’，描述为‘上个月联系客户 A101 解决付款问题’，客户邮箱为a101@acme.com ，并将优先级设置为高”
• “将票号 12345 的状态更新为‘已解决’”
• “列出分配给代理 John Doe 的所有高优先级票证”
• “列出客户 A101 在过去 30 天内的先前工单”

测试

为了测试目的，您可以手动启动服务器：

故障排除

• 验证您的 Freshdesk API 密钥和域名是否正确
• 确保与 Freshdesk 服务器的网络连接正常
• 检查 API 速率限制和配额
• 验证uvx命令是否在您的 PATH 中可用

执照

此 MCP 服务器采用 MIT 许可证。请参阅项目仓库中的 LICENSE 文件以了解更多详细信息。