Freshdesk MCP Server

Freshdesk MCP 服务

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

功能

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

组件

工具

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

• create_ticket：创建新的支持工单

  • 输入：
    • subject（string，必填）：工单主题
    • description（string，必填）：工单描述
    • source（number，必填）：工单来源代码
    • priority（number，必填）：工单优先级
    • status（number，必填）：工单状态代码
    • email（string，可选）：请求者的电子邮件地址
    • requester_id（number，可选）：请求者的 ID
    • custom_fields（object，可选）：要设置到工单的自定义字段
    • additional_fields（object，可选）：其他顶层字段

• update_ticket：更新现有工单

  • 输入：
    • ticket_id（number，必填）：要更新的工单 ID
    • ticket_fields（object，必填）：要更新的字段

• delete_ticket：删除工单

  • 输入：
    • ticket_id（number，必填）：要删除的工单 ID

• search_tickets：根据条件搜索工单

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

• get_ticket_fields：获取所有工单字段

  • 输入：
    • 无

• get_tickets：获取所有工单

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

• get_ticket：获取单个工单

  • 输入：
    • ticket_id（number，必填）：要获取的工单 ID

• get_ticket_conversation：获取工单的对话

  • 输入：
    • ticket_id（number，必填）：工单 ID

• create_ticket_reply：回复工单

  • 输入：
    • ticket_id（number，必填）：工单 ID
    • body（string，必填）：回复内容
    • cc_emails（array of strings，可选）：添加到外发电子邮件“cc”字段的其他电子邮件地址。这些地址会与工单请求者一同作为收件人，但请求者始终是主要收件人
    • bcc_emails（array of strings，可选）：添加到外发电子邮件“bcc”字段的其他电子邮件地址。这些地址会与工单请求者一同作为收件人，但请求者始终是主要收件人
    • from_email（string，可选）：发送回复所用的电子邮件地址
    • user_id（number，可选）：添加回复的 Agent ID

• create_ticket_note：向工单添加备注

  • 输入：
    • ticket_id（number，必填）：工单 ID
    • body（string，必填）：备注内容

• update_ticket_conversation：更新对话

  • 输入：
    • conversation_id（number，必填）：对话 ID
    • body（string，必填）：更新后的内容

• view_ticket_summary：获取工单摘要

  • 输入：
    • ticket_id（number，必填）：工单 ID

• update_ticket_summary：更新工单摘要

  • 输入：
    • ticket_id（number，必填）：工单 ID
    • body（string，必填）：新的摘要内容

• delete_ticket_summary：删除工单摘要

  • 输入：
    • ticket_id（number，必填）：工单 ID

• get_agents：获取所有 Agent

  • 输入：
    • page（number，可选）：页码
    • per_page（number，可选）：每页的 Agent 数量

• view_agent：获取单个 Agent

  • 输入：
    • agent_id（number，必填）：Agent 的 ID

• create_agent：创建新 Agent

  • 输入：
    • agent_fields（object，必填）：Agent 详情

• update_agent：更新 Agent

  • 输入：
    • agent_id（number，必填）：Agent 的 ID
    • agent_fields（object，必填）：要更新的字段

• search_agents：搜索 Agent

  • 输入：
    • query（string，必填）：搜索查询

• list_contacts：获取所有联系人

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

• get_contact：获取单个联系人

  • 输入：
    • contact_id（number，必填）：联系人的 ID

• search_contacts：搜索联系人

  • 输入：
    • query（string，必填）：搜索查询

• update_contact：更新联系人

  • 输入：
    • contact_id（number，必填）：联系人的 ID
    • contact_fields（object，必填）：要更新的字段

• list_companies：获取所有公司

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

• view_company：获取单个公司

  • 输入：
    • company_id（number，必填）：公司的 ID

• search_companies：搜索公司

  • 输入：
    • query（string，必填）：搜索查询

• find_company_by_name：按名称查找公司

  • 输入：
    • name（string，必填）：公司名称

• list_company_fields：获取所有公司字段

  • 输入：
    • 无

入门指南

通过 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，处理其上个月的付款问题’，客户邮箱为 [email protected]，并将优先级设为高”
• “将工单 #12345 的状态更新为‘已解决’”
• “列出分配给 Agent 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 文件。