koundinya_zd-mcp-server
If you are the rightful owner of koundinya_zd-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This guide provides instructions for setting up a Model Context Protocol (MCP) server for integrating with Zendesk, including repository setup, building the project, and using it with the Claude Desktop App.
Zendesk MCP Integration Setup Guide
Repository Setup
-
Clone the repository:
git clone https://your-repo-url/mcp-experiments.git cd mcp-experiments/zd-mcp-server -
Install dependencies:
npm install -
Configure environment variables in your development environment:
export ZENDESK_EMAIL="your-email@example.com" export ZENDESK_TOKEN="your-zendesk-api-token" export ZENDESK_SUBDOMAIN="your-zendesk-subdomain"
Building the Project
-
Build the TypeScript project:
npm run buildThis will compile the TypeScript files into JavaScript in the
distdirectory. -
For development, you can use:
npm run dev
Installing with Claude Desktop App
-
Update the Claude Desktop configuration file (
claude_desktop_config.json):{ "tools": { "zendesk": { "command": "node", "env": { "ZENDESK_EMAIL": "internal@z3nmail.com", "ZENDESK_TOKEN": "your-zendesk-api-token", "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain" }, "args": [ "/path/to/mcp-experiments/zd-mcp-server/dist/index.js" ] } } } -
Replace the environment variables with your actual Zendesk credentials.
-
Update the path to match the location of your built index.js file.
-
Restart the Claude Desktop application for the changes to take effect.
Available Zendesk Tools
The MCP Zendesk integration provides the following functions:
zendesk_get_ticket- Retrieves a ticket by IDzendesk_get_ticket_details- Gets ticket details including commentszendesk_search- Searches tickets with Zendesk query syntaxzendesk_create_ticket- Creates a new ticketzendesk_update_ticket- Updates ticket propertieszendesk_add_private_note- Adds an internal note to a ticketzendesk_add_public_note- Adds a public comment to a ticketzendesk_get_linked_incidents- Retrieves all incident tickets linked to a particular ticket
Authentication Setup
-
Generate an API token in your Zendesk Admin Center:
- Go to Admin Center > Apps and Integrations > APIs > Zendesk API
- Add an API token and copy it
-
Use your email address and the API token in your MCP configuration
Troubleshooting
- If you encounter authorization errors, verify your API token is valid
- Ensure your Zendesk subdomain is correct
- Check that the environment variables are properly set
- Restart the MCP server after making changes
