Freshdesk MCP Server

这是一个与Freshdesk集成的MCP服务器实现，使AI模型能够通过Freshdesk模块执行各种支持操作。

特性

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

组件

工具

该服务器提供了多个用于Freshdesk操作的工具：

• create_ticket：创建新的支持工单

  • 输入：
    • subject（字符串，必需）：工单主题
    • description（字符串，必需）：工单描述
    • source（数字，必需）：工单来源代码
    • priority（数字，必需）：工单优先级
    • status（数字，必需）：工单状态代码
    • email（字符串，可选）：请求者的电子邮件
    • requester_id（数字，可选）：请求者的ID
    • custom_fields（对象，可选）：设置在工单上的自定义字段
    • additional_fields（对象，可选）：其他顶级字段

• update_ticket：更新现有工单

  • 输入：
    • ticket_id（数字，必需）：要更新的工单ID
    • ticket_fields（对象，必需）：要更新的字段

• delete_ticket：删除工单

  • 输入：
    • ticket_id（数字，必需）：要删除的工单ID

• search_tickets：根据条件搜索工单

  • 输入：
    • query（字符串，必需）：搜索查询字符串

• get_ticket_fields：获取所有工单字段

  • 输入：
    • 无

• get_tickets：获取所有工单

  • 输入：
    • page（数字，可选）：要获取的页码
    • per_page（数字，可选）：每页的工单数量

• get_ticket：获取单个工单

  • 输入：
    • ticket_id（数字，必需）：要获取的工单ID

• get_ticket_conversation：获取工单的对话

  • 输入：
    • ticket_id（数字，必需）：工单ID

• create_ticket_reply：回复工单

  • 输入：
    • ticket_id（数字，必需）：工单ID
    • body（字符串，必需）：回复内容

• create_ticket_note：向工单添加备注

  • 输入：
    • ticket_id（数字，必需）：工单ID
    • body（字符串，必需）：备注内容

• update_ticket_conversation：更新对话

  • 输入：
    • conversation_id（数字，必需）：对话ID
    • body（字符串，必需）：更新的内容

• view_ticket_summary：获取工单摘要

  • 输入：
    • ticket_id（数字，必需）：工单ID

• update_ticket_summary：更新工单摘要

• 输入：

  • ticket_id（数字，必需）：工单ID
  • body（字符串，必需）：新的摘要内容

• delete_ticket_summary：删除工单摘要

  • 输入：
    • ticket_id（数字，必需）：工单ID

• get_agents：获取所有代理

  • 输入：
    • page（数字，可选）：页码
    • per_page（数字，可选）：每页的代理数量

• view_agent：获取单个代理

  • 输入：
    • agent_id（数字，必需）：代理ID

• create_agent：创建新代理

  • 输入：
    • agent_fields（对象，必需）：代理详情

• update_agent：更新代理

  • 输入：
    • agent_id（数字，必需）：代理ID
    • agent_fields（对象，必需）：要更新的字段

• search_agents：搜索代理

  • 输入：
    • query（字符串，必需）：搜索查询

• list_contacts：获取所有联系人

  • 输入：
    • page（数字，可选）：页码
    • per_page（数字，可选）：每页的联系人数

• get_contact：获取单个联系人

  • 输入：
    • contact_id（数字，必需）：联系人ID

• search_contacts：搜索联系人

  • 输入：
    • query（字符串，必需）：搜索查询

• update_contact：更新联系人

  • 输入：
    • contact_id（数字，必需）：联系人ID
    • contact_fields（对象，必需）：要更新的字段

• list_companies：获取所有公司

  • 输入：
    • page（数字，可选）：页码
    • per_page（数字，可选）：每页的公司数

• view_company：获取单个公司

  • 输入：
    • company_id（数字，必需）：公司ID

• search_companies：搜索公司

  • 输入：
    • query（字符串，必需）：搜索查询

• find_company_by_name：按名称查找公司

  • 输入：
    • name（字符串，必需）：公司名称

• list_company_fields：获取所有公司字段

  • 输入：
    • 无

开始使用

通过 Smithery 安装

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

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文件以获取详细信息。