Zendesk API とやり取りするための包括的なモデルコンテキストプロトコル(MCP)サーバー。 Zendesk サポート、トーク、チャット、ガイド製品を管理するためのツールとリソースを提供します。

##特徴

• Zen APIdesk の機能の完全なカバレッジ
• チケット、ユーザー、組織などを管理するためのツール
• Zen API ドキュメントにアクセスするためのリソース
• Zen APIdeskトークンでセキュアな認証

はじめる

前提条件

• Node.js 14以上
• APIアクセスによるZendeskアカウント

インストール

1. このリポジトリをクローンする

2. 依存関係を取付けて下さい:

3. Zendesk の認証情報で [.env] ファイルを作成します。

サーバーの実行

サーバを起動します。

自動再起動による開発のため:

##MCPインスペクタによるテスト

MCPインスペクタを使用してサーバーをテストします。

利用可能なツール

##チケット

• [get_ticket: IDで特定のチケットを入手

ユーザー

• [list_users]: Zendesk のユーザー一覧
• [create_user: 新規ユーザーを作成する

Zendesk API MCP Server

A comprehensive Model Context Protocol (MCP) server for interacting with the Zendesk API. This server provides tools and resources for managing Zendesk Support, Talk, Chat, and Guide products.

## Features

- Complete coverage of Zendesk API functionality
- Tools for managing tickets, users, organizations, and more
- Resources for accessing Zendesk API documentation
- Secure authentication with Zendesk API tokens

## Getting Started

### Prerequisites

- Node.js 14 or higher
- A Zendesk account with API access

### Installation

1. Clone this repository
2. Install dependencies:
   ```
   npm install
   ```
3. Create a `.env` file with your Zendesk credentials:
   ```
   ZENDESK_SUBDOMAIN=your-subdomain
   [email protected]
   ZENDESK_API_TOKEN=your-api-token
   ```

### Running the Server

Start the server:
```
npm start
```

For development with auto-restart:
```
npm run dev
```

### Testing with MCP Inspector

Test the server using the MCP Inspector:
```
npm run inspect
```

## Available Tools

### Tickets
- `list_tickets`: List tickets in Zendesk
- `get_ticket`: Get a specific ticket by ID
- `create_ticket`: Create a new ticket
- `update_ticket`: Update an existing ticket
- `delete_ticket`: Delete a ticket

### Users
- `list_users`: List users in Zendesk
- `get_user`: Get a specific user by ID
- `create_user`: Create a new user
- `update_user`: Update an existing user
- `delete_user`: Delete a user

### Organizations
- `list_organizations`: List organizations in Zendesk
- `get_organization`: Get a specific organization by ID
- `create_organization`: Create a new organization
- `update_organization`: Update an existing organization
- `delete_organization`: Delete an organization

### Groups
- `list_groups`: List agent groups in Zendesk
- `get_group`: Get a specific group by ID
- `create_group`: Create a new agent group
- `update_group`: Update an existing group
- `delete_group`: Delete a group

### Macros
- `list_macros`: List macros in Zendesk
- `get_macro`: Get a specific macro by ID
- `create_macro`: Create a new macro
- `update_macro`: Update an existing macro
- `delete_macro`: Delete a macro

### Views
- `list_views`: List views in Zendesk
- `get_view`: Get a specific view by ID
- `create_view`: Create a new view
- `update_view`: Update an existing view
- `delete_view`: Delete a view

### Triggers
- `list_triggers`: List triggers in Zendesk
- `get_trigger`: Get a specific trigger by ID
- `create_trigger`: Create a new trigger
- `update_trigger`: Update an existing trigger
- `delete_trigger`: Delete a trigger

### Automations
- `list_automations`: List automations in Zendesk