# Freshdesk MCP工具
## 基本信息
- Slug: `effytech-freshdesk_mcp`
- Source: modelscope
- Publisher: @effytech/freshdesk_mcp
- Categories: customer-support / communication
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@effytech/freshdesk_mcp
## 简介
将AI模型与Freshdesk集成，以自动化的支持操作。通过Freshdesk API无缝创建、更新和管理支持工单。通过自动化的工单管理和基于AI的互动，提升您的客户服务体验。
## 安装提示

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

## MCP Server 详情

# Freshdesk MCP 服务器
[![smithery 徽章](https://smithery.ai/badge/@effytech/freshdesk_mcp)](https://smithery.ai/server/@effytech/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](https://smithery.ai/server/@effytech/freshdesk_mcp) 自动为 Claude Desktop 安装 freshdesk_mcp：

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


### 先决条件

- 一个 Freshdesk 账户（在 [freshdesk.com](https://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` 中添加以下配置：

```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的所有历史工单”

## 测试

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

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


## 故障排除

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

## 许可证

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