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：

npx -y @smithery/cli install @effytech/freshdesk_mcp --client claude

先决条件

• 一个 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 中添加以下配置：

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

重要提示:

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

示例操作

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

• “创建一个新工单，主题为'客户A101的付款问题'，描述为'就上个月客户A101的付款问题进行联系'，客户的电子邮件是a101@acme.com，并将优先级设置为高”
• “将工单#12345的状态更新为'已解决'”
• “列出分配给代理John Doe的所有高优先级工单”
• “列出过去30天内客户A101的所有历史工单”

测试

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

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

故障排除

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

许可证

此MCP服务器根据MIT许可证授权。有关完整详情，请参阅项目仓库中的LICENSE文件。