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 в 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 после внесения изменений.