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. Zendesk の認証情報を含む `.env` ファイルを作成します:
   ```
   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 のエージェントグループを一覧表示します
- `get_group`: ID で特定のグループを取得します
- `create_group`: 新しいエージェントグループを作成します
- `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