Zendesk API MCP Server

Zendesk API MCP 服务

用于与 Zendesk API 交互的综合性 Model Context Protocol（MCP）服务。此服务提供用于管理 Zendesk Support、Talk、Chat 和 Guide 产品的工具和资源。

## 功能

- 全面覆盖 Zendesk API 功能
- 提供用于管理工单、用户、组织等的工具
- 提供用于访问 Zendesk API 文档的资源
- 使用 Zendesk API 令牌进行安全身份验证

## 入门

### 先决条件

- Node.js 14 或更高版本
- 拥有 API 访问权限的 Zendesk 账户

### 安装

1. 克隆此存储库
2. 安装依赖项：
   ```
   npm install
   ```
3. 创建 `.env` 文件并填写 Zendesk 凭据：
   ```
   ZENDESK_SUBDOMAIN=your-subdomain
   [email protected]
   ZENDESK_API_TOKEN=your-api-token
   ```

### 运行服务

启动服务：
```
npm start
```

开发时启用自动重启：
```
npm run dev
```

### 使用 MCP Inspector 测试

使用 MCP Inspector 测试服务：
```
npm run inspect
```

## 可用工具

### 工单
- `list_tickets`：列出 Zendesk 中的工单
- `get_ticket`：按 ID 获取特定工单
- `create_ticket`：创建新工单
- `update_ticket`：更新现有工单
- `delete_ticket`：删除工单

### 用户
- `list_users`：列出 Zendesk 中的用户
- `get_user`：按 ID 获取特定用户
- `create_user`：创建新用户
- `update_user`：更新现有用户
- `delete_user`：删除用户

### 组织
- `list_organizations`：列出 Zendesk 中的组织
- `get_organization`：按 ID 获取特定组织
- `create_organization`：创建新组织
- `update_organization`：更新现有组织
- `delete_organization`：删除组织

### 组
- `list_groups`：列出 Zendesk 中的 Agent 组
- `get_group`：按 ID 获取特定组
- `create_group`：创建新的 Agent 组
- `update_group`：更新现有组
- `delete_group`：删除组

### 宏
- `list_macros`：列出 Zendesk 中的宏
- `get_macro`：按 ID 获取特定宏
- `create_macro`：创建新宏
- `update_macro`：更新现有宏
- `delete_macro`：删除宏

### 视图
- `list_views`：列出 Zendesk 中的视图
- `get_view`：按 ID 获取特定视图
- `create_view`：创建新视图
- `update_view`：更新现有视图
- `delete_view`：删除视图

### 触发器
- `list_triggers`：列出 Zendesk 中的触发器
- `get_trigger`：按 ID 获取特定触发器
- `create_trigger`：创建新触发器
- `update_trigger`：更新现有触发器
- `delete_trigger`：删除触发器

### 自动化
- `list_automations`：列出 Zendesk 中的自动化
- `get_automation`：按 ID 获取特定自动化
- `create_automation`：创建新的自动化
- `update_automation`：更新现有自动化
- `delete_automation`：删除自动化

### 搜索
- `search`：搜索 Zendesk 数据

### 帮助中心
- `list_articles`：列出帮助中心文章
- `get_article`：按 ID 获取特定帮助中心文章
- `create_article`：创建新的帮助中心文章
- `update_article`：更新现有帮助中心文章
- `delete_article`：删除帮助中心文章

### Talk
- `get_talk_stats`：获取 Zendesk Talk 统计数据

### Chat
- `list_chats`：列出 Zendesk Chat 对话

## 可用资源

- `zendesk://docs/{section}`：访问 Zendesk API 不同部分的文档

## 许可证

MIT