zendesk-help-center

This MCP server provides a Zendesk Help Center integration for MCP clients. It exposes two tools: searchArticles, which lets you search Zendesk Help Center articles by keyword with optional locale and pagination, and getArticle, which retrieves the details of a specific article by its ID. The server is designed to work with Claude Desktop and other MCP-compliant clients, allowing you to perform Zendesk searches and fetch article content without leaving your MCP environment. To use, deploy the MCP server (via npx as shown in the installation instructions) and connect it in your MCP client’s mcpServers configuration. The client will then present the available tools and their parameters, enabling seamless querying of your Zendesk Help Center data.

Prerequisites:

• Node.js v18 or higher
• Access to a Zendesk Help Center with API token
• Internet connection to fetch the MCP server via npx

Installation steps:

1. Clone is not required when using npx, but if you prefer a local copy, clone the repository:

# Optional if you want a local copy
git clone https://github.com/yourusername/zendesk-help-center-mcp-server.git
cd zendesk-help-center-mcp-server

2. Install dependencies (alternative to using npx):

npm install

3. Create a .env file in the project root with your Zendesk credentials (or supply via environment):

ZENDESK_SUBDOMAIN=your-subdomain
ZENDESK_EMAIL=your-email@example.com
ZENDESK_API_TOKEN=your-api-token

4. Build the project (if applicable) and start the server:

npm run build
npm start

Note: The recommended approach for MCP integration shown in the README is to run the server via npx, which avoids local installation and keeps the server up-to-date with the GitHub source:

npx -y github:hidechae/zendesk-help-center-mcp-server

Ensure your environment variables are set when using npx, for example by exporting them in your shell or including them in Claude’s configuration.

Tips and common issues:

• Ensure your Zendesk Subdomain, Email, and API Token are correct and have the necessary API permissions.
• If you encounter authentication errors, regenerate your Zendesk API token and update the environment variables.
• When using Claude Desktop, keep the mcpServers configuration in sync with the server’s capabilities (searchArticles and getArticle).
• The server runs on standard input/output to be compatible with MCP clients; ensure your client captures and forwards IO streams correctly.
• If you modify environment-related behavior, consider using a .env file or export VAR=value in the shell before launching via npx.
• For large article searches, respect Zendesk rate limits and implement locale handling via the locale parameter supported by searchArticles.