The `zd-mcp-server` package provides a Model Context Protocol (MCP) server designed to integrate AI assistants, such as Claude or Cursor, with Zendesk Support. It enables conversational AI to interact with Zendesk tickets, facilitating operations like creating, reading, updating, and searching tickets, adding public comments or private internal notes, and managing ticket tags. The current stable version is 0.5.0, indicating a pre-1.0 development stage, likely with an agile release cadence focused on feature development and stability improvements. Its key differentiator is providing a standardized MCP interface to Zendesk, abstracting the Zendesk API complexities for AI agents, and simplifying setup for popular AI clients. It leverages Zendesk API tokens for secure access.
npm install zd-mcp-serverVerified import paths — ran on the pinned version, not inferred.
Demonstrates how to quickly set up and run the `zd-mcp-server` using `npx`, including essential environment variable configuration and an example of client-side integration JSON.
Always refer to the latest README and release notes when upgrading to new minor versions for potential migration guides or necessary adjustments.
Use a secure secrets management solution (e.g., environment variables, a vault service) for production deployments. Always follow the principle of least privilege for API tokens.
Ensure your environment uses Node.js v18.0.0 or newer. Use a version manager like `nvm` (Node Version Manager) to easily switch or install required Node.js versions.
Install the package globally with `npm install -g zd-mcp-server`, or use `npx -y zd-mcp-server` to run it without a global installation. Verify that Node.js and npm/npx are correctly installed and configured in your PATH.
Double-check your `export` commands or client configuration for typos. Ensure the Zendesk API token is active and associated with the correct email and subdomain. Verify the token has the necessary permissions to access Zendesk tickets.
Identify and stop the process using the conflicting port (e.g., `lsof -i :<port_number>`). If `zd-mcp-server` supports a port configuration (not explicitly mentioned but common for servers), configure it to use an alternative available port.
No dependency data recorded yet.