zendesk-mcp — MCP-сервер для Claude Code: тикеты Zendesk
Подключает Zendesk к агенту: поиск и чтение тикетов, ответы, заметки, теги, макросы и учёт времени прямо из чата.
claude mcp add zendesk-mcp -- uvx zendesk-mcpЧто делает zendesk-mcp
Сервер отдаёт агенту инструменты Zendesk: искать и листать тикеты, читать комментарии и вложения, создавать тикеты и менять их поля, публиковать ответы и внутренние заметки, назначать исполнителей, применять views и макросы, смотреть пользователей, группы и организации. Есть два MCP-промпта — analyze-ticket и draft-ticket-response. Тикет можно выгрузить в черновик issue на Markdown для GitLab, GitHub или Jira.
Нужен Python 3.10 или новее и OAuth-клиент Zendesk: админ создаёт его в разделе API, redirect URL — http://localhost:8787/callback, скоупы read write. Дальше интерактивная настройка .venv/bin/python -m zendesk_mcp setup спрашивает субдомен, client ID и секрет, открывает браузер и кладёт токен в ~/.config/zendesk-mcp/config.json с правами 0600. Если браузера нет, ссылку печатают в терминал — открыть её можно на любом устройстве и вставить redirect URL обратно. Токен обновляется сам, но при истечении refresh-токена или отзыве доступа придётся прогнать setup заново.
При регистрации в Claude указывайте абсолютный путь к python из venv: сервер стартует в новой оболочке и активированное окружение не наследует, поэтому голый python не найдёт zendesk_mcp. Инструменты записи по умолчанию не в allow-list, и агент будет спрашивать разрешение на каждый вызов. Для деплоя, где текст тикета пишут клиенты, есть read_only и disabled_tools: отключённый инструмент вообще не регистрируется, и модель его не видит.
Какие задачи решает
- найти тикет по запросу и вытащить переписку с вложениями
- ответить клиенту и оставить внутреннюю заметку по тикету
- сменить статус и назначить тикет на агента
- применить макрос и проставить теги пачкой
- выгрузить тикет в черновик issue для GitLab или Jira
Примеры запросов агенту
- Найди в Zendesk тикеты со словом «оплата» за последнюю неделю и покажи статусы
- Прочитай тикет 4821, разберись в проблеме и предложи черновик ответа клиенту
- Поставь тикету 4821 статус open и назначь его на группу поддержки
Как установить zendesk-mcp
Командой платформы
claude mcp add zendesk-mcp -- uvx zendesk-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from zendesk-mcp <команда>
Командой платформы
codex mcp add zendesk-mcp -- uvx zendesk-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from zendesk-mcp <команда>
Файл настроек
{
"mcpServers": {
"zendesk-mcp": {
"command": "uvx",
"args": [
"zendesk-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from zendesk-mcp <команда>
Файл настроек
{
"servers": {
"zendesk-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"zendesk-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from zendesk-mcp <команда>
Командой платформы
gemini mcp add zendesk-mcp uvx zendesk-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from zendesk-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о zendesk-mcp
Как установить zendesk-mcp в Claude Code?
Выполните claude mcp add zendesk-mcp -- uvx zendesk-mcp, затем прогоните настройку OAuth командой .venv/bin/python -m zendesk_mcp setup.
Что делает zendesk-mcp?
Даёт агенту доступ к тикетам Zendesk: поиск и чтение, ответы, заметки, статусы, назначение, макросы, теги и учёт времени. Отдельно умеет собирать черновик issue для трекера.
Можно ли запретить агенту писать в тикеты?
Да. Поставьте "read_only": true в ~/.config/zendesk-mcp/config.json или ZENDESK_MCP_READ_ONLY=true в окружении сервера — инструменты записи не будут зарегистрированы.
