Zendesk MCP Server

Zendesk MCP 統合設定ガイド

リポジトリのセットアップ

1. リポジトリをクローンします。
   git clone https://your-repo-url/mcp-experiments.git cd mcp-experiments/zd-mcp-server
2. 依存関係をインストールします:
   npm install
3. 開発環境で環境変数を設定します。
   export ZENDESK_EMAIL="your-email@example.com" export ZENDESK_TOKEN="your-zendesk-api-token" export ZENDESK_SUBDOMAIN="your-zendesk-subdomain"

プロジェクトの構築

1. TypeScript プロジェクトをビルドします。
   npm run build
   これにより、TypeScript ファイルがdistディレクトリ内の JavaScript にコンパイルされます。
2. 開発には以下を使用できます:
   npm run dev

Claudeデスクトップアプリでインストール

1. Claude Desktop 構成ファイル ( claude_desktop_config.json ) を更新します。
   { "tools": { "zendesk": { "command": "node", "env": { "ZENDESK_EMAIL": "internal@z3nmail.com", "ZENDESK_TOKEN": "your-zendesk-api-token", "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain" }, "args": [ "/path/to/mcp-experiments/zd-mcp-server/dist/index.js" ] } } }
2. 環境変数を実際の Zendesk 資格情報に置き換えます。
3. ビルドした index.js ファイルの場所と一致するようにパスを更新します。
4. 変更を有効にするには、Claude デスクトップ アプリケーションを再起動します。

利用可能なZendeskツール

MCP Zendesk 統合では、次の機能が提供されます。

1. zendesk_get_ticket - IDでチケットを取得します
2. zendesk_get_ticket_details - コメントを含むチケットの詳細を取得します
3. zendesk_search - Zendeskクエリ構文でチケットを検索します
4. zendesk_create_ticket - 新しいチケットを作成する
5. zendesk_update_ticket - チケットのプロパティを更新します
6. zendesk_add_private_note - チケットに内部メモを追加します
7. zendesk_add_public_note - チケットにパブリックコメントを追加します

認証設定

1. Zendesk 管理センターで API トークンを生成します。
   • 管理センター > アプリと統合 > API > Zendesk API に移動します。
   • APIトークンを追加してコピーする
2. MCP設定でメールアドレスとAPIトークンを使用します

トラブルシューティング

• 認証エラーが発生した場合は、APIトークンが有効であることを確認してください。
• Zendeskのサブドメインが正しいことを確認してください
• 環境変数が正しく設定されているか確認する
• 変更を加えたらMCPサーバーを再起動します