Zendesk MCP Server
MCP-сервер Zendesk читает и правит тикеты и комментарии, отдает статьи Help Center и входит через OAuth под правами оператора.
- 126 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Создает и обновляет тикеты и публикует комментарии, которые видят клиенты.
- Читает тикеты с персональными данными клиентов и передает их модели.
Установка
- Работает в
Ручная установка
uv venv && uv pip install -e .Первая команда Setup из README собирает сервер из клонированного репозитория.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает и обновляет тикеты и публикует комментарии, которые видят клиенты.
- Читает тикеты с персональными данными клиентов и передает их модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту работу с Zendesk: список и карточка тикетов, комментарии, создание и обновление тикета, вложения. База знаний Help Center доступна как ресурс `zendesk://knowledge-base`, а подсказки `analyze-ticket` и `draft-ticket-response` помогают разобрать тикет и составить ответ. Вход идет через OAuth с PKCE: каждый оператор авторизуется своей учетной записью Zendesk, поэтому вызовы API получают его роль, группы и доступ к тикетам, а комментарии подписаны его именем. Токены обновляются автоматически и лежат в `~/.config/zendesk-mcp/tokens.json` с правами 0600. Сервер запускается через `uv` или в Docker.
Для кого. Служба поддержки и разработчики, которые разбирают очередь тикетов Zendesk и готовят ответы вместе с агентом.
Подходит, если
- Агент должен прочитать тикет с комментариями и предложить черновик ответа.
- Из статей Help Center берут справку для ответа клиенту.
- Нужно создать или обновить тикет: статус, приоритет, исполнитель, теги.
- Каждый оператор должен работать под собственной учетной записью, чтобы аудит и авторство комментариев не сливались.
Не подходит, если
- В организации нельзя регистрировать публичный OAuth-клиент в Admin Center.
- Тикеты содержат данные, которые нельзя передавать внешней модели.
- Агенту достаточно читать статьи Help Center без доступа к тикетам.
Пример запроса к агенту
Покажи последние тикеты со статусом open, прочитай комментарии к тикету 4812 и подготовь черновик ответа без отправки.MCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
ZENDESK_SUBDOMAINобязательная- Поддомен Zendesk, например acme для https://acme.zendesk.com.
ZENDESK_CLIENT_IDобязательная- Идентификатор публичного OAuth-клиента из Admin Center.
ZENDESK_OAUTH_REDIRECT_URI- Адрес обратного вызова, по умолчанию http://localhost:4567/callback.
ZENDESK_OAUTH_SCOPES- Список scopes, ограничивает права токена.
ZENDESK_TOKEN_FILE- Путь к файлу токенов вместо стандартного.
ZENDESK_API_KEYсекрет- Устаревший вход по API-токену вместе с ZENDESK_EMAIL.
Ограничения
Нужен аккаунт Zendesk с правом создать публичный OAuth-клиент в Admin Center (Redirect URL `http://localhost:4567/callback`) и разовая авторизация командой `uv run zendesk-auth` на машине оператора. Вход по API-токену еще работает, но объявлен устаревшим: с 27 октября 2026 года новые токены создавать нельзя, а все токены перестанут работать 30 апреля 2027 года. В Docker авторизацию выполняют на хосте, а каталог с токенами монтируют с правом записи, иначе после ротации refresh-токена сервер остановится на просроченном. Инструменты создания и изменения тикетов пишут в живую очередь поддержки; для чтения хватает scopes `tickets:read users:read hc:read`. Тексты тикетов клиентов уходят провайдеру модели.
Как отключить. Уберите запись `zendesk` из MCP-конфигурации клиента, удалите `~/.config/zendesk-mcp/tokens.json` и отзовите OAuth-клиент в Admin Center.
Частые вопросы
Как авторизовать Zendesk MCP Server?
Создайте публичный OAuth-клиент в Admin Center, задайте `ZENDESK_SUBDOMAIN` и `ZENDESK_CLIENT_ID` в `.env` и выполните `uv run zendesk-auth`. Браузер откроет страницу согласия, токены сохранятся локально.
Какие инструменты есть у сервера?
`get_tickets`, `get_ticket`, `get_ticket_comments`, `create_ticket_comment`, `create_ticket`, `update_ticket` и `get_ticket_attachment`. Статьи Help Center отдает ресурс `zendesk://knowledge-base`.
Можно ли дать только чтение?
Да. Задайте `ZENDESK_OAUTH_SCOPES` со значением `tickets:read users:read hc:read`: токен тогда не сможет создавать и менять тикеты.
Работает ли вход по API-токену?
Пока да, но он устарел. С 27 октября 2026 года новые токены создавать нельзя, а 30 апреля 2027 года все токены перестанут работать.
Как запустить сервер в Docker?
Соберите образ командой `docker build -t zendesk-mcp-server .`, авторизуйтесь на хосте через `uv run zendesk-auth` и запустите контейнер с `--env-file` и смонтированным каталогом токенов.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыНабор MCP-серверов для Wildberries, Ozon, Яндекс Маркета, Битрикс24, amoCRM, Авито, Директа, Метрики, Вебмастера и DaData, локально бесплатно
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма
MCP-сервер для Odoo: агент читает, создает и обновляет записи ERP, ищет данные и вызывает бизнес-операции через права Odoo
Официальный MCP-сервер Chatway: агент разбирает диалоги живого чата, отвечает клиентам, назначает операторов и ищет по базе знаний
MCP-сервер Битрикс24: задачи, CRM и списки
Bitrix24 Tasks, CRM & Lists MCP Server
Модульный MCP-сервер Битрикс24 на 46 инструментов: задачи и канбан, CRM-сделки и контакты, универсальные списки, работает в Docker без стороннего кеша
Churnkey MCP — удержание подписчиков
Churnkey MCP
MCP-сервер Churnkey: агент читает данные об отменах подписок, правит сценарии удержания и ведет A/B-тесты
Коротко о README
Описаны сборка и запуск через `uv` и Docker, регистрация OAuth-клиента, ротация токенов, выбор scopes, миграция с API-токенов и перечень инструментов с аргументами.