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サーバーを再起動します