Руководство по настройке интеграции 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 в JavaScript в каталоге dist .

2. Для разработки можно использовать:

   npm run dev

Установка с помощью приложения Claude Desktop

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 Desktop, чтобы изменения вступили в силу.

Доступные инструменты Zendesk

Интеграция MCP Zendesk обеспечивает следующие функции:

1. zendesk_get_ticket — Извлекает тикет по идентификатору

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 — добавляет публичный комментарий к тикету

8. zendesk_get_linked_incidents — извлекает все заявки на инциденты, связанные с определенной заявкой

Настройка аутентификации

1. Создайте токен API в Центре администрирования Zendesk:

   • Перейдите в Центр администрирования > Приложения и интеграции > API > Zendesk API

   • Добавьте токен API и скопируйте его.

2. Используйте свой адрес электронной почты и токен API в конфигурации MCP

Поиск неисправностей

• Если вы столкнулись с ошибками авторизации, проверьте, действителен ли ваш API-токен.

• Убедитесь, что ваш поддомен Zendesk указан правильно.

• Проверьте правильность настройки переменных среды.

• Перезапустите сервер MCP после внесения изменений.