Сервер Model Context Protocol для Zendesk.

Этот сервер обеспечивает комплексную интеграцию с Zendesk. Он предлагает:

• Инструменты для поиска и управления тикетами и комментариями Zendesk
• Специализированные запросы для анализа заявок и составления ответов
• Полный доступ к статьям Центра поддержки Zendesk как к базе знаний

Подготовка

• билд: uv venv && uv pip install -e . или uv build в кратком смысле.
• настроить аутентификацию: см. раздел аутентификация ниже.
• настраивать на рабочем столе Claude:

Аутентификация

Этот сервер аутентифицируется с помощью OAuth. Каждый оператор авторизирует свой собственный Вход в Zendesk, поэтому API-вызовы несут свою идентичность, и Zendesk применяет именно разрешения, которые он применяется в пользовательском интерфейсе — их роль, ограничения группы, их Доступ к билетам. Комментарии, которые они оставляют, написаны ими.

Аутентификация токенов API всё ещё работает, но устарела. См. Миграция с токена API.

1. Зарегистрируйте публичный клиент OAuth

В Административном центре перейдите в раздел Приложения и интеграции > API > OAuth clients и Создайте клиента:

Zendesk MCP Server

A Model Context Protocol server for Zendesk.

This server provides a comprehensive integration with Zendesk. It offers:

• Tools for retrieving and managing Zendesk tickets and comments
• Specialized prompts for ticket analysis and response drafting
• Full access to the Zendesk Help Center articles as knowledge base

Setup

• build: uv venv && uv pip install -e . or uv build in short.
• configure authentication: see Authentication below.
• configure in Claude desktop:

{
  "mcpServers": {
      "zendesk": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/zendesk-mcp-server",
              "run",
              "zendesk"
          ]
      }
  }
}

Authentication

This server authenticates with OAuth. Each operator authorizes with their own Zendesk login, so API calls carry their identity and Zendesk applies exactly the permissions it applies in the UI — their role, their group restrictions, their ticket access. Comments they post are authored by them.

API token authentication still works but is deprecated. See Migrating from an API token.

1. Register a public OAuth client

In Admin Center, go to Apps and integrations > APIs > OAuth clients and create a client:

Setting Allowed scopes is optional but recommended: it caps what any token from this client can ever request, even if the code changes.

Note the client’s Identifier — that is the ZENDESK_CLIENT_ID below.

If Zendesk rejects http://localhost:4567/callback, register https://localhost instead and use zendesk-auth --manual in step 3.

2. Configure the environment

Copy .env.example to .env and set:

ZENDESK_SUBDOMAIN=acme        # for https://acme.zendesk.com
ZENDESK_CLIENT_ID=your-client-identifier

Keep .env out of version control.

Two optional settings, both of which must agree with the OAuth client: