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 的所有高优先级工单"
• "列出客户 A101 在过去 30 天内的先前工单"

测试

为了进行测试，您可以手动启动服务器：

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

故障排除

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

许可证

此 MCP 服务器已获得 MIT 许可证的许可。 有关完整详细信息，请参阅项目存储库中的 LICENSE 文件。