Zendesk

Zendesk MCP Server exposes Zendesk ticket data to an AI Agent, enabling actionable insights for customer support. It provides search, details, and trend analyses so you can quickly surface relevant tickets, agents, and service patterns.

How to use

You connect your MCP client to the Zendesk MCP Server using either the HTTP endpoint or a local process that runs the server as a child process. Use the HTTP endpoint when you run the server separately and want to access it over the network. Use the local process (stdio mode) when you prefer to start the server inside your workflow without exposing a network port.

How to install

Prerequisites you need before starting:

• Docker installed on your machine.
• A Zendesk account with an API token.

# Start the Zendesk MCP server with Docker
docker run -d \
  --name zendesk-mcp \
  -p 8000:8000 \
  -e ZENDESK_SUBDOMAIN=your-subdomain \
  -e ZENDESK_EMAIL=your-email@example.com \
  -e ZENDESK_API_TOKEN=your-api-token \
  public.ecr.aws/saltware/zendesk-mcp:latest

Additional configuration and how to connect

Environment variables you can configure when running the server with Docker:

ZENDESK_SUBDOMAIN: your Zendesk subdomain (required) ZENDESK_EMAIL: API user email (required) ZENDESK_API_TOKEN: API token (required) MCP_TRANSPORT: transport mode, http or stdio (optional) MCP_HOST: server host (default: 0.0.0.0, optional) MCP_PORT: server port (default: 8000, optional)

Connecting from a client

Two common connection methods are supported. Pick the one that matches how you run the server.

Using a client in HTTP mode

If you start the server in HTTP mode on port 8000, point your MCP client at the HTTP URL.

Using a client in stdio mode

If you prefer a local process, you can run the server as a stdio process using Docker. This is convenient when you want to keep the server inside your tooling without network exposure.

Example client connection (stdio via Docker)

{
  "mcpServers": {
    "zendesk": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ZENDESK_SUBDOMAIN=your-subdomain",
        "-e", "ZENDESK_EMAIL=your-email@example.com",
        "-e", "ZENDESK_API_TOKEN=your-api-token",
        "public.ecr.aws/saltware/zendesk-mcp:latest"
      ]
    }
  }
}

Available tools

search_tickets_by_tag

서비스 분류 태그 기반으로 티켓을 검색하고 고객사별로 집계합니다.

search_tickets_with_keywords

키워드 기반으로 티켓을 검색하고 고객사별로 집계합니다. 태그 없는 과거 티켓 검색에 유용합니다.

search_tickets

자유 검색어로 티켓을 검색합니다.

get_ticket_details

특정 티켓의 상세 정보를 조회합니다.

get_top_agents

기간 내 가장 많은 티켓을 해결한 담당자를 조회합니다.

get_service_trends

서비스별 문의 빈도를 분석합니다.